16.2 検証の理解

検証を使用して、特定のアイテム、ページまたは列に対する編集確認を作成します。

• 検証について
  
• 検証の作成
  
• 検証の編集
  
• 検証の実行タイミングの決定について
  
• 検証エラー・メッセージの表示方法の定義について
  
• 検証の条件付き実行
  
• 「エラーに移動」リンクの変更について
  
• 検証が失敗した場合の処理
  

16.2.1 検証について

検証は編集確認です。単一アイテムに固有の検証は、ページ・アイテムの検証です。ページ全体に適用する検証は、ページの検証です。単一列に固有の表形式フォームの検証は、列レベルの検証です。単一列に適用しない表形式フォームの検証は、表形式フォームの行の検証です。

検証を宣言的に定義するには、検証方法を選択します。検証メッセージ・フィールドに、実際の検証の編集確認を入力します。検証が失敗した場合は、後続のページ・プロセスまたは計算が行われないことに注意してください。また、入力した検証は、選択した検証タイプと一貫性がある必要があることも注意してください。

16.2.2 検証の作成

ページ・デザイナで検証を作成するには、次のステップを実行します。

注意:

検証に対して入力するテキストは、3,950文字以下にする必要があります。

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 左ペインで「プロセス」タブをクリックします。
3. 「検証」を右クリックして、「検証の作成」を選択します。

   検証属性がプロパティ・エディタに表示されます。属性は、グループに編成されます。

4. グループまたは属性を検索するには、次のステップを実行します。

   • グループまたは属性の検索: 「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。デフォルトの表示に戻すには、キーワードを削除します。

   • 「グループに移動」の使用: 「グループに移動」をクリックして、グループを選択します。デフォルトの表示に戻すには、「グループに移動」を再度クリックして、「すべて開く」を選択します。

5. 次の属性を編集します。

   ヒント:

   属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

   1. 指定、名前 - 検証の名前を入力します。
   2. 実行オプション、順序 - この検証の順序を入力します。これによって実行の順序が決まります。
   3. 検証、編集可能リージョン - 関連するリージョンを選択します。
   4. 検証、タイプ - この検証に対してテストする等価のタイプを選択します。選択によっては、この検証を完全に定義するために1つ以上の追加属性が必要となります。

      検証が等価テストをパスした場合、またはTRUEと評価された場合、検証エラー・メッセージは表示されません。検証エラー・メッセージは、検証が等価テストに失敗した場合、FALSEと評価された場合、または空でないテキスト文字列が返された場合に表示されます。

   5. 検証、常に実行 - この検証を常に実行するかどうかを指定します。

      「はい」に設定した場合、ページを送信したボタンに対して定義されている「検証の実行」の設定に関係なく、この検証は常に評価されます。「いいえ」に設定した場合、この検証は、トリガー元のボタンの「検証の実行」の設定が「はい」の場合にのみ評価されます。

   6. エラー、エラー・メッセージ - エラー・メッセージのテキストを入力します。
   7. エラー、表示位置 - この検証のエラー・メッセージが表示される位置を選択します。

      検証エラー・メッセージは、別のエラー・ページに表示したり、既存ページ内にインラインで表示することができます。インライン・エラー・メッセージは、ページ・テンプレートの一部として定義されている「関連付けられたアイテム」ラベルの下/「通知」領域内に表示されます。

   8. エラー、関連付けられたアイテム/関連付けられた列 - この検証のエラー・メッセージを表示するアイテムまたは列を選択します。

      アイテムを選択し、エラー・メッセージの表示位置に「フィールドでインライン表示」が含まれる場合、エラー・メッセージは指定されたアイテム・ラベルの下に表示されます。エラー・メッセージの表示位置に「フィールドでインライン表示」が含まれない場合、この属性はエラー・メッセージの表示に影響しません。

6. 「保存」をクリックします。

関連項目:

• 「レンダリング前ブランチ、計算およびプロセスの作成」

