| Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド リリース4.2 for Oracle Database 12c B71338-03 |
|
 前 |
 次 |
| Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド リリース4.2 for Oracle Database 12c B71338-03 |
|
前 |
次 |
ページ属性は、ページ名、ならびにページ・タイトルや関連するページ・テンプレート、ヘッダー・テキストおよび選択された認可スキームといった表示属性などのページの詳細な特性を制御します。ページ属性には、ページ定義からアクセスします。
内容は次のとおりです。
ページ属性を編集するには、次のステップを実行します。
ページ定義にナビゲートします。「ページ定義へのアクセス」を参照してください。
編集ページにアクセスするには、次の操作を実行します。
ツリー・ビュー: 「ページ・レンダリング」で、ツリーの上部のページ・タイトルをダブルクリックします。
コンポーネント・ビュー: 「ページ」で、「すべて編集」アイコンをクリックします。
ページ属性ページが表示されます。必須の値には赤いアスタリスク(*)が付いています。
ページ属性ページは、「名前」、「表示属性」、「JavaScript」、「HTMLヘッダー」、「ヘッダーおよびフッター」、「読取り専用」、「セキュリティ」、「重複送信」、「サーバー・キャッシュ」、「構成」、「エラー処理」、「ヘルプ」および「コメント」の各セクションから構成されます。
これらのセクションにはページをスクロール・ダウンするか、ページ上部のナビゲーション・ボタンをクリックすることでアクセスできます。ページ上部のボタンを選択すると、選択されたセクションが表示され、その他のセクションはすべて一時的に非表示になります。ページのすべてのセクションを表示するには、「すべて表示」をクリックします。
この後のトピックで、ページ属性ページ固有のセクションについて説明します。
表8-1に、ページ名、英数字の別名(オプション)、関連付けられたページ・グループなど、カレント・ページの一般的な属性を示します。
表 8-1 ページ属性: 名前
| 属性 | 説明 |
|---|---|
|
アプリケーション開発者のカレント・ページの名前を指定します。この名前は、ページ番号およびページ・タイトルとともに、多くのページおよびレポートで使用されます。 |
|
|
このページの英数字の別名を入力します。この別名は、カレント・アプリケーション内で一意である必要があります。 たとえば、アプリケーション100のページ1で作業している場合、別名「 f?p=100:home |
|
|
このページと関連付けるページ・グループを指定します。ページ・グループは、機能に影響しませんが、開発者がアプリケーション内のページを管理するのに役立ちます。 グループからページを削除するには、「- グループが割り当てられていない -」を選択し、「変更の適用」をクリックします。 関連項目: 「ページのグループ化」 |
表8-2に、選択されるページ・テンプレート、標準タブ・セット、タイトル、カーソル・フォーカスなど、カレント・ページの一般的な表示属性を示します。
表 8-2 ページ属性: 表示属性
| 属性 | 説明 |
|---|---|
|
このページの外観を制御するページ・テンプレートを選択します。ページ・テンプレートを選択すると、現行のテーマ内に定義されたデフォルト・ページ・テンプレートが上書きされます。 関連項目: 「テーマの編集」 |
|
|
このページに使用する標準タブ・セットを選択します。標準タブ・セットは、特定のページおよびページ番号に関連付けられます。標準タブを使用すると、特定のページにユーザーをリンクできます。 関連項目: 「タブの作成」 |
|
|
ブラウザ・ウィンドウのタイトル・バーに表示するタイトルを入力します。Application Expressエンジンは、ページ・テンプレートで使用される#TITLE#置換文字列のかわりに、ここで指定するタイトルを使用します。このタイトルは、HTMLタグ |
|
|
カーソル・フォーカスを指定します。使用可能なオプションは次のとおりです。 |
|
|
インターネット・メディア・タイプを入力します。インターネット・メディア・タイプは、2つの部分で構成される、インターネット上のファイル形式を表す識別子です。メディア・タイプは、少なくともタイプとサブタイプの2つの部分で構成され、オプションで1つ以上のパラメータを指定します。メディア・タイプは、ページ描画の際にHTTPヘッダーのContent-Typeで使用されます。ページ・レベルのメディア・タイプが、アプリケーション・レベルのメディア・タイプを上書きします。この属性のデフォルト値は |
表8-3に、カレント・ページにJavaScriptを含めることができる属性を示します。
表8-3 JavaScript属性
| 属性 | 説明 |
|---|---|
|
このページにロードするコードのJavaScriptのファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列 ここに入力したJavaScriptのファイルURLによって、ページ・テンプレート内の 注意: スクリプトの開始タグや閉じタグを含めないでください。URLのみを記述します。 次に例を示します。
|
|
|
このページで使用するコードのJavaScriptコード(ファンクション、グローバル変数の宣言など)を入力します。コードを複数のページで使用する場合は、そのコードを外部のJavaScriptファイルに追加して重複を避けることを検討してください。 ここに入力したコードによって、ページ・テンプレート内の 注意: スクリプトの開始タグや閉じタグを含めないでください。JavaScriptコードのみ含めます。 ショートカットを参照するには、次の方法を使用します。 "SHORTCUTNAME" |
|
|
ページがロードされたときに実行されるJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。 ここに入力したコードによって、ページ・テンプレート内の 注意: スクリプトの開始タグや閉じタグを追加せず、JavaScriptコードのみ追加します。 |
表8-4に、カレント・ページにカスケード・スタイルシート(CSS)ファイルを含めることができる属性を示します。
表8-4 CSS属性
| 属性 | 説明 |
|---|---|
|
このページにロードされるカスケード・スタイルシート・ファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列 ここに入力したファイルURLによって、ページ・テンプレート内の 注意: スクリプトの開始リンク・タグや閉じリンク・タグを含めないでください。ファイルURLのみを含めてください。 次に例を示します。
注意: スクリプトの開始タグや閉じタグを含めないでください。URLのみを記述します。詳細は、アイテムのヘルプを参照してください。 |
|
|
このページに使用されるカスケード・スタイルシートのコードを入力します。コードが複数のページで使用されている場合、重複を避け、ブラウザで静的ファイルをキャッシュするため、外部ファイルに挿入することを検討してください。 ここに入力したコードによって、ページ・テンプレート内の 注意: スクリプトの開始スタイル・タグや閉じスタイル・タグを含めないでください。カスケード・スタイルシート・コードのみを含めます。 たとえば、CSSクラス
.display_only {
font-weight:bold;
}
|
表8-5に、ページ・ヘッダーおよびページのHTML本文テキストを定義する属性を示します。
表8-6に、ヘッダーおよびフッター・テキストを定義する属性を示します。
「読取り専用条件タイプ」では、このページでページ・アイテムを読取り専用としてレンダリングするために必要な条件タイプをリストから選択します。アイテムのタイプに応じて、読取り専用アイテムはプレーン・テキストまたは入力不可フィールドとしてレンダリングされます。条件を選択しない場合、アイテムは通常どおりレンダリングされます。
ページレベルで定義した「読取り専用」条件は、プロセス・ポイント「ロード時 - ヘッダーの後」でプロセスを実行した後に評価されます。この評価順序により、開発者は、フェッチ・プロセス(またはその他のプロセス)によってページ・アイテムの設定を参照し、その設定を読取り専用条件で使用して、表示されるデータに基づいてページを読取り専用にすることができます。
|
ヒント: 一部のページ・アイテム(検索フィールドなど)または特定のリージョンのすべてのページ・アイテムを、この条件の評価内容とは無関係に常に入力可能なページ・アイテムとしてレンダリングする場合は、これらのリージョンまたはページ・アイテムの読取り専用条件を「なし」に設定します。 |
表8-7に、カレント・ページの認可スキームおよび認証要件を定義する属性を示します。
表 8-7 ページ属性: セキュリティ
| 属性 | 説明 |
|---|---|
|
ページに適用する認可スキームを選択します。認可スキームはアプリケーション・レベルで定義され、アプリケーション内の多くの要素に適用できます。 認可スキームは、アプリケーション・セッション(セッションの作成時)ごとに1回評価されるか、ページ・ビューごとに1回評価されます。選択した認可スキームがtrueと評価された場合、ページが表示され、他の定義された条件に従います。falseと評価された場合、ページは表示されず、エラー・メッセージが表示されます。 関連項目: 「認可を介したセキュリティの提供」 |
|
|
このページがパブリック・ページとして定義されているか、または認証が必要かを指定します。ページをパブリック・ページとして指定した場合、ページは認証の前に表示されます。この属性は、認証が必要なアプリケーションにのみ適用されます。アプリケーションのページ監視ファンクションは、このページ属性にアクセスして、表示前に事前認証が不要なページを識別できます。認証スキームのページ監視ファンクションの実装によって、この属性が影響するかどうかが判別されます。 関連項目: 認証によるユーザー・アイデンティティの証明 |
|
|
この属性を使用して、アプリケーション・ページのディープ・リンクを有効または無効にします。オプションは次のとおりです。
関連項目: 「認証」 |
|
|
ページ・アクセス保護 |
注意: この属性は、アプリケーションについて「セッション・ステート保護」が有効化されている場合のみ表示されます。詳細は、「セッション・ステート保護の理解」を参照してください。 カレント・ページのページ・アクセス保護レベルを選択します。
|
|
この属性を「オン」に設定してもページには影響はありません。この値を「オフ」に設定すると、FORMタグに次のHTMLが生成されます。 autocomplete="off" |
|
|
注意: この機能には、HTTPヘッダー・レスポンス変数 オプションは次のとおりです。
セキュリティの観点からおよびベスト・プラクティスとして、ブラウザのキャッシュを無効にしておくことをお薦めします。これにより、ブラウザに機密データが格納されないようにし、URLが変わる場合に常にページがリクエストされます。そうしない場合、ログアウト後にブラウザ履歴で前に戻り、以前のセッションのキャッシュされたコンテンツを表示できる可能性があります。 |
「複製ページの送信を許可」リストを使用して、ユーザーがページを1行で繰り返し処理できるかどうかを指定します。重複するページ送信が繰り返し処理されないようにするには、この属性を「いいえ」に設定します。
重複するページ送信の例を次に示します。
ユーザーが「送信」ボタンを繰り返しクリックした場合
ブランチ・タイプ「ページにブランチ」を作成して、ユーザーがブラウザの再ロード・ボタンをクリックした場合
「複製ページの送信時は、このURLに移動」で、URLを入力します。「複製ページの送信を許可」を「いいえ」に設定している場合はこのフィールドを使用します。「いいえ」を選択していて同一ページを2回発行すると、Oracle Application Expressはエラー・メッセージとユーザーが指定したURLへのリンクを表示します。
表8-8に、カレント・ページのキャッシュを有効にする属性を示します。
表8-8 キャッシュ属性
| 属性 | 説明 |
|---|---|
|
「はい」または「いいえ」を選択して、ページ・キャッシュを有効にするかどうかを指定してください。ページ・キャッシュは、ページを動的に表示せずにキャッシュから表示するため、パフォーマンスが向上します。 |
|
|
キャッシュされたページが有効な時間を指定してください。 |
|
|
ページがユーザーによってキャッシュされる必要があるかどうかを指定します。「はい」の場合、ページは各ユーザー用にキャッシュされます。「いいえ」の場合、キャッシュされた同じページがすべてのユーザーに使用されます。 |
|
|
条件を指定してください。条件がFalseを戻す場合、ページは動的にレンダリングされ、キャッシュされません。条件がTrueを戻す場合、ページはキャッシュから表示されます。 |
|
|
選択した「キャッシュ・ページ条件」に従って条件付きで表示されます。 選択した特定の条件タイプに基づいて、この属性に値を入力してください。 |
|
|
選択した「キャッシュ・ページ条件」に従って条件付きで表示されます。 選択した特定の条件タイプに基づいて、この属性に値を入力してください。 |
このページに対するビルド・オプションを選択します。ビルド・オプションを使用すると、機能を有効または無効にできます。ほとんどのアプリケーション属性は、ビルド・オプション属性を持ちます。特定の構成でページを除外する場合以外は、カレント・ページのビルド・オプションを指定しないでください。
ビルド・オプションは、INCLUDEおよびEXCLUDEという2つの値をとることができます。属性を含めように指定すると、Application Expressエンジンは、実行時にその属性をアプリケーション定義の一部とみなします。逆に、属性を除外するように指定すると、Application Expressエンジンは、その属性を存在しないものとして処理します。
表8-9に、アプリケーションがエラーのログを記録する方法を制御または変更するために使用する属性を示します。
「インライン・エラー通知テキスト」で、ページでエラーが発生した場合に#NOTIFICATION_MESSAGE#テンプレート置換文字列に表示するエラー・テキストを入力します。
表8-9 「ページ属性」の「エラー処理」
| 属性 | 説明 |
|---|---|
|
ページでエラーが発生した場合に |
|
|
既存のエラー・メッセージと表示位置を変更するか、エラーが発生した場合にそれをログに記録するための、PL/SQLエラー・ファンクションの名前を入力します。このファンクションは、データベース内のパッケージ・ファンクションまたはスタンドアロンのファンクションを参照できます。次に例を示します。 log_apex_error データベースのPL/SQLパッケージまたはスタンドアロンのファンクションを参照する場合、 #OWNER#.log_apex_error
function <name of function> (
p_error in apex_error.t_error )
return apex_error.t_error_result
関連項目: 『Oracle Application Express APIリファレンス』の 注意: アプリケーション・レベルで指定するエラー処理ファンクションは、ページ・レベルで指定されるエラー処理により上書きされます。「アプリケーション定義の編集」を参照してください。 |
