第4章 Decision Central での DRL ルールの作成

手順

1. Decision Central で、Menu → Design → Projects に移動して、プロジェクト名をクリックします。
2. Add Asset → DRL file をクリックします。

3. 参考となる DRL ファイル 名を入力し、適切な パッケージ を選択します。指定するパッケージは、必要なデータオブジェクトが割り当てられている、またはこれから割り当てるパッケージにする必要があります。

   ドメイン固有言語 (DSL) アセットがプロジェクトに定義されている場合は、Show declared DSL sentences を選択することもできます。この DSL アセットは、DRL デザイナーで定義する条件およびアクションに使用できるオブジェクトです。

4. OK をクリックして、ルールアセットを作成します。

   新しい DRL ファイルが、Project Explorer の DRL パネルに追加されます。Show declared DSL sentences オプションを選択した場合は、DSLR パネルに追加されます。この DRL ファイルを割り当てたパッケージは、ファイルの上位にリストされます。

5. DRL デザイナーの左パネルの Fact types リストで、ルールに必要なすべてのデータオブジェクトとデータオブジェクトフィールドがリストされていることを確認します (それぞれを展開します)。リストされていない場合は、DRL ファイルの import 命令文を使用して、その他のパッケージから関連するデータオブジェクトをインポートするか、パッケージに データオブジェクトを作成 します。

6. データオブジェクトをすべて配置したら、DRL デザイナーの Model タブに戻り、以下のいずれかのコンポーネントで DRL ファイルを定義します。

   DRL ファイルのコンポーネント

   package  //automatic
   
   import
   
   function  //optional
   
   query  //optional
   
   declare   //optional
   
   rule
   
   rule
   
   ...

   • package: (自動) これは、DRL ファイルを作成し、パッケージを選択すると定義されます。

   • import: このパッケージ、または DRL ファイルで使用するその他のパッケージのデータオブジェクトを指定します。パッケージとデータオブジェクトを package.name.object.name 形式で指定し、1 行につき 1 つインポートします。

     データオブジェクトのインポート

     import mortgages.mortgages.LoanApplication;

   • function: (任意) DRL ファイルのルールが使用する関数を指定します。関数は、ルールのソースファイルにセマンティックコードを追加します。関数は、特に、ルールのアクション (then) 部分が繰り返し使用され、パラメーターだけがルールごとに異なる場合に便利です。DRL ファイルのルールで、関数を宣言したり、静的メソッドを関数としてインポートしたりして、ルールの アクション (then) 部分に、名前を指定して関数を使用します。

     ルールに関数を宣言して使用 (オプション 1)

     function String hello(String applicantName) {
         return "Hello " + applicantName + "!";
     }
     
     rule "Using a function"
       when
         eval( true )
       then
         System.out.println( hello( "James" ) );
     end

     ルールに関数をインポートして使用 (オプション 2)

     import function my.package.applicant.hello;
     
     rule "Using a function"
       when
         eval( true )
       then
         System.out.println( hello( "James" ) );
     end

   • query: (任意) DRL ファイルのルールに関連するファクトに対してデシジョンエンジンを検索するのに使用します。クエリーは、定義した条件セットを検索するため、when または then を指定する必要はありません。クエリー名は KIE ベースでグローバルとなるため、プロジェクトにあるその他のすべてのルールクエリーと重複しないようにする必要があります。クエリーの結果に戻るには、ksession.getQueryResults("name") を使用して、従来の QueryResults 定義を設定します ("name" はクエリー名)。これにより、クエリーの結果が返り、クエリーに一致したオブジェクトを取得できるようになります。DRL ファイルのルールに、クエリーと、クエリー結果パラメーターを定義します。

     ルールで、年齢が 21 歳未満の場合のクエリーと、その結果

     query "people under the age of 21"
         person : Person( age < 21 )
     end
     
     QueryResults results = ksession.getQueryResults( "people under the age of 21" );
     System.out.println( "we have " + results.size() + " people under the age  of 21" );
     
     rule "Underage"
       when
         application : LoanApplication( )
         Applicant( age < 21 )
       then
         application.setApproved( false );
         application.setExplanation( "Underage" );
     end

   • declare: (任意) DRL ファイルのルールが使用する新しいファクトタイプを宣言します。Red Hat Decision Manager の java.lang パッケージのデフォルトは Object ですが、必要に応じて DRL ファイルに別のタイプを宣言することもできます。DRL ファイルにファクトタイプを宣言すると、Java などの低級言語でモデルを作成せず、デシジョンエンジンに直接新しいファクトモデルを定義するようになります。

     新しいファクトタイプの宣言および使用

     declare Person
       name : String
       dateOfBirth : java.util.Date
       address : Address
     end
     
     rule "Using a declared type"
       when
         $p : Person( name == "James" )
       then   // Insert Mark, who is a customer of James.
         Person mark = new Person();
         mark.setName( "Mark" );
         insert( mark );
     end

   • rule: DRL ファイルで各ルールを定義します。ルールは、rule "name" 形式のルール名、ルールの動作 (salience、no-loop など) を定義する任意の属性、when および then 定義が続きます。同じパッケージでルール名を重複させることはできません。ルールの when 部分には、アクションを実行するのに必要な条件が含まれます。たとえば、銀行が、ローンの申し込みを 21 歳以上に限定した場合、Underage ルールの when 条件は Applicant( age < 21 ) になります。ルールの then 部分には、ルールの条件部分に一致したときに実行するアクションが含まれます。たとえば、ローンの申込者が 21 歳に満たない場合は、then アクションが setApproved( false ) になり、申込者の年齢条件を満たしていないためにローンの申し込みは承認されません。条件 (when) およびアクション (then) は、パッケージで利用可能なデータオブジェクトに基づいて、任意の制約、バインディングなどのサポートされる DRL 要素を持つ、定められている一連のファクトパターンで設定されます。このパターンは、定義したオブジェクトにルールがどのように影響するかを指定します。

     申込者の年齢制限に関するルール

     rule "Underage"
       salience 15
       dialect "mvel"
       when
         application : LoanApplication( )
         Applicant( age < 21 )
       then
         application.setApproved( false );
         application.setExplanation( "Underage" );
     end

     少なくても、各 DRL ファイルに package コンポーネント、import コンポーネント、rule コンポーネントを指定する必要があります。他のすべてのコンポーネントは任意です。

     図4.1 必要なコンポーネントおよび任意のルール属性を持つ DRL ファイルのサンプル

     
7. ルールのコンポーネントをすべて定義したら、DRL デザイナーの右上ツールバーで Validate をクリックし、DRL ファイルの妥当性を確認します。ファイルの妥当性確認に失敗したら、エラーメッセージに記載された問題に対応し、DRL ファイルの構文およびコンポーネントをすべて見直し、エラーが表示されなくなるまで再度、ファイルを検証します。
8. DRL デザイナーで Save をクリックして、設定した内容を保存します。