• 「ページ送信ブランチ、検証、計算およびプロセスの作成」

16.2.3 検証の編集

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

1. ページ・デザイナでページを表示します。
   1. ワークスペースのホームページで、「アプリケーション・ビルダー」アイコンをクリックします。
   2. アプリケーションを選択します。
   3. ページを選択します。
   ページ・デザイナが表示されます。
2. 左ペインで「プロセス」タブをクリックします。
3. 「検証中」を展開してから「検証」を展開し、検証を選択します。

   プロパティ・エディタに検証属性が表示されます。属性は、グループに編成されます。

4. グループまたは属性を検索するには、次のステップを実行します。

   • グループまたは属性の検索: 「フィルタ・プロパティ」フィールドにキーワードを入力します。プロパティ・エディタにグループまたは属性が表示されます。デフォルトの表示に戻すには、キーワードを削除します。

   • 「グループに移動」の使用: 「グループに移動」をクリックして、グループを選択します。デフォルトの表示に戻すには、「グループに移動」を再度クリックして、「すべて開く」を選択します。

5. プロパティ・エディタで、適切な属性を編集します。

   ヒント:

   属性の詳細は、プロパティ・エディタで属性を選択し、中央ペインで「ヘルプ」タブをクリックして、参照してください。

6. 「保存」をクリックします。

16.2.4 検証の実行タイミングの決定について

検証を作成するときに、「常に実行」属性で、ページが送信されるときに検証が実行されるかどうかが決定されます。この属性は、ページを送信する、ボタンまたは特定のページ・アイテムに使用します。「常に実行」属性には2つのオプションがあります。

• 「はい」: 検証は、ページ上のボタンまたはアイテムの検証設定とは無関係に常に実行されます。

  たとえば、現行ユーザーに現行レコードの変更や削除を許可するかどうかを決定するセキュリティ・チェックとしての検証の場合は、「はい」を選択します。これにより、いずれの操作に対しても検証が実行され、権限のないユーザーによる変更を防ぐことができます。

• 「いいえ」: 検証は、ページを送信するために使用されるボタンまたはアイテムの「検証の実行」属性が「はい」に設定されているときにのみ実行されます。

  たとえば、ユーザーが単にレコードを削除しようとしているときに、アイテムが数値であることを検証してエラー・メッセージを表示しても役立ちません。この場合は、ユーザーが「作成」または「変更の適用」ボタンをクリックしたときにのみ検証を実行する必要があります。

  この動作を実現するには、次のステップを実行します。

  • 検証で、「常に実行」に「いいえ」を設定します。

  • 「作成」および「変更の適用」ボタンでは、「検証の実行」に「はい」を設定します。

  • 「削除」ボタンでは、「検証の実行」を「いいえ」に設定し、不要な検証を回避します。

関連項目:

検証の編集

16.2.5 検証エラー・メッセージの表示方法の定義について

検証エラー・メッセージをインライン表示(検証が実行されたページで表示)するか、個別のエラー・ページで表示するかを選択できます。

次の検証属性を構成することによって、検証エラー・メッセージの表示方法を定義します。

1. エラー・メッセージ - このフィールドにエラー・メッセージ・テキストを入力します。

2. 表示位置 - この検証のエラー・メッセージが表示される位置を選択します。検証エラー・メッセージは、別のエラー・ページに表示したり、既存ページ内にインラインで表示することができます。インライン・エラー・メッセージは、ページ・テンプレートの一部として定義されている「関連付けられたアイテム」ラベルの下/「通知」領域内に表示されます。

   ヒント:

   コンポーネント・ビューでは、この属性は「エラー・メッセージ表示位置」という名前です。

   オプションは次のとおりです。

   • 「フィールドおよび通知でインライン表示」: エラーは、フィールド・ラベル内および通知領域(ページ・テンプレートの一部として定義される)にインラインで表示されます。

   • 「フィールドでインライン表示」: エラーはフィールド・ラベル内にインラインで表示されます

   • 「通知でインライン表示」: エラーは、通知領域(ページ・テンプレートの一部として定義される)にインラインで表示されます。

   • 「エラー・ページ」: エラーは、個別のエラー・ページに表示されます。すべての処理(検証を含む)を停止するハード・エラーを作成する場合は、エラー・ページにエラーを表示する必要があります。

