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

オブジェクトレベルの検証ルールは、任意のカスタム・オブジェクトに対して定義できる制約です。ルールは、オブジェクトの送信が試行されたときにオブジェクトを評価するために使用されます。

検証で複数のフィールドの使用が必要な場合は、オブジェクトレベルのルールが適しています。オブジェクトレベル・ルールを使用する検証では、ユーザーが値を割り当てる順序に関係なく、ルールが一貫して適用されるようになります。

ルールを定義する式またはスクリプトは、オブジェクトが有効かどうかを示すブール値を返す必要があります。オブジェクトを検証するすべてのルールがtrueを返す場合、オブジェクトが保存されます。いずれかのルールがfalseを返すと、失敗したルールのエラー・メッセージが表示され、オブジェクトは保存されません。ルールがtrueを返せば、同じオブジェクトに対するその他すべてのオブジェクトレベル・ルールがtrueを返すかぎり、オブジェクトの検証は成功します。たとえば、フォームで1つのフィールドの値を指定するために、別のフィールドに値を割り当てる必要がある場合(「Priority」フィールドで「High」を選択するために、「Assignee」フィールドに名前を入力する必要がある場合など)、このタイプの検証が必要です。

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

ルールを作成するビジネス・オブジェクトを選択します。
ビジネス・オブジェクトの「Business Rules」タブを選択します。
「オブジェクトバリデータ」タブをクリックします。

「図bo-object-validators.pngの説明」

ビジネス・オブジェクトに対して定義されているすべてのオブジェクト・バリデータのリストが表示されます。
「+新しいオブジェクトバリデータ」をクリックし、ルールを識別するバリデータ名を入力し、検証が失敗した場合に表示されるエラー・メッセージを入力します。

オプションで、「タイムアウト上書き」フィールドに「デフォルトのGroovyタイムアウトを上書き」を指定できます。

必要に応じて、これらのすべてを変更できます。
ダイアログ・ボックスで「オブジェクト・バリデータの作成」をクリックしてエディタを開きます。
エディタで入力し、パレットのビジネス・オブジェクトのフィールドと関数を使用してルールを作成します。パレットを使用すると、ルールの作成に使用できるフィールドおよび関数を追加できます。

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