前へ
次へ
ホーム > ページ・レイアウトの制御 > リージョンの理解 > リージョン属性の編集
前へ |
次へ |
「リージョン定義」で属性を編集することで、ページの外観を変更できます。
トピック:
リージョン属性を編集するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
「リージョン」で、リージョン名を選択します。
リージョン定義が表示されます。
対象となる属性を編集します。
ページ上の特定のアイテムの詳細を表示するには、アイテム・ラベルをクリックします。
ヘルプが使用できる場合、アイテム・ラベルの上にカーソルを置くとアイテム・ラベルは赤に変わり、カーソルは矢印と疑問符マークに変わります。「フィールドレベル・ヘルプについて」を参照してください。
「変更の適用」をクリックします。
表「ページ・レイアウトに影響を与えるリージョン属性」に、ページ・レイアウトに影響を与えるリージョン属性を示します。
ページ・レイアウトに影響を与えるリージョン属性
| 属性 | 説明 |
|---|---|
|
リージョンの外観を決定します。アプリケーションで定義されたリージョン・テンプレートから選択します。テンプレート属性を表示するには、ページ定義でテンプレート名をクリックします。 |
|
|
ページ内のリージョンの表示順を指定します。 |
|
|
ページ内でリージョンを表示する位置を指定します。リージョンは、「表示ポイント」の順序番号順にレンダリングされます。ページ・レイアウトを表示するには、「ビュー」アイコンをクリックして、位置を選択します。 選択可能な表示ポイントは、ページ・レベル・テンプレート（ページ属性）によって決定されます。ページ・レベル・テンプレートを選択しなかった場合は、「アプリケーションの定義」で定義されたデフォルトのページ・レベル・テンプレートが使用されます。 |
|
|
リージョンが複数の列に表示される場合にHTML表セルで使用される追加の属性を定義します。この属性は、複数の列でのリージョンの配置に使用される表のセルを制御します。 |
|
|
リージョンを表示する列を決定します。同じ表示ポイントに2つのリージョンがある場合は、2番目のリージョンを列2に表示するように設定することによって、2つのリージョンを並べて配置できます。多数のリージョンはそれぞれの列に表示でき、リージョン表示ポイントおよび列内でのリージョンの表示順は、リージョン表示順序番号によって制御されます。 |
|
|
リージョンの最上部（ |
|
|
リージョンを表示するかどうかを決定する条件および適切な式を定義します。条件では、セッション・ステート、現在ログインしているユーザーまたは環境設定（ページが印刷用ビュー・モードかどうかなど）を参照できます。 |
|
|
エンド・ユーザーによるカスタマイズを可能にします。この機能を使用するには、ページ・テンプレートのヘッダー、ボディまたはフッター・セクションに |
リージョンのボディ・コンテンツ（レポート、チャートまたはフォーム要素付きの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: 選択した特定の条件タイプに基づいて値を入力します。
「変更の適用」をクリックします。
カスタムJavaScriptまたはカスケード・スタイルシートの作成時に静的リージョンIDを指定すると有効です。リージョンの編集ページの「静的ID」属性を使用して、リージョンを一意に識別できます。リージョン・テンプレート、ヘッダー、フッターまたはボディの#REGION_STATIC_ID#置換文字列を使用してリージョンを参照できます。
静的リージョンIDを指定するには、次のステップを実行します。
該当するページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
リージョン定義が表示されます。
「指定」で、「静的ID」に値を入力します。
「変更の適用」をクリックします。