5.2. OpenRules のルール定義ファイルを作成する¶

1. パソコンでExcelを起動し、新規にブックを作成します。
2. OpenRules では、設定を含めたすべての表の1行目に「テーブルタイプを表すキーワード」と「テーブルの名称」を半角スペースを空けて記述します。

   

3. 最初に作成するのは、条件と処理をまとめた表になるため、キーワードは「 DecisionTable 」になります。

   

4. テーブルの名称は、半角英数字で設定できますので、任意の名称を入力します。

   名称は、1つのファイル内で一意になるようにします。

   （複数のファイルにまたがる場合には、1つのデータソース定義に設定するExcelファイルで一意になるようにします。）

   

   Excelファイルのシート上には、このように記述します。

   OpenRules のしくみでは、1番上、1番左端の行・列に入力してはいけないため、1行・1列空けて入力します。

   

5. 2行目には、「条件」・「処理」の区分を表すキーワードを入力します。

   

   このシナリオでは、「条件」は「年齢」の1項目、「処理」は「メッセージ」の1項目になるため、左のセルに条件を表す「Condition」、右のセルに処理を表す「Conclusion」を入力します。

   

   Excelファイルのシート上には、このように記述します。

   条件や処理には、演算子の項目、値の項目の2列が必要となるため、Excelファイル上ではこのように結合セルにします。

   

6. 3行目には、「条件」・「処理」の項目名を入力します。

   

   このシナリオでは、「条件」は「年齢」、「処理」は「メッセージ」になるため、左のセルに「年齢」、右のセルに「メッセージ」を入力します。

   

   Excelファイルのシート上には、このように記述します。

   条件や処理の項目名もキーワードと同様に、結合セルにします。

   

7. これで、ヘッダが設定できましたので、一度保存し、次の手順に進みましょう。
8. ファイルを保存する際には、形式を「Excel 97-2003ブック（*.xls）」としてください。

   xls形式以外で保存した場合、データソース定義に登録することができません。

   

1. OpenRules の「 DecisionTable 」は、上から順に条件を評価（判断）し、条件に合致したらその行の処理（返却する値）を実行して終了するしくみになっています。

   

2. 「条件」と「処理」には、演算子と値を入力します。

   

3. 最初の条件は、「年齢が0歳未満」となるため、年齢の演算子に「～未満」を表す「<」、値に「0」を入力します。

   

   Excelファイルのシート上には、このように記述します。

   

4. 「年齢が0歳未満」の条件に合致した場合には、メッセージは「エラー！」と返却します。

   そのために、メッセージの演算子に「値の割り当て」を表す「=」、値に「エラー！」を入力します。

   

   Excelファイルのシート上には、このように記述します。

   

5. 次の条件と処理の「0歳以上6歳未満の場合、「幼児」と返却する」を表にするために整理します。

   2番目以降の条件は、「1番目（その条件より上の条件）に合致しない」かつ「2番目以降の条件」と評価（判断）されます。
   そのため、「 DecisionTable 」では、上限の「6歳未満の場合」を2番目の条件に設定します。

   

   Excelファイルのシート上には、このように記述します。

   

6. 2番目の条件に合致した時には、メッセージに「幼児」と返却しますので、1番目と同様に設定します。

   メッセージの演算子に「値の割り当て」を表す「=」、値に「幼児」を入力します。

   

   Excelファイルのシート上には、このように記述します。

   

7. 以下の3番目～6番目の条件は、2番目と同様に設定できますので、2番目と同様の形で設定します。

   • 6歳以上13歳未満の場合、「小学生」と返却する
   • 13歳以上16歳未満の場合、「中学生」と返却する
   • 16歳以上19歳未満の場合、「高校生」と返却する
   • 19歳以上23歳未満の場合、「大学生」と返却する

   

   Excelファイルのシート上には、このように記述します。

   

8. 最後の7番目の条件は、演算子を「以上」を表すものに変更し、2番目と同様の形で設定します。

   メッセージには、「社会人」と入力します。

   

   Excelファイルのシート上には、このように記述します。

   

9. これで、ヘッダ・明細とも設定できましたので、一度保存し、次の手順に進みましょう。

1. OpenRules のヘッダの1行目は、条件と処理の列の範囲で結合する必要がありますので、4列分を結合します。

   

