12.5 ページ・デザイナでのリージョンの管理

リージョンはコンテンツのコンテナとして機能します。Oracle Application Expressアプリケーションの各ページに、1つ以上のリージョンが含まれます。

トピック:

関連項目:

12.5.1 ページ・デザイナでのリージョンの作成

ヒント:

ページ・デザイナ・ツールバーから、フォーム・リージョンを作成することも、ブレッドクラム・リージョンを作成することもできます。ページ・デザイナ・ツールバーで、「作成」メニューをクリックして「フォーム・リージョン」または「ブレッドクラム・リージョン」を選択します。

ページ・デザイナでリージョンを作成するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
中央ペインの下部にあるギャラリで、作成するリージョン・タイプを探します。コントロールまたはコンポーネントにカーソルをあわせると、それについて説明するツールチップが表示されます。
ヒント:
ギャラリからコンポーネントをドラッグ・アンド・ドロップする以外に、ギャラリでコンポーネントを右クリックしてコンテキスト・メニューを表示することもできます。「追加先」を選択して、コンポーネントを追加する位置を選択します。
作成されるリージョン上でマウスをクリックしたまま、「レイアウト」タブの目的の位置にドラッグします。
適切な位置にマウスが配置されると、「レイアウト」タブが暗い黄色の四角形として表示されます。マウスを離して、コンポーネントをドロップします。コンポーネントは、コンポーネント・タイプによって決定される適切なドロップ位置にのみドロップできます。

追加するコンポーネント・タイプに基づいて、ページ・デザイナが次に必要な操作を示します。「メッセージ」タブに、対処する必要があるメッセージの数を示した赤または黄色のバッジが表示されます。
プロパティ・エディタで該当する属性を編集します。
ヒント:
属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。
「保存」または「ページの保存と実行」をクリックします。

関連項目:

「「メッセージ」タブ」

12.5.2 ページ・デザイナでのリージョンの管理

リージョンとは、コンテンツのコンテナとしての役割を持つページ領域のことです。ページの外観を変更するには、リージョン属性を編集します。

トピック:

12.5.2.1 ページ・デザイナでのリージョン属性の編集

リージョン属性を編集するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブで、リージョンを選択します。
プロパティ・エディタの右ペインにリージョン属性が表示されます。

図GUID-08D5C4A0-EF40-40DE-9090-FDF4E02E7803-default.pngの説明

属性は、機能グループに編成されます。これらのグループを展開または縮小するには、「共通の表示」、「すべて表示」、「すべて閉じる」および「すべて開く」アイコンをクリックします。
プロパティ・エディタですべての属性を表示します。左ペイン上部の「すべて表示」アイコンをクリックします。
プロパティ・エディタで該当する属性を編集します。
属性の詳細は、フィールドレベル・ヘルプを参照してください。
変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

ページ・デザイナの右ペイン(プロパティ・エディタ)

12.5.2.2 リージョン位置の制御

リージョンを作成するとき、プロパティ・エディタで「レイアウト」の「位置」属性を編集することにより、その位置を指定できます。ページのユーザー・インタフェースの現在のテーマ内で定義されているテンプレート位置によって、使用可能な選択肢が決まります。

12.5.2.3 リージョンのヘッダーおよびフッターの指定

リージョンのボディ・コンテンツに加えて、プロパティ・エディタで「ヘッダー」および「フッター」属性を編集することにより、追加のHTMLがリージョンの上下に配置されるように指定できます。

すべてのレポート・リージョンで、置換文字列#TIMING#:はリージョンのレンダリングにかかる経過時間(秒)を表示できます。この置換文字列はデバッグに使用できます。

クラシック・レポート・リージョンの場合、リージョン・フッターで次の置換文字列がサポートされています。

