第7章 ルールの記述

アセットエディターはアセットに関する情報へのアクセスを提供し、ユーザーはこのエディターを使ってアセットを編集することができます。

エディターには、Editor、Overview、Source、および Data Objects タブが含まれます。

図7.1 ガイド付きデシジョンテーブル - Editor タブ

図7.2 ガイド付きデシジョンテーブル - Overview タブ

図7.3 ガイド付きデシジョンテーブル - Source タブ

図7.4 ガイド付きデシジョンテーブル - Data Objects タブ

ビジネスルールはガイド付きルールエディターで編集します。ガイド付きルールエディターは、編集中のルールのオブジェクトモデルに基づいてユーザーに入力を求めるプロンプトを出します。

別のパッケージに属するルールで使用されるアセットはルールにインポートする必要があります。同じパッケージのアセットはデフォルトでインポートされます。Data Objects タブでインポートを定義します。

例7.1 ガイド付きルールエディター

ガイド付きルールエディターは、When と Then の部分で構成されます。Then の部分には、(show options…​) リンクがあり、ここから ruleflow-group、salience などの追加のルール属性を設定できます。ガイド付きルールエディターについての詳細は、「ガイド付きルールテンプレート」 を参照してください。

図7.5 ルール属性

ルールの作成および変更時に、package-names-white-list というファイルを使用して利用可能なファクトを絞り込むことができます。このファイルを使用すると、読み込み済みで表示されるファクトのグループを絞り込むことができます。これは、新規ルールの作成中にこれらのファクトの読み込みを加速させるのに役立ちます。

ルートディレクトリーに新規プロジェクトを作成すると、空の package-names-white-list ファイルが pom.xml および project.imports プロジェクトファイルと共に自動作成されます。既存プロジェクトについては、package-names-white-list ファイルを手動で作成します。Business Central では、Project Explorer のプロジェクトのリポジトリービューでファイルを表示できます。

デフォルト (ファイルが空の状態) で、プロジェクトの依存関係からのファクトは制限される一方で、プロジェクト自体にあるすべてのファクトは表示されます。

パッケージを定義するためのルール

package-names-white-list ファイルは、各行に単一のパッケージ名を受け入れるテキストファイルです。パッケージには、ワイルドカードなどが含まれる場合があります。

適切なエントリーを package-names-white-list ファイルに追加することで、依存関係からの特定のパッケージを組み込むことができます。詳細は、「依存関係の追加」を参照してください。

ルールは複数の部分で構成されます。

ガイド付きルールエディターを使うと、ルールの When (条件) 部分に条件を追加し、Then (アクション) 部分にアクションを追加することができます。たとえば、ローン申請の際に 21歳未満の申請者に保証人がいる場合、銀行がそのローン申請を承認するか決定することができます。

ルールごとに Salience の値をもたせることができます。Salience には整数の値が入り、デフォルトは 0 となっています。Salience の値は、ルールの優先順位を表しており、値が高いと優先順位が高くなります。Salience 値は、正負どちらでも利用できます。

ガイド付きルールエディターを使うと、ルールの When (条件) 部分に条件を追加し、Then (アクション) 部分にアクションを追加することができます。例えば、ローン申請の際に 21歳未満の申請者に保証人がいる場合、銀行がそのローン申請を承認するか決定することができます。

保証人を条件に追加するには、まず guarantor フィールドを、担保モデルの申請ファクトタイプ (Business Central のデータオブジェクト) に追加します。フィールドをファクトタイプに追加する方法については、「データモデラー」 を参照してください。

保証人フィールドに申請者のファクトタイプが追加されたため、ルールを変更し、保証人を条件として含めることができます。

テクニカルルール (DRL) はテキストとして保存され、これらのルールは JBoss Enterprise BRMS ユーザーインターフェースで管理されます。DRL ファイルには、1 つ以上のルールが含めることができます。ルールの条件とアクション部分は、それぞれ「when」と「then」になります。

Red Hat JBoss Developer Studio には、DRL ファイルの作成、編集、デバッグのツールが含まれており、これらはそれぞれの目的に合わせて使用できます。ただし、DRL ルールは Red Hat JBoss Enterprise BRMS ユーザーインターフェースで管理することができます。DRL エディターは Java、DRL および XML の構文強調表示を行います。