2. 各セルの境界線をわかりやすくするために罫線を引きます。

   

3. 各セルの書式を OpenRules の標準に合わせて設定します。

   1行目のヘッダを以下の通りに設定します。

   • 文字の揃え方：左揃え
   • セルの背景色(塗りつぶし)：黒
   • フォントの色：白

   

4. 2行目のヘッダのキーワードを以下の通りに設定します。

   • セルの背景色(塗りつぶし)：グレー（ RGB/217,217,217 ）

   

5. 3行目のヘッダの条件の項目名を以下の通りに設定します。

   • セルの背景色(塗りつぶし)：水色（ RGB/204,255,255 ）
   • セルの文字の装飾：太字

   

6. 3行目のヘッダの処理の項目名を以下の通りに設定します。

   • セルの背景色(塗りつぶし)：青（ RGB/141,180,226 ）
   • セルの文字の装飾：太字

   

7. ルールの表（DecisionTable）が完成しましたので、ファイルを保存します。

   次に実行するために必要な表を追加していきます。

   

1. 先の手順で作成したExcelファイルを開きます。
2. マッピング表のキーワードは「 Glossary 」になります。

   

3. テーブルの名称は、「glossary」と入力します。

   

   Excelファイルに設定する各表（テーブル）は、他のテーブルと1つ以上行・列を空ける必要があります。

   作成済みの「 DecisionTable 」と同じシートに設定する場合には、1つ以上行・列を空けて作成していきます。

   

4. 2行目には、各列のラベルを設定します。

   OpenRules の標準では、「Variable」「Business Concept」「Attribute」としていますが、今回はわかりやすくするために「論理名」「グループ」「物理名」とします。

   

   コラム

   Glossary の列ラベル部分は、自由に名前を設定することができます。

   「Variable」「Business Concept」「Attribute」の並び替えはできません。

   Excelファイルのシート上には、このように記述します。

   

5. これで、ヘッダが設定できましたので、一度保存し、次の手順に進みましょう。

1. 論理名の内容を入力します。

   上から順に「名前」「年齢」「メッセージ」と入力します。

   

   Excelファイルのシート上には、このように記述します。

   

2. 続いて、項目名の内容を設定します。

   項目名は、半角英数字で用語に対応した名称を設定する必要があります。

   このシナリオでは、上から順に「Name」「Age」「message」と入力します。

   

   Excelファイルのシート上には、このように記述します。

   

3. 業務用語のマッピング表（Glossary）では、実行時に初期化するためのグループで属性をまとめます。

   このシナリオでは、入力項目のグループ、出力項目のグループでまとめます。
   用語に「名前」を設定した行に「InputObject」、「メッセージ」を設定した行に「OutputObject」を設定します。

   

   「InputObject」のグループには、2つの属性を含みますので、2行のセルを結合します。

   

   Excelファイルのシート上には、このように記述します。

   

4. これで、業務用語のマッピング表（Glossary）の各項目が設定できましたので、一度保存し、次の手順に進みましょう。

1. OpenRules のヘッダの1行目は、「用語」「グループ」「項目名」の列の範囲で結合する必要がありますので、3列分を結合します。

   

2. 各セルの境界線をわかりやすくするために罫線を引きます。

   

3. 各セルの書式を OpenRules の標準に合わせて設定します。

   1行目のヘッダを以下の通りに設定します。

   • セルの揃え方：左揃え
   • セルの背景色(塗りつぶし)：黒
   • セルの文字の色：白

   

4. 論理名の列のヘッダ・明細を以下の通りに設定します。

   • セルの揃え方：（ヘッダ）中央揃え、（明細）左揃え
   • セルの背景色(塗りつぶし)：グレー（ RGB/220,230,241 ）
   • セルの文字の色：黒
   • セルの文字の装飾：（ヘッダ）太字

   

5. オブジェクト・物理名のヘッダを以下の通りに設定します。

   • セルの揃え方：中央揃え
   • セルの背景色(塗りつぶし)：水色（ RGB/141,180,226 ）
   • セルの文字の色：黒
   • セルの文字の装飾：（ヘッダ）太字

   

6. 最後にオブジェクトの明細の揃え方を中央揃えにしましょう。

   