#ROWS_FETCHED#: Oracle Application Expressレポート・エンジンによってフェッチされた行数(ページ・サイズ)を表示できます。これらの置換文字列を使用して、カスタマイズされたメッセージをユーザーに表示できます。次に例を示します。
```
Fetched #ROWS_FETCHED# rows in #TIMING# seconds.
```
#TOTAL_ROWS#: レポートに使用されたSQL問合せを満たす行の合計数を表示できます。
#FIRST_ROW_FETCHED# および#LAST_ROW_FETCHED#: 表示される行の範囲を表示できます。次に例を示します。
```
Row(s) #FIRST_ROW_FETCHED# through #LAST_ROW_FETCHED# of #ROWS_FETCHED# displayed
```

12.5.2.4 ユーザーによるページのカスタマイズの可能化

「カスタマイズ」属性を使用すると、リージョンの表示属性をユーザーがカスタマイズできるかどうかを制御できます。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#置換文字列を含める必要があります。

エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」リンクがページ・テンプレートで#CUSTOMIZE#置換文字列を含めた場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンを表示または非表示にできます。

エンド・ユーザーのカスタマイズを有効化するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブまたは「レイアウト」タブで、リージョンを選択します。
プロパティ・エディタに、リージョンの属性が表示されます。
「カスタマイズ」を見つけます。「カスタマイズ」で次のいずれかを選択します。
- エンドユーザーではカスタマイズ不可
- デフォルトでカスタマイズ可能および非表示
- デフォルトでカスタマイズ可能および表示
「保存」をクリックします。

関連項目:

カスタム・テーマの作成

12.5.2.5 ページ・デザイナでのリージョン・キャッシュの使用

リージョン・キャッシュの有効化は、条件を使用しないリストを含むリージョンまたは静的HTMLを含むリージョンなどの静的リージョンのパフォーマンスの向上に効果的な方法です。

ヒント:

リージョン・キャッシュは、対話モード・レポート・リージョンに対しては使用できません。

トピック:

関連項目:

『Oracle Application Express管理ガイド』のページおよびリージョン・キャッシュの管理に関する項

12.5.2.5.1 リージョン・キャッシュについて

リージョン・キャッシュを有効化すると、Application Expressエンジンによって、リージョンを動的にレンダリングするかわりにキャッシュされた(または格納された)リポジトリからリージョンをレンダリングします。実際のセッション識別子はキャッシュされないことに注意してください。かわりに、Application Expressエンジンでは、&SESSION.置換文字列がキャッシュされ、キャッシュされたリージョンをレンダリングしたカレント・セッションが表示時に代入されます。たとえば、リージョンにリンクが含まれ、リンクにセッションが含まれる場合、リンクがすべてのセッションで動作するようにするため、完全なセッションはキャッシュされません。

Application Expressエンジンは、リージョンが定義した条件を満たす場合にのみキャッシュからレンダリングします。また、リージョンは、ユーザーまたはキャッシュされた独立したユーザーに対してのみキャッシュできます。

関連項目:

サーバー・キャッシュ

12.5.2.5.2 ページ・デザイナでのリージョン・キャッシュの有効化

リージョン・キャッシュを有効化するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブまたは「レイアウト」タブで、リージョンを選択します。
プロパティ・エディタにリージョン属性が表示されます。
プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。
「サーバー・キャッシュ」を展開します。「キャッシュ」で、次のいずれかを選択します。
- 無効 - コンテンツはキャッシュされず、リクエストごとに計算されます。
- 有効 - コンテンツはキャッシュされ、すべてのユーザーによって利用されます。
- ユーザー別のキャッシュ - コンテンツはユーザーごとにキャッシュされます。
- セッション別のキャッシュ - コンテンツはセッションごとにキャッシュされます。
「保存」をクリックします。

12.5.2.6 静的リージョンIDの指定

カスタムJavaScriptまたはカスケード・スタイルシートの作成時に静的リージョンIDを指定すると有用です。リージョンの編集ページの「静的ID」属性を使用して、リージョンを一意に識別できます。リージョン・テンプレート、ヘッダー、フッターまたはボディの#REGION_STATIC_ID#置換文字列を使用してリージョンを参照できます。

