validatorFunction

validatorFunction プロパティー (以前の validator プロパティー) は、バリデーター関数を指定します。 バリデーター関数は、検証の第 2 ステージで実行されるロジックです。

最初のステージでは、EGL は、単一のフィールドについて以下のアクションを実行してから、次のフィールドに移動し、そのフィールドについてすべてのアクションを実行します。プロセスは、すべてのフィールドについてすべてのアクションが実行されるまで継続します。
  • 通貨記号や数字区切り文字などの書式制御文字をすべてのフィールドから削除します。
  • alignlowercase、および uppercase などのプロパティーで指定された必要なフォーマット設定を実行します。
  • 日付/時刻フィールドをフォーマットします。
  • すべてのフィールドの inputRequired プロパティーを検査します。
  • すべてのフィールド内のデータが正しいタイプになっていることを検査します。例えば、数値フィールドでは英字は許可されません。
  • 以下のいずれかのプロパティーで指定されたようにフィールドを順に検証します。
    • isDecimalDigit
    • isHexDigit
    • minimumInput
    • needsSOSI
    • validValues

    すべてのプロパティーがすべての UI テクノロジーで有効なわけではありません。

  • フィールドを validatorDataTable と突き合わせて検査します (フィールドに指定されている場合)。

このイベント順序は、バリデーター関数でフィールド間のチェックが可能であり、このようなチェックでは有効なフィールド値を必要とするため、重要です。validationOrder プロパティーは、 EGL がフィールドを検証する順序にも影響します。

validatorFunction の値は関数の名前です。これはユーザーが作成する関数、または次のいずれかのシステム関数の場合があります。

この 2 つのシステム関数のうちのいずれかを指定すると、書式、ページ、または VGUIRecord がエラー・メッセージとともに再表示されます。エラー・メッセージは、validatorFunctionMsgKey プロパティーによって決定されます。

コーディングする関数に、以下の制約が適用されます。
  • パラメーターは使用できません。
  • 次のいずれかの方法でメッセージを指定します。
    • メッセージを書式、ページ、または VGUIRecord に移動します。
    • UI テクノロジーによって許可される場合は、converseLib.validationFailed() への引数としてメッセージ番号を指定します。

互換性

表 1. validatorFunction プロパティーのサポート
データ項目 JSF ハンドラー VGUI レコード コンソール UI テキスト書式 Java™ テキスト書式 COBOL 印刷書式 Java 印刷書式 COBOL
あり あり あり なし あり あり なし なし