13.1.4 ページ・アイテムの編集

ページ上のアイテムの表示方法を制御するには、アイテム属性を編集します。

たとえば、「タイプ」属性によって、アイテムをテキスト・フィールド、テキスト領域、チェック・ボックス、日付ピッカー、スイッチ、非表示アイテムなどとして表示するかどうかが決定されます。アイテムのタイプに応じて、アイテム属性で、ラベルの表示位置、アイテムの大きさおよびアイテムの表示位置(前のアイテムの横または下)を決定できます。また、アイテム属性は、アイテムのデフォルト値、アイテムが条件付きで表示されるかどうか、アイテムが読取り専用かどうかなどのアイテムの動作を制御します。

• プロパティ・エディタでのページ・アイテム属性の編集
  
• ページ・アイテムの配置
  
• ページ・アイテムのデフォルト値の定義
  
• ページ・アイテムのセキュリティの構成
  
• クイック選択を使用するように既存のアイテムを変更する
  
• 条件付きページ・アイテムの表示
  
• 読取り専用ページ・アイテムの表示
  
• アイテムへの書式マスクの適用
  
• 保存されていない変更についてユーザーに警告するためのアイテム属性の構成
  
• ページ・アイテムによるセッション・ステートの書込み方法の制御
  
• アイテム・ユーティリティの表示
  

13.1.4.1 プロパティ・エディタでのページ・アイテム属性の編集

プロパティ・エディタでアイテム属性を編集するには:

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

   ヒント:

   属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力するか、「グループに移動」をクリックして、グループを選択します。
3. 対象となる属性を編集します。
   ページが保存されるまで、編集した属性の属性名の左側に緑色のマーカーが表示されます。

   ヒント:

   属性についてさらに学習するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

13.1.4.2 ページ・アイテムの配置

ページ・レベルでのページ・アイテムの配置

ページ・アイテムは、ページまたはリージョン・レベルで配置できます。

ページ・アイテムをページ・レベルに配置するには、ページ・デザイナでページ・アイテムを選択します。プロパティ・エディタで、「レイアウト」、「リージョン」属性を空のままにします。ページの特定の場所にページ・アイテムを配置するには、「レイアウト」、「位置」属性を構成します。

リージョン・レベルでのページ・アイテムの配置

ページ・アイテムをリージョン・レベルで配置するには、ページ・デザイナでページ・アイテムを選択します。プロパティ・エディタで、「レイアウト」、「リージョン」属性を編集し、ページ・アイテムが属するリージョンを選択します。次に、リージョン内の「レイアウト」、「位置」を構成して、ページ・アイテムをリージョン内の特定の場所に配置します。

13.1.4.3 ページ・アイテムのデフォルト値の定義

「デフォルト」属性を使用してアイテムのデフォルト値を定義します。デフォルト値は、アイテムの値がセッション・ステートから導出されない場合およびソース値がNULLの場合に使用されます。

アイテムのデフォルト値を定義するには:

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

   ヒント:

   属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力するか、「グループに移動」をクリックして、グループを選択します。
3. プロパティ・エディタで、「デフォルト」グループを見つけます。
4. デフォルト、タイプ: このアイテムのデフォルトの値タイプを選択します。オプションは次のとおりです。
   • 静的: 「静的」値に入力された値に設定します。
   • アイテム: 選択されたアイテムのセッション・ステートから返された値に設定します。
   • SQL問合せ: 入力されたSQL問合せから返された値に設定します。
   • コロンで区切られたリストを戻すSQL問合せ: 入力されたSQL問合せから返された、値がコロンで区切られたリストに設定します。列をチェック・ボックス、ラジオ・グループまたはシャトルとして表示する場合は、コロンで区切られたリストが必要です。
   • PL/SQL式: 入力されたPL/SQL式から返された値に設定します。
   • PL/SQLファンクション本体: 入力されたPL/SQLファンクション本体から返された値に設定します。
   • 順序: 入力された順序から返された値に設定します。
5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

13.1.4.4 ページ・アイテムのセキュリティの構成

ページ・アイテムのセキュリティを構成するには:

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

   ヒント:

   属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力するか、「グループに移動」をクリックして、グループを選択します。