7. 項目名のマッピング表（Glossary）が完成しましたので、ファイルを保存します。

   次にルールで利用する項目やデータ型の定義の表を追加していきます。

1. 先の手順で作成したExcelファイルを開きます。
2. 項目とデータ型の定義のキーワードは「 Datatype 」になります。

   

3. テーブルの名称は、業務用語のマッピング表（ Glossary ）で「Business Concept」（このハンズオンで「オブジェクト」とした列）にする必要があります。

   入力項目のグループ「InputObject」と入力しましょう。

   

   この「 Datatype 」も、他の表と同様に、同じシートに作成する場合には、1つ以上行・列を空けて作成します。

   

4. 同様の手順で出力項目のグループ（OutputObject）のヘッダも作成しましょう。

   

   Excelのシートは、以下のようになります。

   

5. これで、ヘッダが設定できましたので、一度保存し、次の手順に進みましょう。

1. 最初に入力項目のグループ（InputObject）の表を作成していきましょう。

   「 Datatype 」では、左側にデータ型、右側に業務用語のマッピング表（ Glossary ）で設定した項目の物理名を入力します。

   

2. 入力項目のオブジェクトの項目「名前」を設定します。

   「名前」のデータ型は「文字列」となりますので、「String」と入力し、その隣のセルには項目の物理名の「Name」を入力します。

   

   Excelファイルのシート上には、このように記述します。

   

3. 次に「年齢」を設定します。

   「年齢」のデータ型は「整数」となりますので、「int」と入力し、その隣のセルには項目名の「Age」を入力します。

   

   Excelファイルのシート上には、このように記述します。

   

4. これで、入力項目のグループ（InputObject）の表が設定できましたので、次に出力項目のグループ（OutputObject）を作成していきましょう。
5. 出力項目のグループの項目「メッセージ」を設定します。

   「メッセージ」のデータ型は「文字列」となりますので、「String」と入力し、その隣のセルには項目名の「message」を入力します。

   

   Excelファイルのシート上には、このように記述します。

   

6. これで、項目とデータ型の定義（Datatype）が設定できましたので、一度保存し、次の手順に進みましょう。

1. OpenRules のヘッダの1行目は、「データ型」「項目名」の列の範囲で結合する必要がありますので、2列分を結合します。

   

2. 各セルの境界線をわかりやすくするために罫線を引きます。

   

3. 各セルの書式を OpenRules の標準に合わせて設定します。

   1行目のヘッダを以下の通りに設定します。

   • セルの揃え方：左揃え
   • セルの背景色(塗りつぶし)：黒
   • セルの文字の色：白

   

4. 残りの明細のセルを以下の通りに設定します。

   • セルの揃え方：中央揃え
   • セルの背景色(塗りつぶし)：青（ RGB/204,255,255 ）

   

5. 項目とデータ型の定義（Datatype）が完成しましたので、ファイルを保存します。

   次に実行するために必要な表を追加していきます。

1. 先の手順で作成したExcelファイルを開きます。
2. マッピング表のキーワードは「 Data/Variable 」になります。

   「 Data/Variable 」では、「Data」「Variable」のどちらを選んでも問題ありません。

   今回のハンズオンでは、「Data」と定義して進めていきます。

   

3. テーブルの名称は、業務用語のマッピング表（ Glossary ）で「Business Concept」（このハンズオンで「オブジェクト」とした列）にする必要があります。

   入力項目のグループ「InputObject」と入力しましょう。

   

4. オブジェクト名「InputObject」に続いて、 Data/Variable のヘッダにはインスタンス名も記述します。

   オブジェクト名と同じにするとわかりづらくなるため、「inputObj」と入力しましょう。

   

   この「 Data/Variable 」も、他の表と同様に、同じシートに作成する場合には、1つ以上行・列を空けて作成します。

   Excelのシートは、以下のようになります。

   

5. 同様の手順で出力項目のオブジェクト（OutputObject）のヘッダも作成しましょう。

   出力項目のインスタンス名は「outputObj」とします。

   

   Excelのシートは、以下のようになります。

   

6. これで、ヘッダが設定できましたので、一度保存し、次の手順に進みましょう。

1. 最初に入力項目のオブジェクト「InputObject」のサブヘッダを設定していきましょう。

   サブヘッダの1行目に物理名、2行目に論理名を入力します。

   

