ルールの操作

if 節と else 節について

ルールには 1 つ以上の if 節と 1 つの else 節を含めることができます。各節には、assign や return などのアクションを含めることができます。

if 節のロジックを実行できるのは、節に関連付けられている condition プロパティが真の場合のみです。else 節のロジックを実行できるのは、前の if 節に関連付けられているいずれの condition プロパティも真でない場合のみです。ルールに複数の if 節が含まれる場合、節に関連付けられている condition プロパティが真である、最初の if 節のロジックのみが実行されます。条件の詳細は、"If 節の条件プロパティの編集" を参照してください。

ルールを開発する際は、以下の点に留意してください。

• ルール・セットの実行で return アクションが検出されると、ルール・セットの実行は終了し、そのルール定義クラスを呼び出したビジネス・プロセスに戻ります。

• return を省略することによって、ルール・セット内の複数のルールの実行を制御できます。つまり、すべてのルールをチェックする必要がある場合は、どのルール節でも return アクションを使用しないようにします。そして、どのルール節も真として評価されなかった場合のために、ルール・セットの最後に return アクションで値を提供します。

• if 節ごとに条件プロパティを 1 つ指定します。汎用ビジネス・ルール・セットの一般的な設計は、一連の if 条件で構成されるルールを 1 つ組み込み、どの条件が真であるかに応じて値を返す、というものです。どの条件も真でない場合にデフォルト値を返すには、else 節を return と共に使用します。

• ルーティング・ルール・セットの一般的な設計は、複数のルールを使用してルールごとに異なる制約を定義し、制約に一致したメッセージのルーティング方法とルーティング先を示す if 節を各ルールに 1 つ組み込むというものです。

• "仮想プロパティ・パスの基本設定" に説明されている構文を使用して、仮想ドキュメントのプロパティ・パスにアクセスできます。

アクションについて

ルールの各 if 節または else 節にはアクションを含めることができますが、必須ではありません。節のアクションが実行されるのは、節に関連付けられている条件が真の場合かつその場合のみです。以下のアクションがサポートされています。

論理的に適切で、意図したとおりに実行されるようにルール・セットを構築する必要があります。例えば、既定の返り値を設定することは、ルール・セット内のどのルールも実行されない場合には意味がありますが、1 つのルールが常に実行されるようなルール・セットを作成した場合には意味がありません。一般に、ほとんどのアクションは、ルールの if 節にあります。

式の定義

式を使用して、以下の 4 つのプロパティの値を変更できます。

• if 節の condition プロパティ — if 節でロジックを実行する条件を指定します。詳細は、"If 節の条件プロパティの編集" を参照してください。

• assign アクションの value プロパティ — 割り当てる値を指定します。

• 汎用ビジネス・ルールの return アクションの value プロパティ — ルール・セットを実行したプロセスに返す値を指定します。

• trace アクションの value プロパティ — トレース・メッセージに含めるテキストを指定します。リテラル・テキスト文字列または評価対象となる式を指定できます。式は、対応する <process> 要素の language 属性で指定されているスクリプト言語を使用する必要があります。

各プロパティを、以下のいずれかのサポートされている値に設定できます。

• 数値 (整数または小数)。1.1 や 23000 など。

• 二重引用符で囲まれた文字列値。例 ：

  "NY"

  Important:

  二重引用符は必須です。

• コンテキスト・プロパティの値。BPL ビジネス・プロセスには、context と呼ばれる汎用の永続変数を含めることができることを思い出してください。context 変数は、BPL の <context> 要素および <property> 要素を使用して定義します。context オブジェクトのプロパティには、ビジネス・プロセス内の任意の場所からアクセスできます。したがって、<rule> 要素を使用してビジネス・プロセスからルールを呼び出した場合、そのルール内からコンテキスト・プロパティにアクセスできます。

  リストや配列などのコレクションが含まれるコンテキスト・プロパティの場合、InterSystems IRIS では、ビジネス・ルール内からさまざまな取得メソッドをサポートします。それらのメソッドとしては、Count()、Find()、GetAt()、GetNext()、GetPrevious()、IsDefined()、Next()、Previous() などがあります。詳細は、"コレクションを使用した作業" を参照してください。

  Note:

  プロパティ名では大文字と小文字が区別され、引用符で囲むことはできません (例 ： PlaceOfBirth)。

• サポートされている演算子、リテラル値、汎用のプロパティ、および永続変数 context を使用する式。以下に例を示します。

  ((2+2)*5)/154.3
  "hello" & "world"
  Age * 4
  (((x=1) || (x=3)) && (y=2))
  

• Min()、Max()、Round(n,m)、SubString() などの組み込み関数。関数名にはかっこが含まれている必要があります。また、Round の数値 n や m などの入力パラメータも含める必要があります。関数に入力値がない場合は、中身が空の左右のかっこを含める必要があります。

• メッセージ・オブジェクトを表す Document 変数。

• foreach アクション内のセグメント。詳細は、"アクションについて" を参照してください。

詳細は、"式の例" を参照してください。

If 節の条件プロパティの編集

ルール定義では、1 つの条件は 2 つの値とこれらの値間の比較演算子で構成されます。以下に例を示します。

Amount  <=  5000

条件が真でない場合は、偽となります。条件プロパティにはその他の可能な値はありません。真または偽のみの結果を、ブーリアン値の結果と呼びます。InterSystems IRIS では、ブーリアン値の結果を整数値として格納します。1 は真で、0 は偽です。ほとんどの場合、この内部表現を使用する必要はありません。ただし、ルーティング・ルールの場合、ルールの制約が真の場合はいつでも、条件プロパティに対応する If 節を実行できます。この場合、条件プロパティを 1 に設定できます。

