アプリケーション・ナビゲータで、「 Emp」エンティティをダブルクリックして、 Entity Object Editorを開きます。

「 Attributes」タブをクリックしてAttributesページに進み、 追加ボタン「 」をクリックして TotalCompという名前の新しい一時属性を NumberというTypeで作成します。

「 Persistent」チェック・ボックスの選択を解除して、属性のUpdatableプロパティに「 Never」を選択します。

「 OK」をクリックします。 次に、 TotalComp属性をダブルクリックしてエディタを起動し、計算を指定します。

Attribute Editorダイアログ・ボックスの Value Typeラジオ・グループで、 Expressionラジオ・ボタンが選択されていることを確認します。 Valueフィールドに、次の計算式を入力します。

(Salary!=null?Salary:0)+(Salary*(CommissionPct!=null?CommissionPct:0))

この計算式は、Salaryの値がNullまたはゼロでない限り、その値を返すブール型の条件（Salary!=null）をテストする3項演算子を使用しています。 この計算式は、次にCommisionPctの値について同様の計算をおこない、Salaryで乗算して両方の計算の合計を返します。

エディタを終了しないでください。

属性の定義を完了するには、Attribute Editorの Dependenciesページに進み、 Salaryおよび CommissionPct属性をSelectedペインに移動します。

「 OK」をクリックして変更を保存し、すべての作業を保存します。

アプリケーション・ナビゲータで、「 EmpView」をダブルクリックします。 エディタで、「 Attributes」タブを選択して、「 Add from Entity...」ボタンをクリックします。

Availableペインの「 TotalComp」を選択して、Selectedペインに移動します。 「 OK」をクリックします。

変更をテストするには、アプリケーション・ナビゲータの「 AppModule」アプリケーション・モジュールを右クリックして、表示されたメニューから「 Run」を選択します。

Business Components Browser - Connectダイアログ・ボックスが表示されたら、「 Connect」をクリックします。 「 EmpView1」オブジェクト・インスタンスをダブルクリックして、Commission Percentageを含むレコードに進み、計算を表示します。 歩合割合（CommissionPct）を変更した場合は、レコードのほかの項目に移動すると、給与の総額（TotalComp)が変更されます。

Business Component Browserを閉じます。

この例では、Key Exists検証ルールをModelプロジェクトのEmpエンティティに追加します。

アプリケーション・ナビゲータで、「 Emp」エンティティをダブルクリックして、エディタで開きます。 「 Validators」タブを選択し、「 Entity」ノードを選択します。ページの見出しのValidatorsの右側にある 追加ボタン「 」をクリックします。

Add Validation Ruleダイアログ・ボックスで、Rule Typeリストから「 Key Exists」を選択します。 Rule DefinitionタブのAssociation Nameフィールドに EmpDeptFkAssocが選択されていることも確認します。 この選択は、検証する外部キー関係を表すDeptおよびEmpエンティティ・オブジェクト間の1対多の関連を示します。

次に、「 Failure Handling」タブをクリックし、Message Textボックスに Department does not exist というエラー・メッセージを入力します。 「 OK」をクリックして、新しい検証ルールを定義します。

エディタに検証ルールが表示されます。

すべての変更を保存します。

先ほど作成したEmpViewから、LOVを削除します。

エディタで EmpViewビュー・オブジェクトを起動し、 Attributesタブで「 DepartmentId」属性を選択します。 List of Values: DepartmentIdフィールドの左側にあるプラス記号をクリックして開きます。 「 LOV_DepartmentId」を選択し、赤色の「 X」をクリックしてLOVを削除します。

すべての変更を保存します。

再度 AppModuleを実行し、既存の従業員のDepartmentIdの値を任意の2桁の無効な数値（ 99など）に変更します。 コミットするか、別の行に移動すると、例外が発生してカスタム・エラー・メッセージが表示されます。

アプリケーション・ナビゲータで、「 Emp」エンティティをダブルクリックして、エディタで開きます。 「 Validators」タブをクリックし、「 Entity」ノードを選択します。ページの右側にある 追加ボタン「 」をクリックします。

Add Validation Ruleダイアログ・ボックスで、Rule Typeリストから「 Compare」を選択します。

Rule Definitionタブで、Attributeリストから「 CommissionPct」、Operatorリストから「 LessThan」を選択します。 Compare Withリストから「 Literal Value」を選択し、下のLiteral Valueボックスに .5 を入力します。

