リージョンはページ上の領域で、コンテンツのコンテナとして機能します。各ページには任意の数のリージョンを配置できます。特定のリージョン・テンプレートによってリージョンの外観を制御できます。リージョン・テンプレートでは、リージョンの外観およびサイズの制御、枠線または背景色を使用するかどうかの指定、表示するフォントの決定を行います。また、リージョン位置に配置されるボタンの標準配置も制御します。
リージョンを使用して、ページ・コントロール(アイテムやボタンなど)をグループ化できます。追加のHTMLを生成しない単純なリージョンを作成したり、HTML表やイメージ内でコンテンツを形成する詳細なリージョンを作成できます。
リージョンはページ・テンプレート・ボディに順次表示されるか、またはリージョン位置に明示的に配置できます。ページ構造を定義するには、HTML表または今日より一般的なDIV
タグを使用します。
内容は次のとおりです。
「リージョンの作成」ウィザードを実行して、リージョンを作成します。
リージョンを作成するには、次のようにします。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの作成ウィザードにアクセスします。
「コンポーネント」ビュー: 「リージョン」の下の「作成」アイコンをクリックします。
「ツリー」ビュー:「リージョン」を右クリックし、「作成」アイコンを選択します。
リージョン・タイプを選択します。詳細は、「リージョン・タイプについて」を参照してください。
表示属性を指定します。
「コンポーネント」ビュー: 「リージョン」の下の「作成」アイコンをクリックします。
「ツリー」ビュー:「リージョン」を右クリックし、「作成」アイコンを選択します。
画面に表示されるステップに従います。
サブリージョンを使用すると、2つのリージョン間に親/子関係を作成できます。サブリージョンは親リージョン内に表示されます。親リージョンは、リージョンを新規作成するとき、またはリージョン属性を編集するときに指定できます。詳細は、「リージョンの作成」および「リージョンの編集」を参照してください。
この機能は、様々な方法で使用できます。ユースケースの1つは、サブリージョンを使用した情報のグループ化です。たとえば、枠線があるリージョンがあるとします。この機能を使用すると、このリージョン内に2つのクラシック・レポート(サブリージョン)を表示できます。また、サブリージョンを使用して、リージョンをタブまたはアコーディオンとして表示できます。親リージョンとサブリージョンの表示方法を制御するには、リージョン・テンプレートの「サブリージョン」属性を編集します。詳細は、「リージョン・テンプレート」を参照してください。
リージョンの作成時には、リージョン・タイプを選択します。Application Expressエンジンは、選択したタイプに応じてリージョンを解釈します。表 11-1に、使用可能なリージョン・タイプを示します。
表11-1 リージョン・タイプ
リージョン・タイプ | 説明 |
---|---|
HTMLを選択すると、次のいずれかを選択するプロンプトが表示されます。
参照: 「ショートカットの使用」 |
|
複数のHTMLリージョンを一度に作成するには、このオプションを使用します。表示されるフィールドで、各リージョンの順序、タイトル、表示ポイント、レポート・テンプレートおよび列を指定します。 |
|
レポート・リージョンは、SQL問合せを記述するか、またはウィザードを使用して問合せの記述に必要なステップを実行することによって定義できます。 参照: レポートの作成 |
|
フォーム・リージョンは、フォームを含めるために使用されます。 参照: フォームの作成 |
|
チャート・リージョンには、SQL問合せに基づく線グラフ、棒グラフまたは円グラフが含まれます。 参照: 「チャートの作成」 |
|
リスト・リージョンには、リストと呼ばれるリンクの共有コレクションが含まれます。 参照: 「リストの作成」 |
|
ブレッドクラム・リージョンには、ブレッドクラムと呼ばれるリンクの階層的なリストが含まれます。 参照: 「ブレッドクラムの作成」 |
|
PL/SQLに基づくリージョンでは、PL/SQL Webツールキットを使用してHTMLまたはテキストをレンダリングできます。 |
|
ツリーは、実行時に実行されるSQL問合せに基づく、階層的なナビゲーション・コントロールです。ユーザーは、これを使用してノードを展開および縮小できます。 |
|
URLに基づくリージョンでは、事前定義されたURLを使用してWebサーバーをコールすることによって、コンテンツが取得されます。 |
|
カレンダ・リージョンは、カレンダを含めるために使用されます。 参照: カレンダの作成 |
|
プラグイン |
開発者はプラグインを使用して、Application Expressで使用可能な組込みタイプを宣言的に拡張できます。 参照: 「プラグインの実装」 |
ヘルプ・テキスト・リージョンでは、ページ・レベルのヘルプを指定できます。 参照: 「ヘルプ・ページの作成」 |
|
マップ |
「マップ」リージョンには、宣言的に定義されたFlashマップが表示されます。 参照: 「マップの作成」 |
リージョン表示セレクタ |
「リージョン表示セレクタ」リージョンでは、リージョン表示選択が有効化されている、ページの各リージョンに表示と非表示のコントロールを表示できます。 参照: 「リージョン表示セレクタの作成」 |
関連項目:
|
リージョンとは、コンテンツのコンテナとしての役割を持つページ領域のことです。ページの外観を変更するには、リージョン属性を編集します。
内容は次のとおりです。
リージョン属性を編集するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。
リージョンの編集ページが表示されます。
対象となる属性を編集します。
ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用できる場合、アイテム・ラベルの上にカーソルを置くとアイテム・ラベルは赤に変わり、カーソルは矢印とクエスチョン・マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。
「変更の適用」をクリックします。
リージョン属性はページの外観を制御します。表11-2に、ページのレイアウトに影響を与えるリージョン属性を示します。
表 11-2 ページ・レイアウトに影響を与えるリージョン属性
属性 | 説明 |
---|---|
リージョンの外観を決定します。アプリケーションで定義されたリージョン・テンプレートから選択します。テンプレート属性を表示するには、ページ定義でテンプレート名をクリックします。 |
|
ページ内のリージョンの表示順を指定します。 |
|
現在のリージョンが属している親リージョンを定義します。 |
|
ページ内でリージョンを表示する位置を指定します。リージョンは、「表示ポイント」の順序番号順にレンダリングされます。ページ・レイアウトを表示するには、「ビュー」アイコンをクリックして、位置を選択します。 選択可能な表示ポイントは、ページ・レベル・テンプレート(ページ属性)によって決定されます。ページ・レベル・テンプレートを選択しなかった場合は、「アプリケーションの定義」で定義されたデフォルトのページ・レベル・テンプレートが使用されます。 |
|
リージョンを表示する列を決定します。同じ表示ポイントに2つのリージョンがある場合は、2番目のリージョンを列2に表示するように設定することによって、2つのリージョンを並べて配置できます。多数のリージョンはそれぞれの列に表示でき、リージョン表示ポイントおよび列内でのリージョンの表示順は、リージョン表示順序番号によって制御されます。 |
|
このリージョンをリージョン表示セレクタに含めるよう指定します。リージョン表示セレクタは、この属性を使用して指定されたリージョンのみを表示します。 |
|
移入されている場合、指定されたイメージがリージョンの左上に表示されます。このイメージの表示に使用される表タグを制御することはできません。 参照: 「リージョン・イメージの追加」 |
|
「リージョン・イメージ」属性とともに使用します。イメージhtmlに含める属性を入力します。たとえば、高さと幅にこの属性を使用します。 参照: 「リージョン・イメージの追加」 |
|
リージョンが複数の列に表示される場合にHTML表セルで使用される追加の属性を定義します。この属性は、複数の列でのリージョンの配置に使用される表のセルを制御します。 |
|
リージョンの最上部( |
|
リージョンを表示するかどうかを決定する条件および適切な式を定義します。条件では、セッション・ステート、現在ログインしているユーザーまたは環境設定(ページが印刷用ビュー・モードかどうかなど)を参照できます。 |
|
エンド・ユーザーによるカスタマイズを可能にします。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに |
リージョンのボディ・コンテンツ(レポート、チャートまたはフォーム要素付きのHTML)に加えて、追加の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
「カスタマイズ」属性を使用すると、リージョンの表示属性をユーザーがカスタマイズできるかどうかを制御できます。
エンド・ユーザーは次の手順でカスタマイズできます。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。
リージョンの編集ページが表示されます。
「カスタマイズ」までスクロールして、次のいずれかを選択します。
デフォルトでカスタマイズ可能および非表示
デフォルトでカスタマイズ可能および表示
「カスタマイズ・オプション名」に、ページのこのリージョンをユーザーに示すラベルを入力します。
ページ・テンプレートの「ヘッダー」、「ボディ」または「フッター」セクションに#CUSTOMIZE#
置換文字列を含めます。
この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに#CUSTOMIZE#
置換文字列を含める必要があります。
エンド・ユーザーによるカスタマイズが1つ以上のリージョンでサポートされる場合、「カスタマイズ」というリンクがページ・テンプレートで#CUSTOMIZE#
置換文字列を含めた場所に表示されます。このリンクをクリックするとウィンドウが表示され、ユーザーは、ページのリージョンのオン/オフを切り替えることができるようになります。
リージョン・キャッシュの有効化は、静的HTMLを含む条件またはリージョンが使用されていないリストが含まれるリージョンなどの静的リージョンのパフォーマンスの向上に効果的な方法です。
リージョン・キャッシュを有効化すると、Application Expressエンジンによって、リージョンを動的にレンダリングするかわりにキャッシュされた(または格納された)リポジトリからリージョンをレンダリングします。実際のセッション識別子はキャッシュされないことに注意してください。かわりに、Application Expressエンジンでは、&SESSION.
置換文字列がキャッシュされ、キャッシュされたリージョンをレンダリングしたカレント・セッションが表示時に代入されます。たとえば、リージョンにリンクが含まれ、リンクにセッションが含まれる場合、リンクがすべてのセッションで動作するようにするため、完全なセッションはキャッシュされません。
Application Expressエンジンは、リージョンが定義した条件を満たす場合にのみキャッシュからレンダリングします。また、リージョンは、ユーザーまたはキャッシュされた独立したユーザーに対してのみキャッシュできます。
リージョン・キャッシュを有効化するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。
リージョンの編集ページが表示されます。
「キャッシュ」までスクロールします。
「キャッシュ」で次のいずれかを選択します。
キャッシュ済: ユーザーとは関係なくリージョンをキャッシュします。
ユーザー別のキャッシュ: 指定されたユーザーに固有のリージョンをキャッシュします。
未キャッシュ: この機能を無効にします。
「キャッシュ済」または「ユーザー別のキャッシュ」を選択する場合は、次を指定します。
次の後にキャッシュをタイムアウト: キャッシュされたリージョンが有効な期間を指定します。
キャッシュ条件タイプ: リストから条件タイプを選択します。条件がFalseを戻す場合、リージョンは動的にレンダリングされ、キャッシュされません。条件がTrueを戻す場合、リージョンはキャッシュされます。
式1および式2: 選択した特定の条件タイプに基づいて値を入力します。
「変更の適用」をクリックします。
アプリケーションのパフォーマンスを改善するための方法の1つは、リージョンのキャッシュを使用することです。開発者はリージョンの編集ページで「キャッシュ」属性を設定することにより、リージョンのキャッシュを構成できます。詳細は、「リージョン・キャッシュの使用」を参照してください。
キャッシュされたリージョンはキャッシュされたリージョン・ページで管理できます。
キャッシュされたリージョン・ページにアクセスするには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
アプリケーションを選択します。
「ユーティリティ」ボタンをクリックし、「キャッシュ」を選択します。
「キャッシュされたリージョン」で「管理」をクリックします。
キャッシュされたリージョン・ページが表示されます。
ページ上部の検索バーを使用してページの概観をカスタマイズできます。詳細は、「対話モード・レポートのカスタマイズ」を参照してください。
消去するリージョンを選択して、次のいずれかをクリックします。
期限切れの消去
チェックした項目の消去
キャッシュされたリージョンをすべて消去するには、「すべて消去」をクリックします。
関連項目: Oracle Application Express管理ガイドの「キャッシュされたリージョンの管理」 |
カスタムJavaScriptまたはカスケード・スタイルシートの作成時に静的リージョンIDを指定すると有効です。リージョンの編集ページの「静的ID」属性を使用して、リージョンを一意に識別できます。リージョン・テンプレート、ヘッダー、フッターまたはボディの#REGION_STATIC_ID#
置換文字列を使用してリージョンを参照できます。
静的リージョンIDを含めるには、HTML要素IDとしてリージョン・コンテナ・オブジェクト(表またはDIV)に割り当てます。HTML要素のIDはページ全体で一意である必要があります。たとえば、ページHTMLを有効にしておくため、ボタンとリージョンのIDを同じにすることはできません。
静的リージョンIDを指定するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。
リージョンの編集ページが表示されます。
「属性」までスクロールします。
「静的ID」に、このリージョンを識別する値を入力します。この値を参照するには、置換文字列#REGION_STATIC_ID#
を使用します。
「変更の適用」をクリックします。
「リージョン・イメージ」および「イメージ・タグ属性」を使用すると、リージョンの左上にイメージを追加できます。
リージョン・イメージを追加するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。
リージョンの編集ページが表示されます。
「属性」までスクロールします。
「属性」で次を指定します。
リージョン・イメージ: リージョンの左上に表示するイメージを指定します。このイメージの表示に使用されている表タグ。
イメージ・タグ属性: イメージhtmlに含める属性を入力します。入力した属性を使用して、高さと幅を指定します。
「変更の適用」をクリックします。
アプリケーション・ビルダーには、複数のリージョンを一度に編集する方法が数多くあります。
内容は次のとおりです。
リージョン・ページを使用すると、順序、列、リージョン名、表示ポイントなど、ページのすべてのリージョンのリージョン属性を更新できます。
すべてのリージョンにわたる複数の属性を編集するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
コンポーネント・ビュー: 「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
「ツリー」ビュー: 「リージョン」を右クリックし、「すべて編集」を選択します。
リージョン・ページが表示されます。
適切な属性を編集して、クリックします。
「変更の適用」をクリックします。
ユーティリティ・ページを使用すると、選択したアプリケーション内の全ページに対するグリッド編集ページとレポートにアクセスできます。
リージョン・ユーティリティ・ページにアクセスするには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョン・ページにアクセスします。
コンポーネント・ビュー: 「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
「ツリー」ビュー: 「リージョン」を右クリックし、「すべて編集」を選択します。
リージョン・ページが表示されます。
適切な属性を編集して、クリックします。
「変更の適用」をクリックします。
ドラッグ・アンド・ドロップ・レイアウト・ページでは、リージョンの表示順序の迅速な変更、リージョン・タイトルの編集、リージョン・テンプレートの変更を行うことができます。
ドラッグ・アンド・ドロップ・レイアウト・ページにアクセスするには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
「コンポーネント」ビュー: 「リージョン」で「リージョンの順序変更」アイコンをクリックします。「リージョンの順序変更」アイコンは、黄緑色の上向き矢印および下向き矢印の形をしています。
「ツリー」ビュー: リージョンを右クリックし、「ドラッグ・アンド・ドロップ・レイアウト」を選択します。
リージョンの順序変更ページが表示されます。このページを使用して、リージョン・タイトルの編集やテンプレートの選択を行います。
「リージョン」でタイトルを入力します。
「テンプレート」からテンプレートを選択します。
リージョンの表示順序を変更するには、右端の列で上矢印および下矢印をクリックします。
「変更の適用」をクリックします。
「リージョン表示セレクタ」リージョンでは、ページの各リージョンに表示と非表示のコントロールを表示できます。
リージョン表示セレクタを作成するには、次のステップを実行します。
リージョン・ページ・セレクタに含めるページおよびリージョンを作成します。
セレクタに含める各リージョンの「リージョン表示セレクタ」属性を編集します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。
リージョンの編集ページが表示されます。
「属性」で、「リージョン表示セレクタ」を「はい」に変更します。
「変更の適用」をクリックします。
タイプがリージョン表示セレクタのリージョンを作成します。
ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの作成ウィザードにアクセスします。
「コンポーネント」ビュー: 「リージョン」の下の「作成」アイコンをクリックします。
「ツリー」ビュー:「リージョン」を右クリックし、「作成」アイコンを選択します。
リージョン・タイプ「リージョン表示セレクタ」を選択します。
「作成」をクリックします。
注意: 「ツリー」タイプのリージョンには複数のリージョンが含まれるため、コピーできません。 |
リージョンをコピーするには、次のステップを実行します。
ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
「コンポーネント」ビュー: 「リージョン」で「コピー」アイコンをクリックします。「コピー」アイコンは、小さいページが2つ重なった形をしています。
「ツリー」ビュー: リージョンを右クリックし、「ドラッグ・アンド・ドロップ・レイアウト」を選択します。
リージョンの順序変更ページが表示されます。このページを使用して、リージョン・タイトルの編集やテンプレートの選択を行います。
「コンポーネント」ビューを使用する場合は、コピーするリージョンを選択します。使用しない場合は、次のステップに進みます。
「コピー先ページ」で次を実行します。
コピー先ページ: リージョンのコピー先のページを選択します。
リージョン・アイテムのコピー: 「はい」または「いいえ」を選択し、このリージョン内のアイテムをコピーするかどうかを決定します。
ボタンのコピー: 「はい」または「いいえ」を選択し、このリージョン内のボタンをコピーするかどうかを決定します。
「次へ」をクリックします。
「リージョンのコピー」をクリックします。
リージョンを削除するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
コンポーネント・ビュー: 「リージョン」で、リージョン名を選択します。
ツリー・ビュー: リージョン名を右クリックし、「編集」を選択します。
リージョンの編集ページが表示されます。
「削除」をクリックします。
一度に複数のリージョンを削除するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョンの編集ページにアクセスします。
コンポーネント・ビュー: 「すべて編集」アイコンをクリックします。「すべて編集」アイコンは、鉛筆が置かれた小さいグリッドの形をしています。
「ツリー」ビュー: 「リージョン」を右クリックし、「すべて編集」を選択します。
リージョン・ページが表示されます。
「複数のリージョンの削除」タブをクリックします。
次の項目を指定します。
ボタンを削除するカスケード: 「はい」を選択すると、対応するリージョンのボタンが削除されます。
アイテムを削除するカスケード: 「はい」を選択すると、対応するリージョンのアイテムが削除されます。
関連付けられたリストおよびリスト・エントリを削除しますか。: 「はい」を選択すると対応するリストが削除されます。このオプションは、削除されるリージョンがこのリストを参照する唯一のリージョンである場合にのみ表示されます。
動的アクションを削除するカスケード: 「はい」を選択すると、対応するリージョンのアイテムが削除されます。
削除するリストを選択します。
「変更の適用」をクリックします。