ビジネス・オブジェクトのフィールド・バリデータ

フィールドレベルの検証ルールは、任意のカスタム・フィールドに対して定義できる制約です。新しい値が送信されるたびに、対応するフィールドの値を評価するためにルールが使用されます。

フィールドレベルのルールは、適用されるルールが設定されている新しい値にのみ依存する場合に適しています。実行時にフィールドの値が保存される前に、フィールド検証ルールが実行されます。

ルールを定義する式またはスクリプトはブール値を返す必要があります。フィールドを検証するすべてのルールがtrueを返す場合、値が保存されます。いずれかのルールがfalseを返すと、失敗したルールのエラー・メッセージが表示され、新しい値は保存されません。たとえば、フォームに複数のフィールドがある場合、新しい値が保存される前に、すべてのフィールドの値がすべての検証ルールを通過する必要があります。

ビジネス・オブジェクトのフィールド検証ルールを作成するには:

新しいルールを追加するビジネス・オブジェクトを選択します。
ビジネス・オブジェクトの「Business Rules」タブを選択します。
「フィールドバリデータ」タブをクリックします。

ビジネス・オブジェクトに定義されているすべてのフィールドバリデータのリストが表示されます。

「図bo-field-validators.pngの説明」
「+新規フィールド・バリデータ」をクリックして、ルールを識別する名前、ルールが検証するフィールド、および検証が失敗した場合に表示されるエラー・メッセージを入力します。必要に応じて後でこれらを変更できます。
ダイアログ・ボックスで「フィールド・バリデータの作成」をクリックしてエディタを開きます。
エディタで入力し、パレットの値と関数を使用してルールを作成します。パレットを使用すると、ルールの作成に使用できるフィールド値および関数を追加できます。

パレットで関数または値の横にある矢印をクリックして、エディタの挿入カーソルの位置に挿入します。パレットで関数を選択すると、その関数の説明と、その使用方法の例がパレットに表示されます。ビジネス・オブジェクト用に作成したオブジェクト関数は、関数パレットにリストされます。

「図bo-field-validator-edit.pngの説明」

フィールド値パレットには、変数newValueとoldValueが含まれています。スクリプトでは、newValueを使用して、検証に成功した場合に割り当てられる新しい値を参照できます。既存のフィールド値を参照するには、oldValueを使用します。

オプションで、「タイムアウト上書き」フィールドに「デフォルトのGroovyタイムアウトを上書き」を指定できます。
「フィールドバリデータ」タブを再度クリックして、フィールドにルールを適用し、エディタを終了します。