2. 左の列に「名前」の項目を設定しますので、物理名に「Name」、論理名に「名前」と入力しましょう。

   

   Excelのシートは、以下のようになります。

   

3. 右の列に「年齢」の項目を設定しますので、物理名に「Age」、論理名に「年齢」と入力しましょう。

   

   Excelのシートは、以下のようになります。

   

4. 同様に出力項目のオブジェクト「OutputObject」のサブヘッダを設定していきましょう。

   サブヘッダの1行目に物理名の「message」、2行目に論理名の「メッセージ」を入力します。

   

   Excelのシートは、以下のようになります。

   

1. 3行目に項目の初期値を設定します。

   この初期値は、ルールを実行する際のオブジェクトのインスタンス化（初期化）で必要な値になりますので、必ず何らかの値を入力します。

   

2. 名前の初期値を設定するために、名前の列の3行目に「太郎」と入力します。

   

   Excelファイルのシート上には、このように記述します。

   

3. 次に、年齢の初期値を設定するために、年齢の列の3行目に「0」と入力します。

   

   Excelファイルのシート上には、このように記述します。

   

4. 同様に、出力項目のオブジェクトのメッセージの初期値を設定します。

   

   Excelファイルのシート上には、このように記述します。

   

5. これで、項目の初期値（Data）が設定できましたので、一度保存し、次の手順に進みましょう。

1. OpenRules のヘッダの1行目は、サブヘッダ・明細の列の範囲で結合する必要がありますので、2列分を結合します。

   出力項目のオブジェクト（OutputObject）は、1列で構成されていますので、結合する必要はありません。

   

2. 各セルの境界線をわかりやすくするために罫線を引きます。

   

3. 各セルの書式を OpenRules の標準に合わせて設定します。

   1行目のヘッダを以下の通りに設定します。

   • セルの揃え方：左揃え
   • セルの背景色(塗りつぶし)：黒
   • セルの文字の色：白

   

4. 2行目のサブヘッダの物理名を以下の通りに設定します。

   • セルの揃え方：中央揃え
   • セルの背景色(塗りつぶし)：水色（ RGB/153,204,255 ）

   

5. 3行目のサブヘッダの論理名を以下の通りに設定します。

   • セルの揃え方：中央揃え
   • セルの背景色(塗りつぶし)：水色（ RGB/153,204,255 ）

   

6. 最後に明細を中央揃えにします。

   

7. 項目の初期値（Data）が完成しましたので、ファイルを保存します。

   次に実行するために必要な表を追加していきます。

1. 先の手順で作成したExcelファイルを開きます。
2. マッピング表のキーワードは「 DecisionObject 」になります。

   

3. テーブルの名称は、”decisionObjects”と入力します。

   “decisionObjects”以外の名前を設定した場合、実行時にエラーが発生します。

   

   この「 DecisionObject 」も、他の表と同様に、同じシートに作成する場合には、1つ以上行・列を空けて作成します。

   

1. DecisionObject は、左に Glossary で定義している対象のオブジェクト、右の列にはオブジェクトへのインスタンスの割り当て処理を記述します。

   

2. サブヘッダは列の用途を表すラベルとして利用され、 OpenRules の標準では「Business Concept」、「Business Object」としています。

   今回はわかりやすくするために、左を「オブジェクト」、右を「値の入出力方法」とします。

   

   Excelファイルのシート上には、このように記述します。

   

1. 3行目にオブジェクトごとにインスタンスの割当処理を設定します。

   

2. 最初に入力項目のオブジェクトの設定をします。

   左にオブジェクトの名前（型名）の「InputObject」と記述しましょう。

   

   Excelファイルのシート上には、このように記述します。

   

3. 入力項目は、 IM-BIS のデータマッパーから入力値を受け取るため、以下の形式でインスタンスを割り当てる処理を記述します。

   :=  (入力項目のオブジェクト名（型名）) getInputData(decision, 入力項目のオブジェクトのインスタンス名)

   

4. すでに定義した Datatype や Data/Variable を参考に、オブジェクト名やインスタンス名を設定し、以下のように記述します。

   :=  (InputObject) getInputData(decision, inputObj)
   

   

   Excelファイルのシート上には、このように記述します。

   