3. 「セキュリティ」を検索します。次のセキュリティ属性を構成します。

   表13-2 「プロパティ・エディタ - ページ・アイテム」の「セキュリティ」

   属性	説明
   認可スキーム	認可スキームを選択します(この認可スキームがTRUEと評価された場合はこのコンポーネントがレンダリングされ、そうでない場合は処理されます)。 関連項目: 認可を介したセキュリティの提供
   セッション・ステート保護	「セッション・ステート保護」レベルを選択します。オプションは次のとおりです。 制限なし - URLまたはフォームでアイテムを渡して、アイテムを設定できます。URLにチェックサムは必要ありません。 チェックサムが必要 - アプリケーション・レベル: ワークスペースおよびアプリケーション固有のチェックサムが含まれるURLでアイテムを渡して、アイテムを設定できます。 チェックサムが必要 - ユーザー・レベル - ワークスペース、アプリケーションおよびユーザー固有のチェックサムを含むURLでアイテムを渡して、アイテムを設定できます。 チェックサムが必要 - セッション・レベル: セッション固有のチェックサムが含まれるURLでアイテムを渡して、アイテムを設定できます。 制限付き - ブラウザから設定できない: URLまたはPOSTDATAを使用してアイテムを変更できません。内部プロセス、計算などに設定できるアイテムの値を制限する場合は、このオプションを使用します。この属性は、データ・エントリ・アイテムとして使用されないアイテムのみに適用され、セッション・ステート保護が無効になっていても常に監視されます。この属性は、次の表示形式タイプのページまたはアプリケーション・アイテムに使用します 表示のみ(状態の保存=なし) テキスト・フィールド(無効、状態を保存しない) 関連項目: URL改ざんの防止
   セッション・ステートに暗号化された値を保存	セッション・ステートに格納する際、このアイテムを暗号化するかどうかを指定します。アイテムのコンテンツに機密データが含まれる場合、Oracle APEXセッション・ステート管理表に格納する際に値を暗号化する必要があります。そうしないと、APEXメタデータ表を読み取る権限を持つユーザーが問合せを記述し、この機密データを抽出する可能性があります。 最大4000バイトの長さの値を暗号化できます。4000バイトを超える値を暗号化しようとすると、エラー・メッセージが表示されます。
   特殊文字をエスケープ	この属性は、いくつかのアイテム・タイプでのみ表示されます。クロスサイト・スクリプティング(XSS)攻撃を防ぐには、「オン」を選択します。ページ・アイテムまたはLOVのエントリに格納されているHTMLタグを実際にレンダリングする場合は、「オフ」を選択します。 関連項目: クロスサイト・スクリプティング保護の理解
   制限付き文字	セッション・ステートに保存できる文字を制限する方法を選択します。選択した文字制限に準拠しないデータをユーザーが保存しようとすると、APEXからエラー・メッセージが表示されます。文字を制限することはアプリケーションのセキュリティを強化し、クロスサイト・スクリプティング(XSS)攻撃の対策となります。 使用可能なオプションは次のとおりです。 すべての文字を保存できます。: 制限は適用されません。 a-Z、0-9と空白のホワイトリスト: 文字a-z、A-Z、0-9および空白のみが許可されます。 ブラックリストHTMLコマンド文字(<>"): 予約済HTML文字は保存できません。 ブラックリスト<>"/;,*|=%および--: 次の文字は保存できません。 &、<、>、"、/、;、","、*、|、=、%および"--" (PL/SQLコメント) ブラックリスト<>"/;,*|=%または--と改行: 次の文字は保存できません。 &、<、>、"、/、;、","、*、|、=、%、"--"および改行文字 関連項目: クロスサイト・スクリプティング保護の理解

13.1.4.5 クイック選択を使用するように既存のアイテムを変更する

クイック選択では、ユーザーは、テキストを入力したり、使用可能なオプションのリストから選択するかわりに、事前定義された値をワンクリックで選択できます。アイテム・タイプでクイック選択がサポートされている場合は、「クイック選択」属性を使用して、特定のアイテムの下に表示される選択項目を最大10個定義できます。クイック選択をクリックすると、アイテムの値が設定されます。次の例は、5%、10%、15%および20%のクイック選択を示しています。

クイック選択を作成するには:

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

   ヒント:

   属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力するか、「グループに移動」をクリックして、グループを選択します。
3. 「クイック選択」で、次の項目を指定します。
   1. クリック選択の表示 - 「オン」を選択します。
   2. リンク属性 - 各クイック選択リンクの表示に関連付けるHTML属性を入力します
   3. ラベル - 各クイック選択のラベルを入力します。このラベルは、アプリケーションのエンド・ユーザーに表示されるテキストです。
   4. 値 - 各クイック選択に関連付ける値を入力します。ユーザーがクイック選択をクリックすると、この値で既存のアイテム値が置換されます。
4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

13.1.4.6 条件付きページ・アイテムの表示

条件付きアイテムを表示するには:

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

   ノート:

   属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力するか、「グループに移動」をクリックして、グループを選択します。
3. 「サーバー側の条件」を検索します。条件タイプを選択し、表示されたフィールドに適切な情報を入力します。

   ヒント:

   属性についてさらに学習するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。
4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

13.1.4.7 読取り専用ページ・アイテムの表示

読取り専用アイテムを表示するには:

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

   ヒント:

   属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力するか、「グループに移動」をクリックして、グループを選択します。
3. 「読取り専用」で「タイプ」を選択し、表示されたフィールドに適切な情報を入力します。

   ヒント:

   属性についてさらに学習するには、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。
4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

13.1.4.8 アイテムへの書式マスクの適用

ページ・デザイナでアイテムを選択して、「書式マスク」属性を編集することで、アイテムに書式マスクを適用できます。一般的に、開発者は、数値と日付の表示方法を決定する書式マスクを選択します。

アイテムに書式マスクを適用するには:

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

   ヒント:

   属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力するか、「グループに移動」をクリックして、グループを選択します。
3. 「外観」→「書式マスク」で、書式マスクを選択します。

   ヒント:

   数値書式マスクは数値を含むアイテムのみに適用し、日付書式マスクは日付を含むアイテムのみに適用します。そうでない場合、指定した書式マスクを使用して変換できない値がコンポーネントに含まれるため、ランタイム・エラーが発生します。
4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

13.1.4.9 保存されていない変更についてユーザーに警告するためのアイテム属性の構成

開発者は、「保存されていない変更の警告」アイテム属性を使用して、保存されていない変更のチェックにページ・アイテムを含めるかどうかを指定できます。このチェックにより、保存されていない変更が含まれるページから移動しようとすると、ユーザーに警告が表示されます。データベース列に基づかないアイテム(検索アイテムなど)は、チェックする必要がありません。それらのアイテムに対しては、「保存されていない変更の警告」を「チェックしない」に設定します。

「保存されていない変更の警告」属性を構成するには:

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

   ヒント:

   属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力するか、「グループに移動」をクリックして、グループを選択します。
3. 詳細、保存されていない変更の警告: 次のいずれかを選択します。

   • ページのデフォルト: 「保存されていない変更の警告」がページ・レベルで有効になっている場合に、保存されていない変更のチェックにアイテムを含めます。

   • 無視: アイテムの変更は、保存されていない変更のチェックで無視されます。データベース列に基づかないアイテム(検索アイテムなど)には、このオプションを選択します。

4. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

ヒント:

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

関連項目:

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

• Oracle APEX JavaScript APIリファレンスのwarnOnUnsavedChanges

13.1.4.10 ページ・アイテムによるセッション・ステートの書込み方法の制御

アイテム属性「セッション・ステートの保持」を構成することで、ページ・アイテムがそのセッション・ステートを永続(ディスク)セッション・ステートに書き込むか、または単にメモリーに書き込むかを制御できます。

ページ・アイテムがセッション・ステートを書き込む方法を構成するには:

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

   ヒント:

   属性は、グループに編成されます。グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力するか、「グループに移動」をクリックして、グループを選択します。
3. プロパティ・エディタで、「ソース」グループを見つけます。
4. ソース、セッション・ステートの保持: 次のいずれかのオプションを選択します。
   • リクエストごと(メモリーのみ): ステートをデータベースに保存しません。ステートを使用できるのは、現在のリクエストを処理しているときのみです。AJAX要求でアイテムを使用する必要がある場合は、「送信するページ・アイテム」属性を使用してアイテム名を必ず渡してください。
   • セッションごと(ディスク): リクエストをまたがって値にアクセスできるように、各セッションの値がデータベースに保存されます。
   • ユーザーごと(ディスク): ユーザー属性リポジトリに値が保存され、その後のAPEXセッションでも使用できます。

   ノート:

   フォーム・リージョン(ウィザードの一部など)と連動するデータベース・アイテムを作成する場合は、「リクエストごと(メモリーのみ)」がデフォルトになります。「ユーザーごと(ディスク)」は、これらのアイテムでは使用できません。
5. 変更を保存するには、「保存」をクリックします。ページを保存して実行するには、「ページの保存と実行」をクリックします。

関連項目:

セッション・ステートの設定について

13.1.4.11 アイテム・ユーティリティの表示

ユーティリティ・ページには、グリッド編集ページが含まれ、選択したアプリケーション内の複数のページのアイテムを編集できるユーティリティが表示されます。

ユーティリティ・ページにアクセスするには:

1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
2. アプリケーションを選択します。
3. 「ユーティリティ」をクリックします。
4. 「ページ固有のユーティリティ」リージョンで、「アイテム・ユーティリティ」をクリックします。
5. 次のいずれかのレポートを選択します。

   • すべてのアイテム・ラベルのグリッド編集: アプリケーション内のすべてのページのすべてのアイテム・ラベルを編集します。

   • すべてのアイテム・ヘルプ・テキストのグリッド編集: アイテム・ヘルプ・テキストを編集して、アプリケーション全体で一貫性が保たれるようにします。

   • アイテム・ヘルプのサブスクリプション: アプリケーションのアイテム・ヘルプのサブスクリプションを編集します。

   • すべてのページ・アイテム: アプリケーションのすべてのページ・アイテムを編集します。

   • パスワード・アイテム: アプリケーション内のパスワード・アイテムを編集します。セッション・ステートを保存しないパスワード・アイテムをお薦めします。さらに学習するには、ページの右側にある「パスワード・アイテム」リージョンを参照してください。

   • 条件付きアイテム: アプリケーション内の条件付きアイテムを編集します。