rule "approval"
  salience 100 // This can short-circuit any processing.
  when
    a : Approve()
    p : Policy()
  then
    p.setApproved(true);
    System.out.println("APPROVED:" + a.getReason());
end

ルールは、スプレッドシートのデシジョンテーブルに保存できます。スプレッドシートの各行はルールで、各列は条件、アクション、オプションのいずれかになります。『Red Hat JBoss BPM Suite Development Guide』では、デシジョンテーブルの使用方法の詳細が説明されています。

アップロードされたスプレッドシートをガイド付きデシジョンテーブルに変換するには、以下を実行します。

ここでは、注文されたアイテムの配送料金を記載するオンラインショッピングサイトの簡単な例について見てみましょう。このサイトでは、以下の条件に基づいて配送料を無料とすることに同意しています。

記載される配送料金は以下のようになります。

上記の条件はスプレッドシートでは以下のように表されます。

(web ベースの) ガイド付きデシジョンテーブル機能は、どのファクトやフィールドを利用すればデシジョンテーブル作成に役立つかを確認する点で、ガイド付きエディターのように機能します。

ルール属性、メタデータ、条件、アクションは、表形式で定義可能で、関連ルールの多くをすばやく入力できるようにします。Web ベースのデシジョンテーブルのルールは他のルールアセットと同様に、DRL にコンパイルされます。

新規デシジョンテーブルを作成するには、New Item Guided Decision Table をクリックします。表の名前を入力し、拡張エントリーまたは制限エントリー表のどちらかを選択します (「デシジョンテーブルのタイプ」)。オプションで、ガイド付きデシジョンテーブルウィザードを使用するよう選択します。

終了したら、OK をクリックします。ウィザードを選択しない場合は、ガイド付きデシジョンテーブルのエディターが表示されます。ウィザードを選択した場合、ウィザードの最初の画面が表示されます。

ウィザードでは、インポート、ファクト、パターンおよび列を定義することができますが、行は定義できません。行はガイド付きデシジョンテーブルエディターに追加され、これはウィザードの終わり (またはウィザードを使用しない場合は直接) 表示されます。

ガイド付きデシジョンテーブルで構成される独自のアプリケーションをビルドする場合、クラスパスに必要な依存関係が追加されていることを確認してください。ガイド付きデシジョンテーブルの依存関係についての詳細は、『Red Hat JBoss BPM Suite Development Guide』の「Dependency Management for Guided Decision Tables, Scorecards, and Rule Templates」セクションを参照してください。

大別すると、以下の 2 つのタイプのデシジョンテーブルがサポートされています。

列の制限についての説明は、「条件列」 を参照してください。

デフォルト値を設定することはできますが、通常セルに値が入っていない場合は、その制約は適用されません。

図7.6 列の設定

ガイド付きデシジョンテーブルエディター内に列を追加するには、 アイコンをクリックします。

以下の列タイプの選択ダイアログが表示されます。

図7.7 詳細の列オプション

デフォルトで、列タイプのダイアログに以下のタイプが表示されます。

「Include advanced options (詳細オプションの組み込み)」をクリックすると、以下のオプションが追加されます。

ルールは、定義済みの列を使用してデシジョンテーブルの本体に作成されます。

ルールの行は + のマークをクリックして追加するか、または - のマークをクリックして削除できます。

図7.22 ルール定義

デシジョンテーブルの左上にあるアイコンでセルの統合をオンまたはオフにすることができます。セルの統合時に、同じ列に同じ値を持つセルがある場合は 1 つのセルに統合されます。これにより、元の値が同じであった複数のセルの値を簡単に変更できるようになります。セルを統合するとセルの左上にアイコンが現れ、複数のセルにわたる列をグループ化することができます。

図7.23 セルの統合

統合したセルをさらに１つの行に折りたたむことが可能です。統合したセルの左上にある [+\-] アイコンをクリックすることで、該当の列を１つのエントリーに折りたたみます。他の列にあるセルで、折りたたまれた列にまたがり、同じ値を持つ場合は表示の変更はありません。しかし、他の列にあるセルで、折りたたまれた行にまたがり、別の値を持つ場合は、ハイライトされ、最初の値が表示されます。