5. 出力項目のオブジェクトの設定をします。

   左にオブジェクトの名前（型名）の「OutputObject」と記述しましょう。

   

   Excelファイルのシート上には、このように記述します。

   

6. 内部の計算用や出力項目のオブジェクトは、入力項目のオブジェクトと異なる設定をします。

   処理の割当には、以下の形式の式を記述します。

   :=  （出力項目のオブジェクトのインスタンス名）[0]
   

   

   Excelファイルのシート上には、このように記述します。

   

7. すでに定義した Data/Variable を参考に、インスタンス名を設定し、以下のように記述します。

   :=  outputObj[0]
   

   

   Excelファイルのシート上には、このように記述します。

   

1. OpenRules のヘッダの1行目は、サブヘッダ・明細の列の範囲で結合する必要がありますので、2列分を結合します。

   

2. 各セルの境界線をわかりやすくするために罫線を引きます。

   

3. 各セルの書式を OpenRules の標準に合わせて設定します。

   1行目のヘッダを以下の通りに設定します。

   • セルの揃え方：左揃え
   • セルの背景色(塗りつぶし)：黒
   • セルの文字の色：白

   

4. 2行目のサブヘッダを以下の通りに設定します。

   • セルの揃え方：中央揃え
   • セルの背景色(塗りつぶし)：水色（ RGB/153,204,255 ）
   • セルの文字の装飾：太字

   

5. 内部処理・出力用のオブジェクトの定義（DecisionObject）が完成しましたので、ファイルを保存します。

   次に実行するために必要な表を追加していきます。

1. 先の手順で作成したExcelファイルを開きます。
2. マッピング表のキーワードは「 Decision 」になります。

   

3. テーブルの名称は、半角英数字で設定できますので、任意の名称を入力します。

   名称は、1つのファイル内で一意になるようにします。

   （複数のファイルにまたがる場合には、1つのデータソース定義に設定するExcelファイルで一意になるようにします。）

   

   Excelファイルに設定する各表（テーブル）は、他のテーブルと1つ以上行・列を空ける必要があります。

   作成済みの「 DecisionTable 」と同じシートに設定する場合には、1つ以上行・列を空けて作成していきます。

   

4. これで、ヘッダが設定できましたので、一度保存し、次の手順に進みましょう。

1. Decision では、さまざまな列タイプを設定し、列タイプに応じて必要な内容を設定します。

   

2. 必須の列タイプは「 ActionPrint 」「 ActionExecute 」となりますので、今回はこの2つの項目を設定します。

   （その他に設定できる列タイプは、「 Decision 」の「サブヘッダに利用できるキーワード」を参照してください。）

   サブヘッダの1行目には「ActionPrint」「ActionExecute」と記述します。

   

   Excelファイルのシート上には、このように記述します。

   

3. Decision のサブヘッダの2行目は列の用途を表すラベルとして利用されます。

   今回は、「 ActionPrint 」には「処理名」、「 ActionExecute 」には「実行する処理内容」と設定します。

   

   Excelファイルのシート上には、このように記述します。

   

4. これで、サブヘッダが設定できましたので、一度保存し、次の手順に進みましょう。

1. OpenRules の「 Decision 」は、上から順に DecisionTable を実行するしくみになっています。

   左側の列に処理を表すためのラベル（名前）、右側の列に実行する DecisionTable や Method を呼び出すための式を記述します。

   

2. 今回は処理の最初と最後に、値の入出力がどのように行われるかを確認できるように、入力項目のオブジェクトと出力項目のオブジェクトをコンソール上に出力するための処理を記述します。

   先に左側の処理のラベルに、今回実行させる処理の名前を記述します。

   • 今回の処理内容
     • 入力項目のオブジェクト（InputObject）の内容のコンソールへの出力
     • 作成したルールの表（myRule）の実行
     • 出力項目のオブジェクト（OutputObject）へのルールの実行結果の割当て
     • 出力項目のオブジェクト（OutputObject）の内容のコンソールへの出力

   

   Excelファイルのシート上には、このように記述します。

   