この手順では、検証ルールの基本的な比較を設定します。 次に、 Validation ExecutionタブのConditional Execution Expressionフィールドに、
Salary!=null && CommissionPct!=null
という計算式を入力します。 このフィールドでは、特定の条件に当てはまる場合にだけルールが適用されます。 式は大文字と小文字を区別するので、CommissionPctと入力し、commissionpctとは入力しないでください。
次に、 Triggering Attributesセクションに移動し、Available Attributesリストから「 Salary」を選択し、 追加ボタン「 」をクリックして Salaryと CommissionPctをSelected Attributesリストに移動します。 実行時に、このリストの属性の値が変更されると、ルールは再評価されます。

Failure Handlingタブに移動し、 Message Textボックスに次の検証エラー・メッセージを入力します。

The {attr1} of {val} must be less than 50%

2つのメッセージ式が中かっこ内にあることを確認します。

以下のToken Message Expressions表の「 attr1」トークンの行をクリックし、その行の「 Expression」セルをダブルクリックします。 source.hints.CommissionPct.label という式を入力し、検証するソース・エンティティ・オブジェクトのCommissionPct属性の使いやすい表示ラベルの値を参照します。

同様に、 val トークンに CommissionPctという式を入力して、CommissionPct属性の値を参照します。

こうしたメッセージ式は、前述の例の計算属性と同様に、Groovy構文を使用します。 これは非常にシンプルな式ですが、開発者が必要な場合にGroovyを最大限に活用できるという点を理解するのに重要です。 「 OK」をクリックして、新しい検証ルールを定義します。

「 OK」をクリックして、検証ルールを保存します。 すべての作業を保存します。

再度 AppModuleページを実行して、ルールをテストします。 既存の従業員の歩合に、 .7 という値を入力してみます。 コミットすると、 The CommissionPct of .7 must be less than 50%というパラメータ化されたエラー・メッセージが表示されます。

歩合のない従業員の給与の値を変更した場合は、CommissionPctの値がNullのため、例外が発生しないことが確認できます。 従業員の給与を既存の歩合未満の値に変更して、トリガー属性が正しく機能することを確認します。

この項では、Deptエンティティ・オブジェクトから値を参照する検証ルールを作成します。 そのためには、EmpおよびDeptエンティティ・オブジェクト間の関連のアクセッサを使用する必要があります。 式を作成する前に、アクセッサ名を確認します。

アプリケーション・ナビゲータで、「 EmpDeptFkAssoc」をダブルクリックし、「 Relationship」タブを選択します。 Accessorsのプラス記号を開きます。 この例では、アクセッサ名をDept1とし、この名前はGroovy式で使用します。 使用する名前が異なっていても問題ありませんが、その場合は名前をメモしてコードを変更し、コード例の Dept1の代わりにそのコードを使用してください。

クリックして Empの エンティティ・オブジェクト・エディタに戻って、「 Validators」タブを選択します。次に、「 Entity」ノードを選択して、再度「 Create new validator」ボタンをクリックします。

Add Validation Ruleダイアログ・ボックスで、「 Rule Type」リストをクリックし、下方向にスクロールして「 Script Expression」を選択します。

Rule Definitionタブで、次の式を入力します。

if (Dept1?.DepartmentName?.toUpperCase()?.endsWith("S")
&& Salary % 5 != 0) {
return false;
}
return true;

IF文のブール式は、検証する現在のEmpオブジェクトのDepartmentIdを参照して、関連するDeptエンティティ・オブジェクトにアクセスします（オブジェクトが存在する場合）。 この場合、従業員の部門関連のデフォルト名はDept1となります。 この名前は、Accessorセクションの EmpDeptFkAssocオブジェクトの定義で確認できます。 通常、ビジネスを表すにはすべての関連した名前を変更する必要があります（EmpWorkingInDeptなど）。 このOBEでは、すべてのオブジェクトのデフォルト名を使用します。

次に、Dept1関連の最後に表示されるDepartmentName属性を参照し、それを大文字に変換して大文字小文字を区別しない比較をおこないます。そして、StringクラスのendsWith()メソッドを使用してDepartmentNameがsで終わるかどうかをテストします。

手順1のアクセッサ名がDept1とは異なっている場合、Dept1があるコードの最初の行の名前と置き換えます。

Dept1.DepartmentName.toUpperCase().endsWith()と記述する代わりに、通常のドット演算子をGroovyの安全なナビゲーション演算子"?."に置き換えます。 この演算子は、ドット演算子と同様に機能して、オブジェクトからそのオブジェクトのプロパティにナビゲーションします。

ただし、左側の値がNullの場合、Groovy演算子はNullPointerExceptionをスローせず、結果はNullとなります。 NullがGroovyでブール値として発生した場合は、結果がfalseとなるため、?.演算子を使用して多数の式をよりコンパクトにできます。 この最初のチェック実行後、前述の式に整数モジュロ演算子（%）を使用して、給与が5の倍数であるかどうかをテストします。