図7.24 セルのグループ化

グループ化されたセルの値が変更された場合、折りたたまれたセルの値もすべて更新されます。

等価演算子 == あるいは、非等価演算子 != を使うリテラル値で定義した条件列は、デシジョンテーブルの特別なセル値である otherwise を活用できます。この特別な値により、表で定義されている他のルールには明示的に定義されていない値すべてにマッチするようにルールを定義することができます。以下の例が最もわかりやすいでしょう。

when
  Cheese( name not in ("Cheddar", "Edam", "Brie") )
  ...
then
  ...
end

when
  Cheese( name in ("Cheddar", "Edam", "Brie") )
  ...
then
  ...
end

otherwise キーワードを使用するには、以下を実行します。

ルールテンプレートを使用すると、ルール構造を定義することができます。値やデータのプレースホルダーがあり、テンプレートにデータを設定して数多くのルールが生成されます。ユーザーから見ると、ガイド付きルールテンプレートは、パラメーター値を提供するデータ表を含む、パラメーター化されたガイド付きルールです。テンプレートにより、より柔軟性のあるデシジョンテーブルを作成でき、既存データベースのルールに柔軟性を増し加えることができます。ルールテンプレートの依存関係の管理についての詳細は、『Red Hat JBoss BPM Suite Development Guide』の「Dependency Management for Guided Decision Tables, Scorecards, and Rule Templates」セクションを参照してください。

図7.25 ガイド付きテンプレートエディター

Business Central のガイド付きルールテンプレートでは、データとルールを切り離した状態でルールテンプレートを設定できます。

「データオブジェクトの作成」 で説明されているようにプロジェクトのデータモデルがすでに設定されていることを確認します。

ルールの THEN セクションは、WHEN セクションに一致する際に実行されるアクションを保持します。

データ表は、定義するガイド付きルールテンプレートの変数を提供します。設定に基づいて数多くのルールが生成されます。Data タブをクリックすることで、データ表はガイド付きテンプレートエディター内で変更できます。以下の例を考慮してみましょう。

電話サービス、インターネットサービスおよび TV サービスを提供する会社があるとします。毎月の金額は顧客が使用するアクティブなサービスによって異なります。この場合、テンプレートは以下のようになります。

ルールを設定するには、以下を実行します。

データ列挙はオプションのアセットタイプですが、ガイド付きデシジョンテーブルエディターにドロップダウンリストを付けるために設定できます。セルの条件が列挙と同じファクトおよびフィールドに基づく場合は、セルをダブルクリックして列挙のドロップダウンリストを表示します。

これらは、他のアセットと同様に保存、編集され、これらが作成されたパッケージに対してのみ適用されます。

列挙設定の内容は、fact.field を値の一覧にマッピングします。これらの値は、ドロップダウンメニューを設定するために使用されます。この一覧は、Literal あるいは Utility クラス (クラスパスに追加する必要あり) を用いて文字列を読み込みます。この文字列には、ドロップダウンメニューに表示する値か、コード値からのマッピング (ルールで利用されるもの) と表示値 (例: M=Mini) のいずれかが含まれています。

例7.2 列挙の設定例

'Board.type' : [ 'Short', 'Long', 'M=Mini', 'Boogie']
'Person.age' : [ '20', '25', '30', '35' ]

これは、以下のように Business Central で設定することもできます。

ドロップダウンのリストはフィールドの値により変化します。列挙があると、他のフィールドの値を基に複数のオプションを定義することができます。

たとえば、保険契約のファクトモデルには、policyType と coverage のフィールドで構成される保険と呼ばれるクラスが含まれます。policyType の選択肢として、Home または Car などが考えられます。また、保険契約の種類により、利用可能な補償タイプなどが決まります。住宅保険契約には property または liability が、車両保険契約には collision または fullCoverage など入る可能性があります。

policyType のフィールド値は、補償にはどのオプションを表示するかを決定しますが、以下のように表現されます。

 'Insurance.policyType' : ['Home', 'Car']
 'Insurance.coverage[policyType=Home]' : ['property', 'liability']
 'Insurance.coverage[policyType=Car]' : ['collision', 'fullCoverage']