3. 関連付けられたアイテム (または関連付けられた列) - この検証のエラー・メッセージを表示するアイテム(または列)を選択します。

   アイテムを選択し、エラー・メッセージの表示位置に「フィールドでインライン表示」が含まれる場合、エラー・メッセージは指定されたアイテム・ラベルの下に表示されます。エラー・メッセージの表示位置に「フィールドでインライン表示」が含まれない場合、この属性はエラー・メッセージの表示に影響しません。

関連項目:

検証の編集

16.2.6 検証の条件付き実行

次の条件属性を構成することによって、検証をいつ実行するか、および実行するかどうかを制御できます。

1. 対象ボタン: このページ処理コンポーネントを、指定したボタンがクリックされたときのみ実行する場合、リストからボタンを選択します。このボタンの条件を他の条件と統合し、このページ処理コンポーネントがいつ実行されるかをさらに絞り込むことができます。

   ボタンがクリックされない場合、検証を実行する前に他の条件が評価されます。

2. 実行スコープ: 表形式フォームにのみ適用されます。次のようにして、実行スコープを指定します。

   • 作成済および変更済の列: 表形式フォームで作成および変更した行でのみ検証を実行します。

   • すべての送信済の列: 送信したすべての行で検証を実行します。

3. 条件タイプ: このコンポーネントをレンダリングまたは処理するために満たす必要がある条件タイプをリストから選択します。オプション・リストを表示するには、「ヘルプ」タブをクリックします。

関連項目:

• 検証の編集

• 条件付きのレンダリングおよびプロセスの理解

16.2.7 「エラーに移動」リンクの変更について

関連付けるアイテムを定義すると、Oracle Application Expressによって、対応するエラー・メッセージの隣の通知表示位置に「エラーに移動」リンクがレンダリングされます。クリックすると、ユーザーのフォーカスが関連付けられたアイテムに移動します。

「エラーに移動」テキストを変更して、デフォルトのテキストを変更したり、Oracle Application Expressによってデフォルトでは翻訳されない言語に翻訳することができます。いずれの場合でも、必要なテキストと言語とともに、APEX.GO_TO_ERRORという名前のテキスト・メッセージを定義してください。さらに、APEX.GO_TO_ERRORテキスト・メッセージのテキストを単なるシングル・スペースに設定して、この機能を無効化し、「エラーに移動」リンクを削除できます。

関連項目:

Oracle Application Expressにより内部使用されるメッセージの翻訳

16.2.8 検証が失敗した場合の処理

ページが送信され一部の検証が失敗した場合、Oracle Application Expressは既存のページを、すべてのインライン検証エラーを含めて再表示します。インライン・エラーの表示中は、Oracle Application Expressはページ・レンダリング中(つまり、すべての「ロード時%」の表示ポイント)に実行するように定義されている計算、アプリケーション・プロセスまたはページ・プロセス(行の自動フェッチなど)を実行しません。ただし、計算およびプロセスで「インライン検証エラーあり」条件タイプが使用されている場合のみ例外です。

これらの計算およびプロセスをスキップする理由は、これらによりユーザーが入力したデータが変更される可能性があるためです。たとえば、検証エラーを修正するためにユーザーが実際に入力されたデータを必要とする場合に、行の自動フェッチ・プロセスは、変更されたデータをフェッチし、データベースからの値で上書きします。

計算がスキップされた場合、デバッグ出力に次の内容が表示されます。

Do not perform computation because inline validation errors found.

アプリケーションまたはページ・プロセスがスキップされる場合、デバッグ出力に次の内容が表示されます。

Skip because inline validation errors found.