プライマリ・コンテンツに移動

Oracle® Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド リリース5.1 E83810-03 |
| 目次 | 索引

前 | 次 |

# 9.5 フォームでのユーザー入力の検証

開発者は、検証および関連するエラー・メッセージを作成して、ユーザーが入力したデータを処理する前にチェックすることができます。

トピック:

- 検証およびエラー・メッセージの作成について
- ページ・デザイナでの検証と特定のアイテムとの関連付け
- コンポーネント・ビューでの検証と特定のアイテムとの関連付け
- エラー・メッセージ表示位置について

## 9.5.1 検証およびエラー・メッセージの作成について

検証を使用すると、ユーザーが入力したデータを処理前に確認できます。検証および関連するエラー・メッセージを作成したら、これらを特定のアイテムと関連付けることができます。検証エラー・メッセージをインライン表示(検証が実行されたページで表示)するか、個別のエラー・ページで表示するかを選択できます。

インラインのエラー・メッセージを作成するには、次のステップを実行します。

- ステップ1 - 検証を作成し、エラー・メッセージ・テキストを指定します。詳細は、検証の理解を参照してください。

- ステップ2 - 検証を特定のアイテムと関連付けます。

## 9.5.2 ページ・デザイナでの検証と特定のアイテムとの関連付け

アイテムを検証と関連付け、エラー・メッセージ・テキストを指定するには、次のステップを実行します。

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

   プロパティ・エディタに検証属性が表示されます。

4. プロパティ・エディタですべての属性を表示するには、「すべて表示」をクリックします。
5. グループまたは属性を検索するには、「フィルタ・プロパティ」フィールドにキーワードを入力します。
6. 次の属性を編集します。

   - エラー、エラー・メッセージ - 検証に合格しないイベントで表示されるテキストを入力します。

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

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

   ヒント:

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

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

## 9.5.3 コンポーネント・ビューでの検証と特定のアイテムとの関連付け

アイテムを検証と関連付け、エラー・メッセージ・テキストを指定するには、次のステップを実行します。

1. コンポーネント・ビューで適切なページにナビゲートします。レガシー・コンポーネント・ビューでのページの表示を参照してください。
2. ページ検証の編集ページにナビゲートします。「検証」で、関連付ける検証を選択します。

   検証の属性ページが表示されます。

3. 「エラー・メッセージ」までスクロールします。
4. 「エラー・メッセージ」で、次のように入力します。

   - エラー・メッセージ - エラー・メッセージを入力します。

   - エラー・メッセージ表示位置 - 検証エラー・メッセージの表示位置を指定します。表示位置を確認します。

   - 関連付けられたアイテム: 対象の検証と関連付けるアイテムを選択します。

5. 「変更の適用」をクリックします。

## 9.5.4 エラー・メッセージ表示位置について

エラー・メッセージ表示位置は、検証エラー・メッセージがどこに表示されるかを指定します。検証エラー・メッセージは、エラー・ページに表示したり、既存ページ内にインラインで表示できます。インライン・エラー・メッセージは、通知領域(ページ・テンプレートの一部として定義される)に表示したり、フィールド・ラベル内に表示できます。

残りのすべての検証を含むプロセスを停止するハード・エラーを作成する場合は、エラー・ページにエラーを表示する必要があります。