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