3. 続いて、実行する処理の式を記述します。

   最初に、今回のハンズオンでは、どのように入出力が行われているかを確認できるように、入力項目のオブジェクト、出力用のオブジェクトの内容の出力を記述します。

   オブジェクトの内容をコンソールに出力するには、Javaの標準出力を利用しますので、以下の式になります。

   // 入力項目のオブジェクトの出力
   := System.out.println(getDecisionObject("InputObject"))
   
   // 出力項目のオブジェクトの出力
   := System.out.println(getDecisionObject("OutputObject"))
   

   

   コラム

   この標準出力のコードは、 Decision での必須項目ではありませんが、 OpenRules へ値の入出力が想定通りに行われているかなどのデバッグ時に活用できます。

   Excelファイルのシート上には、このように記述します。

   

4. 次の行に DecisionTable を実行するために、作成した DecisionTable の名前を記述しましょう。

   // DecisionTableの実行
   myRule
   

   

   Excelファイルのシート上には、このように記述します。

   

5. DecisionTable の実行（評価）結果を出力項目のオブジェクトのインスタンスに格納する処理を記述しましょう。

   // 出力項目のオブジェクトのインスタンスへの実行結果のセット
   := decision().put("OutputObject", outputObj)
   

   

   Excelファイルのシート上には、このように記述します。

   

6. 最後にレイアウトを整えて完成させましょう。

1. OpenRules のヘッダの1行目は、サブヘッダ・明細の列の範囲で結合する必要がありますので、2列分を結合します。

   

2. 各セルの境界線をわかりやすくするために罫線を引きます。

   

3. 各セルの書式を OpenRules の標準に合わせて設定します。

   1行目のヘッダを以下の通りに設定します。

   • セルの揃え方：左揃え
   • セルの背景色(塗りつぶし)：黒
   • セルの文字の色：白

   

4. 2行目のサブヘッダの書式を以下の通りに設定します。

   • セルの揃え方：中央揃え
   • セルの背景色(塗りつぶし)：グレー（ RGB/217,217,217 ）

   

5. 3行目のサブヘッダの書式を以下の通りに設定します。

   • セルの揃え方：中央揃え
   • セルの背景色(塗りつぶし)：青（ RGB/141,180,226 ）
   • セルの文字の色：黒
   • セルの文字の装飾：太字

   

6. 内部処理・出力用のオブジェクトの定義（DecisionObject）が完成しましたので、ファイルを保存します。

   次に環境設定の表を追加していきます。

1. 先の手順で作成したExcelファイルを開きます。
2. マッピング表のキーワードは「 Environment 」になります。

   テーブル名等をつける必要はありませんので、これでヘッダが完成します。

   

   Excelファイルに設定する各表（テーブル）は、他のテーブルと1つ以上行・列を空ける必要があります。

   作成済みの他のテーブルと同じシートに設定する場合には、1つ以上行・列を空けて作成していきます。

   

3. これで、ヘッダが設定できましたので、一度保存し、次の手順に進みましょう。

1. 先の手順で作成したExcelファイルを開きます。
2. 左の列には、参照するリソースのタイプに合わせたキーワードを指定します。

   IntramartTemplate.xlsは、Excvelファイルとなるため、キーワードとして「include」を指定します。

   

3. 右の列には、参照するリソースのファイルパル・ファイル名やパッケージ名等を指定します。

   「IntramartTemplate.xls」を以下のパスで指定します。

   ../lib/openrules.config/IntramartTemplate.xls
   

   

   コラム

   この設定で参照しているExcelファイルは、以下の場所に配置されています。

   %CONTEXT_PATH%/WEB-INF/im_bis/datasource/rule/lib/openrules.config
   

4. これで、必要な情報を設定できましたので、一度保存し、次の手順に進みましょう。

1. OpenRules のヘッダの1行目は、サブヘッダ・明細の列の範囲で結合する必要がありますので、2列分を結合します。

   

2. 各セルの境界線をわかりやすくするために罫線を引きます。

   

3. 各セルの書式を OpenRules の標準に合わせて設定します。

   1行目のヘッダを以下の通りに設定します。

   • セルの揃え方：左揃え
   • セルの背景色(塗りつぶし)：黒
   • セルの文字の色：白

   

4. 残りのセルを以下の通りに設定します。

   • セルの背景色(塗りつぶし)：青（ RGB/204,255,255 ）

   

5. これで、 OpenRules のExcelの定義ファイルが作成できました。

   次の手順で、データソース定義に登録し、 IM-BIS との連携を設定していきましょう。