8.4 ページ属性の管理

ページ属性を編集して、ページ名またはタイトル、ヘッダーおよびフッター・テキスト、ナビゲーション・メニュー、ページ・レベルのJavaScriptまたはCSSファイルの追加、エラー処理、選択した認可スキームなど、特定のページの基本情報と機能を制御します。

関連項目:

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

親トピック: ページ・デザイナでのページの編集

8.4.1 ページ属性の編集

ページ・デザイナでページ属性を編集するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブまたは「レイアウト」タブのいずれかで、ページ名を選択します。
プロパティ・エディタで該当する属性を編集します。
ページが保存されるまで、編集した属性の属性名の左側に青色のマーカーが表示されます。

注意:
属性の詳細は、フィールドレベル・ヘルプを参照してください。
変更内容を保存するには、「保存」または「ページの保存と実行」をクリックします。

親トピック: ページ属性の管理

8.4.2 ページ・デザイナを使用したJavaScriptの組込み

JavaScriptグループの属性を編集することによって、ページにJavaScriptを含めることができます。これは、ページに固有のファンクションに有効な方法であり、ファンクションを.jsファイルに組み込む前にテストを行う有効な方法です。

JavaScriptコードをJavaScript属性に追加するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブで、ページ名を選択します。
プロパティ・エディタにページ属性が表示されます。
プロパティ・エディタで、「JavaScript」グループを検索します。
「JavaScript」で、次の属性を編集します。
1. ファイルURL: このページにロードするコードのJavaScriptファイルURLを入力します。各URLを新しい行に記述する必要があります。ファイルの縮小バージョンを指定する場合、置換文字列#MIN#を使用して.minを、または#MIN_DIRECTORY#を使用してminified/を通常ページ・ビューのファイルURLに含めたり、ページをデバッグ・モードで表示する場合は空の文字列を含めることができます。アプリケーションのバージョンをファイルURLに含める場合、置換文字列#APP_VERSION#にアクセスすることもできます。
2. ファンクションおよびグローバル変数の宣言 - このページで参照されるファンクションまたはグローバル変数宣言などのJavaScriptコードを入力します。複数のページで同じJavaScriptが必要な場合、重複を避け、ブラウザで静的ファイルをキャッシュするため、外部JavaScriptファイルにコードを挿入することを検討してください。
  ここに入力したコードによって、ページ・テンプレート内の#PAGE_JAVASCRIPT#置換文字列が置き換えられます。
  
  ヒント:
  スクリプトの開始タグや閉じタグを含めないでください。JavaScriptコードのみ含めます。
  
  ショートカットを参照するには、次の方法を使用します。
  
  "SHORTCUTNAME"
3. ページ・ロード時に実行: ページのロード時に実行するJavaScriptコードを入力します。このコードはOracle Application Expressによって生成されたJavaScriptコードの後に実行されます。
ヒント:
属性の詳細を参照したり、例を表示するには、属性を選択して、中央ペインの「ヘルプ」タブをクリックします。

たとえば、「ファンクションおよびグローバル変数の宣言」属性に次を追加すると、カレント・ページのすべての場所からアクセス可能なファンクションをテストします。
```
function test(){
    alert('This is a test.');
  }
```
「保存」をクリックします。

親トピック: ページ属性の管理

8.4.3 セッションの再結合の構成

リージョンの再結合属性は、既存のセッションの結合(ディープ・リンクと同等)に対するサポートを制御します。技術的に、この属性は、このアプリケーションに対するURLにセッションIDを含むかどうかを決定します。

警告:

セッションの再結合を有効にすると、攻撃者が既存のエンド・ユーザー・セッションを乗っ取ることが可能になるため、アプリケーションのセキュリティが侵害される可能性があります。詳細は、「セッションを再結合」についてを参照してください。

セッションの再結合を使用するには、管理者がインスタンス・レベルでセッションの再結合を有効化する必要があります。インスタンス・レベルでのセッションの再結合のより制限的な値は、アプリケーションおよびページ設定をオーバーライドします。