外部ソースから文字列の一覧を取得して、列挙メニューで使用することができます。これは、(文字列の) java.util.List を返すクラスパスにコードを追加することで可能になります。ユーザーインターフェースで値の一覧を指定する代わりに、コードは文字列一覧を返します (通常、ルールの値と異なる表示値を使用したい場合は文字列の内側に "=" 記号を使用できます)。たとえば、以下を使用することができます。

'Person.age' : ['20','25', '30', '35']

上記の行を以下のように変更します。

'Person.age' : (new com.yourco.DataHelper()).getListOfAges()

これは、DataHelper と呼ばれるクラスを持ち、このクラスには、getListOfAges() というメソッドがあり、このメソッドで文字列一覧を返すことが想定されます。データ列挙は、セッションで初めてガイド付きエディターを使用する際に読み込まれます。列挙が読み込まれたかどうかを確認するには、パッケージ設定画面に移動します。パッケージの「保存と検証」を行うことができ、これによりパッケージのチェックを行い、エラーなどのフィードバックが提供されます。

スコアカードはリスク管理ツールであり、スコア全体を計算するために使用される数式のグラフィック表示です。ほとんど場合、これは金融機関や銀行によって、商品を市場で販売することに関するリスクを計算するために使用されます。そのため、特定の結果が生じる可能性または確率を予想するために使用できます。Red Hat JBoss BRMS は、個別のルール条件に割り当てられる部分的なスコアを加算してスコア全体を計算する付加的なスコアカードをサポートしています。

さらに、Drools スコアカードでは理由コードの設定が可能であり、これによりスコア全体に影響を与えた特定ルール (バケット) を特定できます。Drools スコアカードは PMML 4.1 標準に基づいています。

通常、スコアカードは以下のように作成できます。

この詳細の説明として、以下の例を見てみましょう。

図7.34 スコアカードサンプル

ガイド付きスコアカードで構成される独自のアプリケーションをビルドする場合、クラスパスに必要な依存関係が追加されていることを確認してください。ガイド付きデシジョンテーブルの依存関係についての詳細は、『Red Hat JBoss BPM Suite Development Guide』の「Dependency Management for Guided Decision Tables, Scorecards, and Rule Templates」セクションを参照してください。

Business Central の確認および検証機能は、ガイド付きデシジョンテーブルを完成し、エラーがない状態にするのに役立ちます。この機能は、ガイド付きデシジョンテーブルのロジックにギャップがあるかどうかをチェックし、異なるセル間の関係を検証します。Business Central の確認および検証機能で報告される問題のほとんどは、作成者のロジックのギャップについてです。確認および検証機能は、この確認および検証通知を無視することを選択した場合でも作業の保存を防ぐことはありません。

ガイド付きデシジョンテーブルを編集する場合、この確認および検証機能は操作を誤った場合に通知を送信します。たとえば、ガイド付きデシジョンテーブルの行にアクションを設定するのを忘れた場合や、重複した行がある場合には、新規パネルの Analysis がこれらの問題についての通知と共に Business Central に開かれます。Analysis パネルはガイド付きデシジョンテーブルで見つかる問題の一覧を表示し、それぞれの項目は影響を受けるガイド付きデシジョンテーブルの行をポイントします。問題の一覧から項目を選択すると、問題のさらに詳細な説明を参照することができます。

検証および確認機能は、以下の問題の解決に役立ちます。

Business Central の確認および検証機能は、ガイド付きデシジョンテーブルの更新中に Analysis パネルで異なるレベルの問題をレポートします。

Business Central のデシジョンテーブルの確認および検証機能はデフォルトで有効にされています。これは、org.kie.verification.disable-dtable-realtime-verification システムプロパティー値を true に設定することで無効にできます。

たとえば、JBoss EAP をアプリケーションサーバーとして使用している場合、$EAP_HOME ディレクトリーに移動して以下のコマンドを実行します。

./standalone.sh -Dorg.kie.verification.disable-dtable-realtime-verification=true

または、このプロパティーを standalone.xml ファイルで設定します。

<property name="org.kie.verification.disable-dtable-realtime-verification" value="true"/>