部門名が's'で終わっているのに給与が5の倍数でない場合、falseが返されルールは失敗します。 そうでない場合はtrueが返されます。

「 Failure Handling」タブをクリックします。

Groovy検証ルールは条件付きでさまざまな例外の1つを発生させることができるため、このタブに複数のエラー・メッセージを追加できます。 選択したメッセージは、検証ルールがfalseを返す場合に使用されます。

メッセージを追加するには、Existing Messageボタン（虫メガネ）をクリックします。

Select Text Resourceダイアログ・ボックスで、Keyフィールドに次の値を入力します。

IF_DEPARTMENT_NAME_ENDS_IN_S

次に、Valueフィールドに次のエラー・メッセージを入力します。

If department name ends in S the salary must be multiple of five.

Descriptionフィールドにもこのメッセージを入力します。

次に、「 Save and Select」をクリックし、「 OK」をクリックして、新しい検証ルールを定義します。

すべての変更を保存します。

EmpViewに戻って、DepartmentIdのLOVを再設定します。

「 Attributes」フィンガーをクリックして、属性の詳細ページを表示します。 「 DepartmentId」属性を選択し、List of Values: DepartmentIdフィールドの緑色のプラス記号をクリックして値リストを追加します。

List of Valuesダイアログ・ボックスで、List Data Sourceフィールドの矢印をクリックして、リストから「 DeptView1」を選択します。 List Attributeフィールドの矢印をクリックして、「 DepartmentId」を選択します。 List Return Valuesセクションが更新され、ユーザーがリストから選択した際に、List Data Sourceの属性がベースのビュー・オブジェクトの属性にどのように割り当てられるかが表示されます。

List of Valuesダイアログ・ボックスを閉じる前に、「 UI Hints」タブをクリックして、UI Hintsダイアログ・ボックスを開きます。 この設定では、ユーザー・インタフェース内でのリストの表示方法を定義する情報が提供されます。 デフォルトのリスト・タイプは、Choice List表示スタイルを示しています。 この簡単な例ではデフォルトのリスト・タイプを使用しますが、このリストをクリックすると、アプリケーションで使用できる別のタイプのリスト・コントロールが表示されます。

前と同様に、Display Attributesセクションで、Availableリストから「 DepartmentName」属性を選択し、 追加ボタン「 」をクリックして、Selectedリストに追加します。 この選択は、リストには部門番号ではなく部門名を表示することを示します。 「 OK」をクリックしてUI Hintsダイアログ・ボックスを閉じ、再度「 OK」をクリックしてList of Valuesダイアログ・ボックスを閉じます。

再度 AppModuleを実行し、部門 30（SALES）または 40（OPERATIONS）の従業員に、" 1"で終わる給与を入力します。 その変更をコミットします。 部門名がsで終わっているのに従業員の給与が5の倍数でないため、アプリケーションで検証エラーが発生します。

EmpViewビューでは、特定の部門番号で従業員を検索できる名前付き問合せのフィルタ条件が必要です。

「 EmpView」ビュー・オブジェクトをダブルクリックして、「 Query」タブを選択します。 下方向にスクロールして、 View Criteriaセクションの緑色のプラス記号をクリックします。

Create View Criteriaダイアログ・ボックスで、名前を EmployeesByDepartmentに変更して、「 Add Item」ボタンをクリックます。

Criteria Itemセクションで、Attributeを DepartmentId、OperatorをGreater than or equal to、OperandをBind Variableに設定します。 次に、Parameterフィールドの横の「 New」ボタンをクリックして、バインド変数を指定します。

Bind Variableウィンドウで、名前を DepartmentNumberに変更し、Typeを Numberに設定します。 「 OK」をクリックして、バインド変数を作成します。

Optionsセクションで、Usageを Requiredに設定します。

バインド変数の定義が作成され、同じQueryタブに表示されていることを確認します。 サービスの作成プロセスの実行中に名前付き問合せが使用されます。 実行された名前付き問合せは次のようになります。

「 OK」をクリックて、すべての作業を保存します。

名前付き問合せをテストします。 テスターのアプリケーション・モジュールを実行します。

テスターが起動されたら、「 EmpsView1」ノードをダブルクリックします。 データ・ペインで、「 Specify View Critera」ボタン（右から2番目のボタン）をクリックします。

名前付きの基準（ EmpViewCriteria）をSelected側に移動して、「 Find」ボタンをクリックします。

Bind Variablesダイアログで、Valueフィールドに 70などの数値を入力して、「 OK」をクリックします。 テスターに返される結果レコードには、バインド変数プロパティに入力された値またはそれよりも大きい値のみ反映されます。