ページ・デザイナでセッションの再結合を構成するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブで、ページ名を選択します。
プロパティ・エディタにページ属性が表示されます。
プロパティ・エディタで、「セキュリティ」グループを検索します。
「セキュリティ」、「セッションを再結合」で、次のオプションを選択します。
- アプリケーション・デフォルト - アプリケーション・レベルで定義されている設定を継承します。
- 無効 - URLにセッションIDが含まれていない場合、Application Expressは新しいセッションを作成します。
- パブリック・セッションに対して有効 - URLがパブリック・ページのもので、セッションIDが含まれていない場合、Application Expressはそのアプリケーションに対して確立された既存のセッションCookieの利用を試みます。Application Expressは、セッションがまだ認証されていない場合にのみCookieを使用して結合します。
  
  「パブリック・セッションに対して有効」には、「フレームへの埋込み」が「同じ起点から許可」、または「拒否」に設定されている必要があります。これはURLペイロードの条件に関連付けられませんが、セッション・ステート保護されるURLにも適用されます。
- すべてのセッションに対して有効 - URLにセッションIDが含まれておらず、次の条件が満たされる場合、Application Expressはそのアプリケーションに対して確立された既存のセッションCookieの利用を試みます。
  - セッション・ステート保護がそのアプリケーションに対して有効で、URLに有効なチェックサムが含まれています。パブリック・ブックマークの場合、最も制限的なアイテム・レベルの保護は「制限なし」または「チェックサムが必要 - アプリケーション・レベル」である必要があります。
  - URLにペイロードは含まれていません(リクエスト・パラメータ、クリア・キャッシュまたはデータ値ペア)。
    
    この設定では、アプリケーションの「フレームへの埋込み」が「同じ起点から許可」または「拒否」に設定されている必要もあります。
ヒント:
「アプリケーション・デフォルト」オプションは、アプリケーション・レベルで定義されている設定を継承します。ブラウザ・セキュリティを参照してください。
「保存」をクリックします。

関連項目:

ブラウザ・セキュリティ
「セッションを再結合」について
Oracle Application Express管理ガイドの「インスタンスへのセッション再結合の構成」

親トピック: ページ属性の管理

8.4.4 ダイアログ属性の構成

ヒント:

ダイアログ・ページの作成は、複数ステップのプロセスです。詳細は、ダイアログ・ページの作成を参照してください。

ページ・デザイナでダイアログ属性を構成するには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブで、ページ名を選択します。
プロパティ・エディタにページ属性が表示されます。
プロパティ・エディタで、「外観」を検索し、「ページ・モード」が「モーダル・ダイアログ」または「非モーダル・ダイアログ」のいずれかに設定されていることを確認します。
「ダイアログ」を展開して、次の属性を構成します。
ヒント:
属性のヘルプを表示するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックします。
1. 幅
2. 高さ
3. 最大幅
4. 属性
5. CSSクラス
6. チェーン
変更内容を保存するには、「保存」または「ページの保存と実行」をクリックします。

親トピック: ページ属性の管理

8.4.5 保存されていない変更についてユーザーに警告するためのページ属性の構成

開発者は「保存されていない変更の警告」ページ属性を有効にして、ユーザーがページから移動しようとしたときに、保存されていない変更について警告できます。

「保存されていない変更の警告」ページ属性を有効にするには、次のステップを実行します。

ページ・デザイナでページを表示します。
1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. ページを選択します。
ページ・デザイナが表示されます。
「レンダリング」タブで、ページ名を選択します。
プロパティ・エディタにページ属性が表示されます。
プロパティ・エディタで、「ナビゲーション」グループを検索します。
ユーザーに警告するには、「保存されていない変更の警告」で、「はい」を選択します。
「保存」をクリックします。

ヒント:

「保存されていない変更の警告」属性は、apex.page.warnOnUnsavedChanges APIを使用して実装されます。

関連項目:

親トピック: ページ属性の管理