validatorDataTable
validatorDataTable プロパティー (以前の validatorTable プロパティー) は、ユーザー入力との比較となる DataTable パーツ validator table を識別します。バリデーター・テーブルが使用されるのは、検証の第 1 ステージの一部です。
最初のステージでは、EGL は、単一のフィールドについて以下のアクションを実行してから、次のフィールドに移動し、そのフィールドについてすべてのアクションを実行します。プロセスは、すべてのフィールドについてすべてのアクションが実行されるまで継続します。
- 通貨記号や数字区切り文字などの書式制御文字をすべてのフィールドから削除します。
- align、lowercase、および uppercase などのプロパティーで指定された必要なフォーマット設定を実行します。
- 日付/時刻フィールドをフォーマットします。
- すべてのフィールドの inputRequired プロパティーを検査します。
- すべてのフィールド内のデータが正しいタイプになっていることを検査します。例えば、数値フィールドでは英字は許可されません。
- 以下のいずれかのプロパティーで指定されたようにフィールドを順に検証します。
- isDecimalDigit
- isHexDigit
- minimumInput
- needsSOSI
- validValues
すべてのプロパティーがすべての UI テクノロジーで有効なわけではありません。
- フィールドを validatorDataTable と突き合わせて検査します (フィールドに指定されている場合)。
チェックはすべて、値間の検証を行う検証関数を指定する validatorFunction プロパティーを使用する前に行われます。
『DataTable パーツ』に記載された、以下のいずれかのタイプのバリデーター・テーブルを指定できます。
- matchInvalidTable
- ユーザーの入力が、データ・テーブルの最初の列のいずれかの値と異なる必要があることを示します。
- matchValidTable
- ユーザーの入力が、データ・テーブルの最初の列の値に一致する必要があることを示します。
- rangeChkTable
- ユーザーの入力が、少なくとも 1 つのデータ・テーブル行の最初の列と 2 番目の列の値の間の値に一致する必要があることを示します。(範囲は包括的です。ユーザーの入力は、行の最初の列または 2 番目の値に一致した場合も有効です。)
検証が失敗した場合、validatorDataTableMsgKey プロパティーの値に基づくメッセージが表示されます。
互換性
| データ項目 | JSF ハンドラー | VGUI レコード | コンソール UI | テキスト書式 Java™ | テキスト書式 COBOL | 印刷書式 Java | 印刷書式 COBOL |
|---|---|---|---|---|---|---|---|
| あり | あり | あり | なし | あり | あり | なし | なし |