validatorFunction
validatorFunction プロパティー (以前の validator プロパティー) は、バリデーター関数を指定します。 バリデーター関数は、検証の第 2 ステージで実行されるロジックです。
最初のステージでは、EGL は、単一のフィールドについて以下のアクションを実行してから、次のフィールドに移動し、そのフィールドについてすべてのアクションを実行します。プロセスは、すべてのフィールドについてすべてのアクションが実行されるまで継続します。
- 通貨記号や数字区切り文字などの書式制御文字をすべてのフィールドから削除します。
- align、lowercase、および uppercase などのプロパティーで指定された必要なフォーマット設定を実行します。
- 日付/時刻フィールドをフォーマットします。
- すべてのフィールドの inputRequired プロパティーを検査します。
- すべてのフィールド内のデータが正しいタイプになっていることを検査します。例えば、数値フィールドでは英字は許可されません。
- 以下のいずれかのプロパティーで指定されたようにフィールドを順に検証します。
- isDecimalDigit
- isHexDigit
- minimumInput
- needsSOSI
- validValues
すべてのプロパティーがすべての UI テクノロジーで有効なわけではありません。
- フィールドを validatorDataTable と突き合わせて検査します (フィールドに指定されている場合)。
このイベント順序は、バリデーター関数でフィールド間のチェックが可能であり、このようなチェックでは有効なフィールド値を必要とするため、重要です。validationOrder プロパティーは、 EGL がフィールドを検証する順序にも影響します。
validatorFunction の値は関数の名前です。これはユーザーが作成する関数、または次のいずれかのシステム関数の場合があります。
この 2 つのシステム関数のうちのいずれかを指定すると、書式、ページ、または VGUIRecord がエラー・メッセージとともに再表示されます。エラー・メッセージは、validatorFunctionMsgKey プロパティーによって決定されます。
コーディングする関数に、以下の制約が適用されます。
- パラメーターは使用できません。
- 次のいずれかの方法でメッセージを指定します。
- メッセージを書式、ページ、または VGUIRecord に移動します。
- UI テクノロジーによって許可される場合は、converseLib.validationFailed() への引数としてメッセージ番号を指定します。
互換性
| データ項目 | JSF ハンドラー | VGUI レコード | コンソール UI | テキスト書式 Java™ | テキスト書式 COBOL | 印刷書式 Java | 印刷書式 COBOL |
|---|---|---|---|---|---|---|---|
| あり | あり | あり | なし | あり | あり | なし | なし |