静的リージョンIDを含めるには、HTML要素IDとしてリージョン・コンテナ・オブジェクト(表またはDIV)に割り当てます。HTML要素のIDはページ全体で一意である必要があります。たとえば、ページHTMLを有効にしておくため、ボタンとリージョンのIDを同じにすることはできません。

静的リージョンIDを指定するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブまたは「レイアウト」タブで、リージョンを選択します。
プロパティ・エディタにリージョン属性が表示されます。
プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。
「詳細」を探します。静的ID属性を編集します。
1. 「詳細」で「静的ID」を見つけます。
2. 「静的ID」に、このリージョンの静的IDを入力します。定義されている場合、これが置換文字列#REGION_STATIC_ID#でリージョンのIDとして使用され、リージョンのカスタムJavaScript動作を開発する際に役立ちます。これが定義されていない場合、リージョンによって内部IDが生成されます。
ヒント:
入力した静的IDをリージョンで使用するには、テンプレートに#REGION_STATIC_ID#置換文字列が含まれている必要があります。
「保存」をクリックします。

12.5.2.7 リージョン・イメージの追加

「リージョン・イメージ」および「イメージ・タグ属性」を使用すると、リージョンの左上にイメージを追加できます。

リージョン・イメージを追加するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブまたは「レイアウト」タブで、リージョンを選択します。
プロパティ・エディタにリージョン属性が表示されます。
「詳細」を探します。次の属性を編集します。
- リージョン・イメージ - リージョンの左上に表示されるイメージへの参照を入力します。このイメージの表示に使用される表タグを制御することはできません。
- イメージ・タグ属性 - イメージHTMLに含めるイメージ・タグ属性を入力します。これは、高さ、幅またはイメージのALTテキスト(装飾的なイメージではない場合)などの属性に使用できます。
  
  イメージ・タグ属性にALTが定義されていない場合、Application Expressはデフォルトで装飾的なイメージとしてイメージをレンダリングします(空のALTタグなど)。
「保存」をクリックします。

12.5.2.8 リージョン表示セレクタの作成

「リージョン表示セレクタ」リージョンでは、ページの各リージョンに表示と非表示のコントロールを表示できます。

リージョン表示セレクタを作成するには、次のステップを実行します。

リージョン・ページ・セレクタに含めるページおよびリージョンを作成します。
セレクタに含める各リージョンで、「リージョン表示セレクタ」属性を「はい」に設定します。
ギャラリで、「リージョン表示セレクタ」リージョンを右クリックして「追加先」を選択し、適切な位置を選択します。
ヒント:
ギャラリからドラッグ・アンド・ドロップすることもできます。ギャラリから、「リージョン表示セレクタ」リージョンを選択して、「レイアウト」タブの適切な位置にドラッグします。
プロパティ・エディタでリージョン属性を編集します。
1. 指定、タイトル - リージョン・タイトルを入力します。リージョン・タイトルは、リージョン・テンプレートに定義されている場合にのみ表示されます。
2. 詳細、リージョン表示セレクタ - このリージョンをリージョン表示セレクタに含める場合、「はい」を選択します。この属性は、リージョン表示セレクタのリージョン・タイプが定義されてページ上に表示できる場合にのみ使用されます。
  ヒント:
  属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。
「保存」をクリックします。

12.5.3 ページ・デザイナでのリージョンのコピー

注意:

「ツリー」タイプのリージョンには複数のリージョンが含まれるため、コピーできません。

リージョンをコピーするには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レイアウト」タブでリージョンを右クリックし、「コピー先」を選択して、サブメニューからコピー先を選択します。

ヒント:

リージョンを別のページにコピーするには、「レンダリング」タブでリージョンを選択し、右クリックして「他のページにコピー」を選択します。画面に表示されるステップに従います。

12.5.4 ページ・デザイナでのリージョンの削除

リージョンを削除するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブで1つ以上のリージョンを選択します。
右クリックして「削除」を選択します。
「保存」をクリックします。