条件プロパティには、複数の条件を含めることができます。InterSystems IRIS は、対応するルールを実行するかどうか決定する前に、プロパティのすべての条件を評価および比較します。条件どうしのロジックは、AND 演算子または OR 演算子によって決定されます。例えば、以下の値の条件プロパティを考えてみます。

IF  Amount  <=  5000
AND  CreditRating > 5
OR  CurrentCustomer = 1

同じ値が、ルール・エディタでは次のように表示されます。

値には、Amount <= 5000、CreditRating > 5、CurrentCustomer = 1 という 3 つの条件があります。各条件は真か偽のいずれかになります。InterSystems IRIS は、これらの条件を個別に評価してから、AND および OR 演算子によって定義された、これらの条件の間の関係を評価します。

AND および OR 演算子は、真の値および偽の値に対してのみ機能します。すなわち、演算子は 2 つのブーリアン値の間に配置し、次のように 1 つのブーリアン値の結果を返す必要があります。

演算子	結果が真となる状況
AND	両方の値が真の場合。
OR	少なくとも 1 つの値が真であるか、両方の値が真の場合。1 つの値が偽でもう一方の値が真の場合でも、全体としての結果は真になります。

条件プロパティに複数の AND または OR 演算子が含まれる場合、AND 演算子が OR 演算子よりも優先されます。また、すべての AND 演算子が先に実行され、次に OR 演算子が実行されます。例えば、以下の条件セットを考えてみます。

IF  Amount  <=  5000
AND  CreditRating > 5
OR  CurrentCustomer = 1
AND  CreditRating >= 5

同じ条件セットが、ルール・エディタでは次のように表示されます。

InterSystems IRIS は、条件を次のように評価します。

IF  (Amount  <=  5000  AND  CreditRating > 5)
OR  (CurrentCustomer = 1  AND  CreditRating >= 5)

以下のいずれかまたは両方の文が真の場合、全体としての条件セットは真となります。

• 誰かが 5,000 未満の金額を要求し、さらにその人の信用等級が平均よりも優れている。

• 現在の銀行顧客の誰かが任意の金額を要求し、さらにその人の信用等級が平均以上である。

両方の文が偽の場合、全体としての条件セットは偽となります。

別の方法で説明すると、InterSystems IRIS は次の手順を実行して条件セットを評価します。

1. 以下の AND 式の結果が真か偽かを判別します。

   IF  Amount  <=  5000
   AND  CreditRating > 5
   
   

   この結果を “SafeBet” と呼ぶとします。

2. 以下の AND 式の結果が真か偽かを判別します。

   IF  CurrentCustomer = 1
   AND  CreditRating >= 5
   
   

   この結果を “KnownEntity” と呼ぶとします。

3. 以下の OR 式の結果が真か偽かを判別します。

   IF  SafeBet is true
   OR  KnownEntity is true
   
   

   SafeBet が真で KnownEntity が偽の場合、条件セットは真となります。同様に、SafeBet が偽で KnownEntity が真の場合でも、条件セットは真となります。最後に、SafeBet と KnownEntity の両方が真の場合、条件セットは真となります。

制約の定義

ルール・セットにルーティング・ルールが含まれる場合、ルール・セットを通過するメッセージが、そのルールに対して定義されている制約と一致すると、そのルール・ロジックが実行されるように、制約を定義することができます。フィールドを空白のままにすると、すべての値と一致することになります。ルールの制約を設定するには、そのルールをダブルクリックし、以下の設定を定義します。

ルールの無効化

ルール・セットがルールを実行しないようにしたいが、ルールは削除したくない場合、これを無効にすることができます。ルールをダブルクリックして、[無効] を選択するだけです。

データ変換へのデータの引き渡し

Send アクションは、プロダクション内のターゲットにメッセージを送信する前に、データ変換を呼び出すことができます。このデータ変換では、その aux 変数を使用して、ルールから情報を取得できます。ルールの名前やルールが起動された理由など、このデータの一部は、ルール・クラスを変更することなく、この変換に使用できます。

変換に追加情報を渡すには、IDE でルール・クラスを編集し、クラスのプロパティに値を割り当てる必要があります。ルール・クラスの RuleUserData プロパティに割り当てられた値は、変換が aux.RuleUserData 変数にアクセスする場合に使用できます。ルール・クラスの RuleActionUserData プロパティに割り当てられた値は、aux.RuleActionUserData として変換で使用できます。

変換での aux 変数へのアクセスの詳細は、DTL の構文ルールの有効な式のリストを参照してください。

ビジネス・ルール通知の追加

InterSystems IRIS では、あるルールを実行するたびにシステムで特定のアクションが実行されるように、ルール通知を設定できます。ルールに関連する大半のアクティビティとは異なり、通知の設定にはプログラミングが必要です。Ens.Rule.NotificationOpens in a new tab クラスのサブクラスを作成して、そのサブクラスの %OnNotify メソッドを上書きする必要があります。%OnNotify メソッドのシグニチャは、以下のとおりです。

ClassMethod %OnNotify(pReason As %String,
                      pRule As Ens.Rule.RuleDefinition)
                      As %Status

使用可能な pReason の値は次のとおりです。

• BeforeSave

• AfterSave

• Delete

実行時にプロダクション・フレームワークは自動的に Ens.Rule.NotificationOpens in a new tab のサブクラスを検索し、%OnNotify 内のコードを使用してルールの実行時に行う操作を判断します。