Red Hat Decision Manager のスタートガイド

手順

1. Business Central で、Menu → Design → Projects に移動します。既存のプロジェクトがある場合は、MySpace のデフォルトのスペースをクリックして、Add Project ドロップダウンメニューから Try Samples を選択して、サンプルにアクセスできます。既存のプロジェクトがない場合には、Try samples をクリックします。
2. 各サンプルプロジェクトの説明を読んで、どのプロジェクトが最適か確認します。各プロジェクトは、Red Hat Decision Manager の意思決定管理やビジネス最適化アセットおよび論理を異なる方法で説明するように設計されています。
3. サンプルプロジェクトを選択し、Ok をクリックして自分のスペースにプロジェクトを追加します。
4. 自分のスペースの Projects ページで、サンプルプロジェクトの 1 つを選択して、そのプロジェクトのアセットを表示します。

5. 各アセットを選択して、指定のゴールまたはワークフローに到達するためにプロジェクトがどのように設計されているのかを確認します。サンプルのプロジェクトには、アセットが複数ページ含まれているものもあります。右上隅の左向きまたは右向き矢印をクリックして、全アセットリストを表示します。

   図1.1 アセットページの選択

   

6. プロジェクトの Assets ページの右上隅にある Build をクリックしてサンプルプロジェクトをビルドするか、Deploy をクリックしてプロジェクトをビルドしてから、KIE Server にデプロイします。

   注記

   Build & Install オプションを選択してプロジェクトをビルドし、KJAR ファイルを KIE Server にデプロイせずに設定済みの Maven リポジトリーに公開することもできます。開発環境では、Deploy をクリックすると、ビルドされた KJAR ファイルを KIE Server に、実行中のインスタンス (がある場合はそれ) を停止せずにデプロイできます。または Redeploy をクリックして、ビルドされた KJAR ファイルをデプロイしてすべてのインスタンスを置き換えることもできます。次回、ビルドされた KJAR ファイルをデプロイまたは再デプロイすると、以前のデプロイメントユニット (KIE コンテナー) が同じターゲット KIE Server で自動的に更新されます。実稼働環境では Redeploy オプションは無効になっており、Deploy をクリックして、ビルドされた KJAR ファイルを KIE Server 上の新規デプロイメントユニット (KIE コンテナー) にデプロイすることのみが可能です。

   KIE Server の環境モードを設定するには、org.kie.server.mode システムプロパティーを org.kie.server.mode=development または org.kie.server.mode=production に設定します。Business Central でそれぞれのプロジェクトのデプロイメント動作を設定するには、プロジェクトの Settings → General Settings → Version に移動し、Development Mode オプションを選択して、Save をクリックします。デフォルトでは、KIE Server および Business Central のすべての新規プロジェクトは開発モードになっています。Development Mode をオンにしたプロジェクトをデプロイしたり、実稼働モードになっている KIE Server に手動で SNAPSHOT バージョンの接尾辞を追加したプロジェクトをデプロイしたりすることはできません。

   プロジェクトのデプロイメントに関する詳細を確認するには、画面の上部にあるデプロイメントバナーの View deployment details か、Deploy のドロップダウンメニューをクリックします。このオプションを使用すると、Menu → Deploy → Execution Servers ページに移動します。

手順

1. VS Code IDE で Extensions メニューオプションを選択し、DMN、BPMN、およびテストシナリオファイルのサポートに対して Red Hat Business Automation Bundle を検索します。

   DMN ファイルまたは BPMN ファイルだけをサポートする場合は、DMN Editor または BPMN Editor 拡張機能をそれぞれ検索することもできます。

2. Red Hat Business Automation Bundle 拡張機能が VS Code に表示される際に、これを選択し、Install をクリックします。
3. VS Code エディターの動作を最適化するには、拡張機能のインストールが完了した後に、VS Code のインスタンスを再度読み込み、閉じるか、再起動します。

手順

1. 以下の方法のいずれかを使用して、スタンドアロンのエディターをインストールします。

   各 JavaScript ファイルを手動でダウンロード: この方法の場合は、以下の手順に従います。

   1. JavaScript ファイルをダウンロードします。
   2. ダウンロードした Javascript ファイルをホスト型アプリケーションに追加します。

   3. 以下の <script> タグを HTML ページに追加します。

      DMN エディターの HTML ページのスクリプトタグ

      <script src="https://<YOUR_PAGE>/dmn/index.js"></script>

      BPMN エディターの HTML ページのスクリプトタグ

      <script src="https://<YOUR_PAGE>/bpmn/index.js"></script>

   NPM パッケージの使用: この方法の場合は、以下の手順に従います。

   1. NPM パッケージを package.json ファイルに追加します。

      NPM パッケージの追加

      npm install @kie-tools/kie-editors-standalone

   2. 各エディターライブラリーを TypeScript ファイルにインポートします。

      各エディターのインポート

      import * as DmnEditor from "@kie-tools/kie-editors-standalone/dist/dmn"
      import * as BpmnEditor from "@kie-tools/kie-editors-standalone/dist/bpmn"

2. スタンドアロンのエディターをインストールしたら、以下の例のように提供されたエディター API を使用して必要なエディターを開き、DMN エディターを開きます。API は、各エディターで同じものになります。

   DMN スタンドアロンのエディターを開く

   const editor = DmnEditor.open({
     container: document.getElementById("dmn-editor-container"),
     initialContent: Promise.resolve(""),
     readOnly: false,
     origin: "",
     resources: new Map([
       [
         "MyIncludedModel.dmn",
         {
           contentType: "text",
           content: Promise.resolve("")
         }
       ]
     ])
   });

   エディター API で以下のパラメーターを使用します。

   表2.1 パラメーターの例

   パラメーター	説明
   container	エディターが追加される HTML 要素。
   initialContent	DMN モデルのコンテンツへの Promise。以下の例のように、このパラメーターは空にすることができます。 Promise.resolve("") Promise.resolve("<DIAGRAM_CONTENT_DIRECTLY_HERE>") fetch("MyDmnModel.dmn").then(content ⇒ content.text())
   readOnly (任意)	エディターでの変更を許可します。コンテンツの編集を許可する場合は false (デフォルト)、エディターで読み取り専用モードの場合は true に設定します。
   origin (任意)	リポジトリーの起点。デフォルト値は window.location.origin です。
   resources (任意)	エディターのリソースのマッピング。たとえば、このパラメーターを使用して、BPMN エディターの DMN エディターまたは作業アイテム定義に含まれるモデルを提供します。マップの各エントリーには、リソース名と、content-type (text または binary) および content (initialContent パラメーターと同様) で構成されるオブジェクトが含まれています。

   返されるオブジェクトには、エディターの操作に必要なメソッドが含まれます。

   表2.2 返されたオブジェクトメソッド

   メソッド	説明
   getContent(): Promise<string>	エディターのコンテンツを含む promise を返します。
   setContent(path: string, content: string): void	エディターの内容を設定します。
   getPreview(): Promise<string>	現在のダイアグラムの SVG 文字列が含まれる promise を返します。
   subscribeToContentChanges(callback: (isDirty: boolean) ⇒ void): (isDirty: boolean) ⇒ void	エディターでコンテンツを変更し、サブスクライブ解除に使用されるのと同じコールバックを返す際に呼び出されるコールバックを設定します。
   unsubscribeToContentChanges(callback: (isDirty: boolean) ⇒ void): void	エディターでコンテンツが変更される際に渡されたコールバックのサブスクライブを解除します。
   markAsSaved(): void	エディターの内容が保存されることを示すエディターの状態をリセットします。また、コンテンツの変更に関連するサブスクライブされたコールバックをアクティベートします。
   undo(): void	エディターの最後の変更を元に戻します。また、コンテンツの変更に関連するサブスクライブされたコールバックをアクティベートします。
   redo(): void	エディターで、最後に元に戻した変更をやり直します。また、コンテンツの変更に関連するサブスクライブされたコールバックをアクティベートします。
   close(): void	エディターを終了します。
   getElementPosition(selector: string): Promise<Rect>	要素をキャンバスまたはビデオコンポーネント内に置いた場合に、標準のクエリーセレクターを拡張する方法を提供します。selector パラメーターは、Canvas:::MySquare、Video:::PresenterHand などの <PROVIDER>:::<SELECT> 形式に従う必要があります。このメソッドは、要素の位置を表す Rect を返します。
   envelopeApi: MessageBusClientApi<KogitoEditorEnvelopeApi>	これは高度なエディター API です。高度なエディター API の詳細は、MessageBusClientApi および KogitoEditorEnvelopeApi を参照してください。

手順

1. traffic-violation プロジェクトのホーム画面で Add Asset をクリックします。

2. Add Asset ページで DMN をクリックします。Create new DMN ウィンドウが開きます。

   1. Create new DMN ウィンドウの DMN 名フィールドで Traffic Violation を入力します。
   2. Package リストから com.myspace.traffic_violation を選択します。
   3. OK をクリックします。DMN デザイナーで DMN アセットが開きます。

3. DMN デザイナーキャンバスで、DMN Input Data の入力ノード 2 つをキャンバスにドラッグします。

   図5.2 DMN 入力データノード

   
4. 右上隅の アイコンをクリックします。
5. 入力ノードをダブルクリックして、名前の 1 つを Driver に、もう 1 つを Violation に変更します。
6. DMN Decision デシジョンノードをキャンバスにドラッグします。
7. デシジョンノードをダブルクリックして、Fine に名前を変更します。

8. Violation 入力ノードをクリックして Create DMN Information Requirement アイコンを選択し、2 つのノードを接続する Fine デシジョンノードをクリックします。

   図5.3 DMN 情報要件アイコンの作成

   
9. DMN Decision デシジョンノードをキャンバスにドラッグします。
10. デシジョンノードをダブルクリックして、Should the driver be suspended? に名前を変更します。
11. Driver 入力ノードをクリックして Create DMN Information Requirement アイコンを選択し、2 つのノードを接続する Should the driver be suspended? デシジョンノードをクリックします。
12. Fine デシジョンノードをクリックして Create DMN Information Requirement アイコンを選択し、Should the driver be suspended? デシジョンノードを選択します。

13. Save をクリックします。

    注記

    DRD を定期的に保存すると、DMN デザイナーは DMN モデルを静的に検証し、モデルが完全に定義されるまでエラーメッセージを出力する可能性があります。DMN モデルをすべて定義し終えてもエラーが発生する場合は、特定の問題を随時トラブルシューティングしてください。

手順

1. tDriver カスタムデータタイプを作成するには、Data Type タブの Add a custom Data Type をクリックし、Name フィールドに tDriver と入力して、Type リストから Structure を選択します。

2. 新しいデータタイプの右側にあるチェックマークをクリックして、変更を保存します。

   図5.5 tDriver のカスタムデータタイプ

   

3. 新しくネスト化されたデータタイプごとに、tDriver の横にあるプラス記号をクリックして、tDriver の構造化データタイプに、以下のネスト化されたデータタイプを追加します。新規データタイプの右側にあるチェックマークをクリックして、変更を保存します。

   • Name (文字列)
   • Age (数字)
   • State (文字列)
   • City (文字列)
   • Points (数字)
4. tViolation カスタムデータタイプを作成するには、New Data Type をクリックし、Name フィールドに tViolation と入力して、Type リストから Structure を選択します。

5. 新しいデータタイプの右側にあるチェックマークをクリックして、変更を保存します。

   図5.6 tViolation のカスタムデータタイプ

   

6. 新しくネスト化されたデータタイプごとに、tViolation の横にあるプラス記号をクリックして、tViolation の構造化データタイプに、以下のネスト化されたデータタイプを追加します。新規データタイプの右側にあるチェックマークをクリックして、変更を保存します。

   • Code (文字列)
   • Date (日付)
   • Type (文字列)
   • Speed Limit (数字)
   • Actual Speed (数字)

7. 以下の制約を Type のネスト化されたデータタイプに追加するには、編集アイコンをクリックして Add Constraints をクリックし、Select constraint type ドロップダウンメニューから Enumeration を選択します。

   • speed
   • parking
   • driving under the influence
8. OK をクリックしてから、type データタイプの右側にあるチェックマークをクリックし、変更を保存します。

9. tFine カスタムデータタイプを作成するには、New Data Type をクリックし、Name フィールドに tFine と入力して、Type リストから Structure を選択し、Save をクリックします。

   図5.7 tFine のカスタムデータタイプ

   

10. 新しくネスト化されたデータタイプごとに、tFine の横にあるプラス記号をクリックして、tFine の構造化データタイプに、以下のネスト化されたデータタイプを追加します。新規データタイプの右側にあるチェックマークをクリックして、変更を保存します。

    • Amount (数字)
    • Points (数字)
11. Save をクリックします。

手順

1. DMN デザイナーで Model タブをクリックし、右上の Properties アイコンをクリックして DRD プロパティーを開きます。
2. DRD で Driver 入力データノードを選択し、Properties パネルで Data type ドロップダウンメニューから tDriver を選択します。
3. Violation 入力データノードを選択し、Data type ドロップダウンメニューから tViolation を選択します。
4. Fine デシジョンノードを選択し、Data type ドロップダウンメニューから tFine を選択します。

5. Should the driver be suspended? デシジョンノードを選択し、以下のプロパティーを設定します。

   • Data type: string
   • Question: Should the driver be suspended due to points on his driver license?
   • Allowed Answers: Yes,No
6. Save をクリックします。

手順

1. 罰金を計算するには、DMN デザイナーキャンバスで Fine デシジョンノードを選択し、Edit をクリックして DMN ボックス式デザイナーを開きます。

   図5.10 デシジョンノードの編集アイコン

   

2. Select expression → Decision Table をクリックします。

   図5.11 デシジョンテーブルロジックタイプの選択

   
3. Violation.Date、Violation.Code、および Violation.Speed Limit の列で右クリックして、各フィールドで Delete を選択します。
4. Violation.Actual Speed 列ヘッダーをクリックし、Expression フィールドに Violation.Actual Speed - Violation.Speed Limit 式を入力します。

5. デシジョンテーブルの一行目に以下の値を入力します。

   • Violation.Type: "speed"
   • Violation.Actual Speed - Violation.Speed Limit: [10..30)
   • Amount: 500

   • Points: 3

     1 行目を右クリックし、Insert below を選択して新たな行を追加します。

6. デシジョンテーブルの 2 行目に以下の値を入力します。

   • Violation.Type: "speed"
   • Violation.Actual Speed - Violation.Speed Limit: >= 30
   • Amount: 1000

   • Points: 7

     2 行目を右クリックし、Insert below を選択して新たな行を追加します。

7. デシジョンテーブルの 3 行目に以下の値を入力します。

   • Violation.Type: "parking"
   • Violation.Actual Speed - Violation.Speed Limit: -
   • Amount: 100

   • Points: 1

     3 行目を右クリックし、Insert below を選択して新たな行を追加します。

8. デシジョンテーブルの 4 行目に以下の値を入力します。

   • Violation.Type: "driving under the influence"
   • Violation.Actual Speed - Violation.Speed Limit: -
   • Amount: 1000
   • Points: 5
9. Save をクリックします。
10. ドライバーの免許停止ルールを定義するには DMN デザイナーキャンバスに戻って Should the driver be suspended? デシジョンノードを選択し、Edit をクリックして DMN ボックス式デザイナーを開きます。
11. Select expression → Context をクリックします。
12. ContextEntry-1 をクリックして Name に Total Points と入力し、Data Type ドロップダウンメニューから number を選択します。
13. Total Points の横のセルをクリックしてコンテキストメニューから Literal Expression を選択し、Driver.Points + Fine.Points 式を入力します。
14. Driver.Points + Fine.Points の下のセルのコンテキストメニューから Literal Expression を選択し、if Total Points >= 20 then "Yes" else "No" と入力します。

15. Save をクリックします。

    これで罰金の計算方法とドライバーをいつ免許停止にするかを決定するコンテキストが定義されました。traffic-violation プロジェクトページに移動して Build をクリックすると、用例のプロジェクトがビルドされ、Alerts パネルのエラー (ある場合) が対処されます。

手順

1. traffic-violation プロジェクトのホーム画面で Add Asset をクリックして Add Asset 画面を開きます。

2. Test Scenario をクリックして Create new Test Scenario ダイアログを開きます。

   1. Test Scenario フィールドに Violation Scenarios と入力します。
   2. Package リストから com.myspace.traffic_violation を選択します。
   3. Source type で DMN を選択します。
   4. Choose DMN asset リストから DMN アセットへのパスを選択します。
   5. Ok をクリックして、Test Scenarios デザイナーで Violation Scenarios テストシナリオを開きます。
3. Driver 列サブヘッダー下で、State、City、Age、および Name の値のセルを右クリックし、コンテキストメニューから Delete column を選択してそれらを削除します。
4. Violation 列サブヘッダー下で Date と Code の値のセルを右クリックし、Delete column を選択してそれらを削除します。

5. 以下の情報をテストシナリオの 1 行目に入力します。

   • Scenario description: Above speed limit: 10km/h and 30 km/h
   • Points (Given 列ヘッダー下): 10
   • Type: "speed"
   • Speed Limit: 100
   • Actual Speed: 120
   • Points: 3
   • Amount: 500

   • Should the driver be suspended?: "No"

     1 行目を右クリックし、Insert row below を選択して新たな行を追加します。

6. 以下の情報をテストシナリオの 2 行目に入力します。

   • Scenario description: Above speed limit: more than 30 km/h
   • Points (Given 列ヘッダー下): 10
   • Type: "speed"
   • Speed Limit: 100
   • Actual Speed: 150
   • Points: 7
   • Amount: 1000

   • Should the driver be suspended?: "No"

     2 行目を右クリックし、Insert row below を選択して新たな行を追加します。

7. 以下の情報をテストシナリオの 3 行目に入力します。

   • Scenario description: Parking violation
   • Points (Given 列ヘッダー下): 10
   • Type: "parking"
   • Speed Limit: 空白のまま
   • Actual Speed: 空白のまま
   • Points: 1
   • Amount: 100

   • Should the driver be suspended?: "No"

     3 行目を右クリックし、Insert row below を選択して新たな行を追加します。

8. 以下の情報をテストシナリオの 4 行目に入力します。

   • Scenario description: DUI violation
   • Points (Given 列ヘッダー下): 10
   • Type: "driving under the influence"
   • Speed Limit: 空白のまま
   • Actual Speed: 空白のまま
   • Points: 5
   • Amount: 1000

   • Should the driver be suspended?: "No"

     4 行目を右クリックし、Insert row below を選択して新たな行を追加します。

9. 以下の情報をテストシナリオの 5 行目に入力します。

   • Scenario description: Driver suspended
   • Points (Given 列ヘッダー下): 15
   • Type: "speed"
   • Speed Limit: 100
   • Actual Speed: 140
   • Points: 7
   • Amount: 1000
   • Should the driver be suspended?: "Yes"
10. Save をクリックします。

11. Play ボタン をクリックして、テストシナリオが合格するかどうかを確認します。

    図6.2 交通違反の例のテストシナリオ実行結果

    

    失敗した場合は、エラーを修正してサイドテストシナリオを実行します。

手順

1. KIE Server REST API エンドポイントにアクセスするためのベース URL を決定します。これには、以下の値が必要です (例ではローカルデプロイメントのデフォルト値を使用しています)。

   • ホスト (localhost)
   • ポート (8080)
   • ルートコンテキスト (kie-server)
   • ベース REST パス (services/rest/)

   交通違反プロジェクトでのローカルデプロイメントにおけるベース URL の例:

   http://localhost:8080/kie-server/services/rest/server/containers/traffic-violation_1.0.0-SNAPSHOT

2. ユーザー認証要件を決定します。

   ユーザーを KIE Server 設定に直接定義すると、ユーザー名およびパスワードを要求する HTTP Basic 認証が使用されます。要求を成功させるには、ユーザーに kie-server ルールが必要です。

   以下の例は、curl 要求に認証情報を追加する方法を示します。

   curl -u username:password <request>

   Red Hat Single Sign-On を使用して KIE Server を設定している場合は、要求にベアラートークンが必要です。

   curl -H "Authorization: bearer $TOKEN" <request>

3. 要求と応答の形式を指定します。REST API エンドポイントには JSON と XML の両方の書式が利用でき、要求ヘッダーを使用して設定されます。

   JSON

   curl -H "accept: application/json" -H "content-type: application/json"

   XML

   curl -H "accept: application/xml" -H "content-type: application/xml"

4. 必要に応じて、デプロイしたデシジョンモデルのリストに対するコンテナーのクエリーです。

   [GET] server/containers/{containerId}/dmn

   curl 要求例:

   curl -u wbadmin:wbadmin -H "accept: application/xml" -X GET "http://localhost:8080/kie-server/services/rest/server/containers/traffic-violation_1.0.0-SNAPSHOT/dmn"

   サンプルの XML 出力:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <response type="SUCCESS" msg="Ok models successfully retrieved from container 'traffic-violation_1.0.0-SNAPSHOT'">
       <dmn-model-info-list>
           <model>
               <model-namespace>https://kiegroup.org/dmn/_60b01f4d-e407-43f7-848e-258723b5fac8</model-namespace>
               <model-name>Traffic Violation</model-name>
               <model-id>_2CD7D1AA-BD84-4B43-AD21-B0342ADE655A</model-id>
               <decisions>
                   <dmn-decision-info>
                       <decision-id>_23428EE8-DC8B-4067-8E67-9D7C53EC975F</decision-id>
                       <decision-name>Fine</decision-name>
                   </dmn-decision-info>
                   <dmn-decision-info>
                       <decision-id>_B5EEE2B1-915C-44DC-BE43-C244DC066FD8</decision-id>
                       <decision-name>Should the driver be suspended?</decision-name>
                   </dmn-decision-info>
               </decisions>
               <inputs>
                   <dmn-inputdata-info>
                       <inputdata-id>_CEB959CD-3638-4A87-93BA-03CD0FB63AE3</inputdata-id>
                       <inputdata-name>Violation</inputdata-name>
                       <inputdata-typeref>
                           <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                           <local-part>tViolation</local-part>
                           <prefix></prefix>
                       </inputdata-typeref>
                   </dmn-inputdata-info>
                   <dmn-inputdata-info>
                       <inputdata-id>_B0E810E6-7596-430A-B5CF-67CE16863B6C</inputdata-id>
                       <inputdata-name>Driver</inputdata-name>
                       <inputdata-typeref>
                           <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                           <local-part>tDriver</local-part>
                           <prefix></prefix>
                       </inputdata-typeref>
                   </dmn-inputdata-info>
               </inputs>
               <itemdefinitions>
                   <dmn-itemdefinition-info>
                       <itemdefinition-id>_9C758F4A-7D72-4D0F-B63F-2F5B8405980E</itemdefinition-id>
                       <itemdefinition-name>tViolation</itemdefinition-name>
                       <itemdefinition-itemcomponent>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_0B6FF1E2-ACE9-4FB3-876B-5BB30B88009B</itemdefinition-id>
                               <itemdefinition-name>Code</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60b01f4d-e407-43f7-848e-258723b5fac8</namespace-uri>
                                   <local-part>string</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_27A5DA18-3CA7-4C06-81B7-CF7F2F050E29</itemdefinition-id>
                               <itemdefinition-name>date</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                                   <local-part>date</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_8961969A-8A80-4F12-B568-346920C0F038</itemdefinition-id>
                               <itemdefinition-name>type</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                                   <local-part>string</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_7450F12A-3E95-4D5E-8DCE-2CB1FAC2BDD4</itemdefinition-id>
                               <itemdefinition-name>speed limit</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60b01f4d-e407-43f7-848e-258723b5fac8</namespace-uri>
                                   <local-part>number</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_0A9A6F26-6C14-414D-A9BF-765E5850429A</itemdefinition-id>
                               <itemdefinition-name>Actual Speed</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                                   <local-part>number</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                       </itemdefinition-itemcomponent>
                       <itemdefinition-iscollection>false</itemdefinition-iscollection>
                   </dmn-itemdefinition-info>
                   <dmn-itemdefinition-info>
                       <itemdefinition-id>_13C7EFD8-B85C-43BF-94D3-14FABE39A4A0</itemdefinition-id>
                       <itemdefinition-name>tDriver</itemdefinition-name>
                       <itemdefinition-itemcomponent>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_EC11744C-4160-4549-9610-2C757F40DFE8</itemdefinition-id>
                               <itemdefinition-name>Name</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                                   <local-part>string</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_E95BE3DB-4A51-4658-A166-02493EAAC9D2</itemdefinition-id>
                               <itemdefinition-name>Age</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                                   <local-part>number</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_7B3023E2-BC44-4BF3-BF7E-773C240FB9AD</itemdefinition-id>
                               <itemdefinition-name>State</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                                   <local-part>string</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_3D4B49DD-700C-4925-99A7-3B2B873F7800</itemdefinition-id>
                               <itemdefinition-name>city</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                                   <local-part>string</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_B37C49E8-B0D9-4B20-9DC6-D655BB1CA7B1</itemdefinition-id>
                               <itemdefinition-name>Points</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                                   <local-part>number</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                       </itemdefinition-itemcomponent>
                       <itemdefinition-iscollection>false</itemdefinition-iscollection>
                   </dmn-itemdefinition-info>
                   <dmn-itemdefinition-info>
                       <itemdefinition-id>_A4077C7E-B57A-4DEE-9C65-7769636316F3</itemdefinition-id>
                       <itemdefinition-name>tFine</itemdefinition-name>
                       <itemdefinition-itemcomponent>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_79B152A8-DE83-4001-B88B-52DFF0D73B2D</itemdefinition-id>
                               <itemdefinition-name>Amount</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                                   <local-part>number</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                           <dmn-itemdefinition-info>
                               <itemdefinition-id>_D7CB5F9C-9D55-48C2-83EE-D47045EC90D0</itemdefinition-id>
                               <itemdefinition-name>Points</itemdefinition-name>
                               <itemdefinition-typeref>
                                   <namespace-uri>https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8</namespace-uri>
                                   <local-part>number</local-part>
                                   <prefix></prefix>
                               </itemdefinition-typeref>
                               <itemdefinition-itemcomponent/>
                               <itemdefinition-iscollection>false</itemdefinition-iscollection>
                           </dmn-itemdefinition-info>
                       </itemdefinition-itemcomponent>
                       <itemdefinition-iscollection>false</itemdefinition-iscollection>
                   </dmn-itemdefinition-info>
               </itemdefinitions>
               <decisionservices/>
           </model>
       </dmn-model-info-list>
   </response>

   サンプルの JSON 出力:

   {
     "type" : "SUCCESS",
     "msg" : "OK models successfully retrieved from container 'Traffic-Violation_1.0.0-SNAPSHOT'",
     "result" : {
       "dmn-model-info-list" : {
         "models" : [ {
           "model-namespace" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
           "model-name" : "Traffic Violation",
           "model-id" : "_2CD7D1AA-BD84-4B43-AD21-B0342ADE655A",
           "decisions" : [ {
             "decision-id" : "_23428EE8-DC8B-4067-8E67-9D7C53EC975F",
             "decision-name" : "Fine"
           }, {
             "decision-id" : "_B5EEE2B1-915C-44DC-BE43-C244DC066FD8",
             "decision-name" : "Should the driver be suspended?"
           } ],
           "inputs" : [ {
             "inputdata-id" : "_CEB959CD-3638-4A87-93BA-03CD0FB63AE3",
             "inputdata-name" : "Violation",
             "inputdata-typeRef" : {
               "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
               "local-part" : "tViolation",
               "prefix" : ""
             }
           }, {
             "inputdata-id" : "_B0E810E6-7596-430A-B5CF-67CE16863B6C",
             "inputdata-name" : "Driver",
             "inputdata-typeRef" : {
               "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
               "local-part" : "tDriver",
               "prefix" : ""
             }
           } ],
           "itemDefinitions" : [ {
             "itemdefinition-id" : "_13C7EFD8-B85C-43BF-94D3-14FABE39A4A0",
             "itemdefinition-name" : "tDriver",
             "itemdefinition-typeRef" : null,
             "itemdefinition-itemComponent" : [ {
               "itemdefinition-id" : "_EC11744C-4160-4549-9610-2C757F40DFE8",
               "itemdefinition-name" : "Name",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "string",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             }, {
               "itemdefinition-id" : "_E95BE3DB-4A51-4658-A166-02493EAAC9D2",
               "itemdefinition-name" : "Age",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "number",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             }, {
               "itemdefinition-id" : "_7B3023E2-BC44-4BF3-BF7E-773C240FB9AD",
               "itemdefinition-name" : "State",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "string",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             }, {
               "itemdefinition-id" : "_3D4B49DD-700C-4925-99A7-3B2B873F7800",
               "itemdefinition-name" : "City",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "string",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             }, {
               "itemdefinition-id" : "_B37C49E8-B0D9-4B20-9DC6-D655BB1CA7B1",
               "itemdefinition-name" : "Points",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "number",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             } ],
             "itemdefinition-isCollection" : false
           }, {
             "itemdefinition-id" : "_A4077C7E-B57A-4DEE-9C65-7769636316F3",
             "itemdefinition-name" : "tFine",
             "itemdefinition-typeRef" : null,
             "itemdefinition-itemComponent" : [ {
               "itemdefinition-id" : "_79B152A8-DE83-4001-B88B-52DFF0D73B2D",
               "itemdefinition-name" : "Amount",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "number",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             }, {
               "itemdefinition-id" : "_D7CB5F9C-9D55-48C2-83EE-D47045EC90D0",
               "itemdefinition-name" : "Points",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "number",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             } ],
             "itemdefinition-isCollection" : false
           }, {
             "itemdefinition-id" : "_9C758F4A-7D72-4D0F-B63F-2F5B8405980E",
             "itemdefinition-name" : "tViolation",
             "itemdefinition-typeRef" : null,
             "itemdefinition-itemComponent" : [ {
               "itemdefinition-id" : "_0B6FF1E2-ACE9-4FB3-876B-5BB30B88009B",
               "itemdefinition-name" : "Code",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "string",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             }, {
               "itemdefinition-id" : "_27A5DA18-3CA7-4C06-81B7-CF7F2F050E29",
               "itemdefinition-name" : "Date",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "date",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             }, {
               "itemdefinition-id" : "_8961969A-8A80-4F12-B568-346920C0F038",
               "itemdefinition-name" : "Type",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "string",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             }, {
               "itemdefinition-id" : "_7450F12A-3E95-4D5E-8DCE-2CB1FAC2BDD4",
               "itemdefinition-name" : "Speed Limit",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "number",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             }, {
               "itemdefinition-id" : "_0A9A6F26-6C14-414D-A9BF-765E5850429A",
               "itemdefinition-name" : "Actual Speed",
               "itemdefinition-typeRef" : {
                 "namespace-uri" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
                 "local-part" : "number",
                 "prefix" : ""
               },
               "itemdefinition-itemComponent" : [ ],
               "itemdefinition-isCollection" : false
             } ],
             "itemdefinition-isCollection" : false
           } ],
           "decisionServices" : [ ]
         } ]
       }
     }
   }

5. モデルを実行します。

   [POST] server/containers/{containerId}/dmn

   注記

   model-namespace の属性は自動生成され、各ユーザーで異なります。model-namespace と model-name の属性がデプロイされているモデルのものに合致することを確認してください。

   curl 要求例:

   curl -u wbadmin:wbadmin -H "accept: application/json" -H "content-type: application/json" -X POST "http://localhost:8080/kie-server/services/rest/server/containers/traffic-violation_1.0.0-SNAPSHOT/dmn" -d "{ \"model-namespace\" : \"https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8\", \"model-name\" : \"Traffic Violation\", \"dmn-context\" : {\"Driver\" : {\"Points\" : 15}, \"Violation\" : {\"Type\" : \"speed\", \"Actual Speed\" : 135, \"Speed Limit\" : 100}}}"

   JSON 要求例:

   {
     "model-namespace" : "https://kiegroup.org/dmn/_60B01F4D-E407-43F7-848E-258723B5FAC8",
     "model-name" : "Traffic Violation",
     "dmn-context" :
     {
       "Driver" :
       {
     	   "Points" : 15
       },
     	"Violation" :
       {
     		"Type" : "speed",
     		"Actual Speed" : 135,
     		"Speed Limit" : 100
     	}
     }
   }

   XML 要求例 (JAXB 形式):

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <dmn-evaluation-context>
       <dmn-context xsi:type="jaxbListWrapper" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
           <type>MAP</type>
           <element xsi:type="jaxbStringObjectPair" key="Violation">
               <value xsi:type="jaxbListWrapper">
                   <type>MAP</type>
                   <element xsi:type="jaxbStringObjectPair" key="Type">
                       <value xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema">speed</value>
                   </element>
                   <element xsi:type="jaxbStringObjectPair" key="Speed Limit">
                       <value xsi:type="xs:decimal" xmlns:xs="http://www.w3.org/2001/XMLSchema">100</value>
                   </element>
                   <element xsi:type="jaxbStringObjectPair" key="Actual Speed">
                       <value xsi:type="xs:decimal" xmlns:xs="http://www.w3.org/2001/XMLSchema">135</value>
                   </element>
               </value>
           </element>
           <element xsi:type="jaxbStringObjectPair" key="Driver">
               <value xsi:type="jaxbListWrapper">
                   <type>MAP</type>
                   <element xsi:type="jaxbStringObjectPair" key="Points">
                       <value xsi:type="xs:decimal" xmlns:xs="http://www.w3.org/2001/XMLSchema">15</value>
                   </element>
               </value>
           </element>
       </dmn-context>
   </dmn-evaluation-context>

   注記

   要求には、その形式にかかわらず、以下の要素が必要です。

   • モデルの名前空間
   • モデル名
   • 入力値を含むコンテキストオブジェクト

   JSON 応答例:

   {
     "type": "SUCCESS",
     "msg": "OK from container 'Traffic-Violation_1.0.0-SNAPSHOT'",
     "result": {
         "dmn-evaluation-result": {
             "messages": [],
             "model-namespace": "https://kiegroup.org/dmn/_7D8116DE-ADF5-4560-A116-FE1A2EAFFF48",
             "model-name": "Traffic Violation",
             "decision-name": [],
             "dmn-context": {
                 "Violation": {
                   "Type": "speed",
                   "Speed Limit": 100,
                   "Actual Speed": 135
                 },
                 "Should Driver be Suspended?": "Yes",
                   "Driver": {
                     "Points": 15
                   },
                   "Fine": {
                     "Points": 7,
                     "Amount": 1000
                   }
               },
         "decision-results": {
             "_E1AF5AC2-E259-455C-96E4-596E30D3BC86": {
                 "messages": [],
                 "decision-id": "_E1AF5AC2-E259-455C-96E4-596E30D3BC86",
                 "decision-name": "Should the Driver be Suspended?",
                 "result": "Yes",
                 "status": "SUCCEEDED"
               },
             "_D7F02CE0-AF50-4505-AB80-C7D6DE257920": {
                 "messages": [],
                 "decision-id": "_D7F02CE0-AF50-4505-AB80-C7D6DE257920",
                 "decision-name": "Fine",
                 "result": {
                   "Points": 7,
                   "Amount": 1000
                 },
             "status": "SUCCEEDED"
           }
         }
       }
     }
   }

   XML (JAXB 形式) 応答例:

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <response type="SUCCESS" msg="OK from container 'Traffic_1.0.0-SNAPSHOT'">
       <dmn-evaluation-result>
           <model-namespace>https://kiegroup.org/dmn/_A4BCA8B8-CF08-433F-93B2-A2598F19ECFF</model-namespace>
           <model-name>Traffic Violation</model-name>
           <dmn-context xsi:type="jaxbListWrapper" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
               <type>MAP</type>
               <element xsi:type="jaxbStringObjectPair" key="Violation">
                   <value xsi:type="jaxbListWrapper">
                       <type>MAP</type>
                       <element xsi:type="jaxbStringObjectPair" key="Type">
                           <value xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema">speed</value>
                       </element>
                       <element xsi:type="jaxbStringObjectPair" key="Speed Limit">
                           <value xsi:type="xs:decimal" xmlns:xs="http://www.w3.org/2001/XMLSchema">100</value>
                       </element>
                       <element xsi:type="jaxbStringObjectPair" key="Actual Speed">
                           <value xsi:type="xs:decimal" xmlns:xs="http://www.w3.org/2001/XMLSchema">135</value>
                       </element>
                   </value>
               </element>
               <element xsi:type="jaxbStringObjectPair" key="Driver">
                   <value xsi:type="jaxbListWrapper">
                       <type>MAP</type>
                       <element xsi:type="jaxbStringObjectPair" key="Points">
                           <value xsi:type="xs:decimal" xmlns:xs="http://www.w3.org/2001/XMLSchema">15</value>
                       </element>
                   </value>
               </element>
               <element xsi:type="jaxbStringObjectPair" key="Fine">
                   <value xsi:type="jaxbListWrapper">
                       <type>MAP</type>
                       <element xsi:type="jaxbStringObjectPair" key="Points">
                           <value xsi:type="xs:decimal" xmlns:xs="http://www.w3.org/2001/XMLSchema">7</value>
                       </element>
                       <element xsi:type="jaxbStringObjectPair" key="Amount">
                           <value xsi:type="xs:decimal" xmlns:xs="http://www.w3.org/2001/XMLSchema">1000</value>
                       </element>
                   </value>
               </element>
               <element xsi:type="jaxbStringObjectPair" key="Should the driver be suspended?">
                   <value xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema">Yes</value>
               </element>
           </dmn-context>
           <messages/>
           <decisionResults>
               <entry>
                   <key>_4055D956-1C47-479C-B3F4-BAEB61F1C929</key>
                   <value>
                       <decision-id>_4055D956-1C47-479C-B3F4-BAEB61F1C929</decision-id>
                       <decision-name>Fine</decision-name>
                       <result xsi:type="jaxbListWrapper" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
                           <type>MAP</type>
                           <element xsi:type="jaxbStringObjectPair" key="Points">
                               <value xsi:type="xs:decimal" xmlns:xs="http://www.w3.org/2001/XMLSchema">7</value>
                           </element>
                           <element xsi:type="jaxbStringObjectPair" key="Amount">
                               <value xsi:type="xs:decimal" xmlns:xs="http://www.w3.org/2001/XMLSchema">1000</value>
                           </element>
                       </result>
                       <messages/>
                       <status>SUCCEEDED</status>
                   </value>
               </entry>
               <entry>
                   <key>_8A408366-D8E9-4626-ABF3-5F69AA01F880</key>
                   <value>
                       <decision-id>_8A408366-D8E9-4626-ABF3-5F69AA01F880</decision-id>
                       <decision-name>Should the driver be suspended?</decision-name>
                       <result xsi:type="xs:string" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Yes</result>
                       <messages/>
                       <status>SUCCEEDED</status>
                   </value>
               </entry>
           </decisionResults>
       </dmn-evaluation-result>
   </response>

手順

1. サンプルを実行するには、rhpam-7.13.4-planner-engine/examples ディレクトリーで以下のコマンドのいずれかを入力します。

   Linux または Mac の場合:

   $ ./runExamples.sh

   Windows:

   $ runExamples.bat

   OptaPlanner Example ウィンドウが開きます。

2. 実行するサンプルを選択します。

手順

1. OptaPlanner の例を新規プロジェクトとして開きます。

   1. IntelliJ または Netbeans の場合は、新規プロジェクトとして examples/sources/pom.xml を開きます。Maven 統合の指示に従い、インストールを進めてください。この手順では、残りのステップは省略します。
   2. Eclipse の場合は、rhpam-7.13.4-planner-engine ディレクトリーにある /examples/binaries ディレクトリーの新規プロジェクトを開きます。
2. binaries ディレクトリーにあるすべての JAR ファイルをクラスパスに追加します (examples/binaries/optaplanner-examples-7.67.0.Final-redhat-00024.jar ファイルを除く)。
3. rhpam-7.13.4-planner-engine/examples/sources/ ディレクトリーにある Java ソース src/main/java ディレクトリーと Java リソースディレクトリー src/main/resources を追加します。

4. 実行設定を作成します。

   • メインクラス: org.optaplanner.examples.app.OptaPlannerExamplesApp
   • VM パラメーター (任意): -Xmx512M -server -Dorg.optaplanner.examples.dataDir=examples/sources/data
   • 作業ディレクトリー: examples/sources
5. 実行設定を実行します。

手順

1. Business Central で Menu → Design → Projects の順にクリックします。
2. 事前に設定した MySpace スペースで Try Samples をクリックします。
3. サンプルプロジェクトのリストから employee-rostering を選択し、右上の OK をクリックして、プロジェクトをインポートします。
4. アセットリストをコンパイルし、Build & Deploy をクリックして、従業員の勤務表サンプルをデプロイします。

手順

1. コマンドターミナルで以下のコマンドを入力し、Maven が JDK 11 を使用していること、そして Maven のバージョンが 3.6 以上であることを確認します。

   mvn --version

2. 上記のコマンドで JDK 11 が返されない場合は、JDK 11 へのパスを PATH 環境変数に追加し、上記のコマンドを再度入力します。

3. Quarkus OptaPlanner クイックスタートプロジェクトを生成するには、以下のコマンドを入力します。

   mvn com.redhat.quarkus.platform:quarkus-maven-plugin:2.13.Final-redhat-00006:create \
       -DprojectGroupId=com.example \
       -DprojectArtifactId=optaplanner-quickstart  \
       -Dextensions="resteasy,resteasy-jackson,optaplanner-quarkus,optaplanner-quarkus-jackson" \
       -DplatformGroupId=com.redhat.quarkus.platform
       -DplatformVersion=2.13.Final-redhat-00006 \
       -DnoExamples

   このコマンドは、./optaplanner-quickstart ディレクトリーで以下の要素を作成します。

   • Maven の構造
   • src/main/docker の Dockerfile ファイルの例

   • アプリケーションの設定ファイル

     表12.1 mvn io.quarkus:quarkus-maven-plugin:2.13.Final-redhat-00006:create コマンドで使用したプロパティー

     プロパティー	説明
     projectGroupId	プロジェクトのグループ ID。
     projectArtifactId	プロジェクトのアーティファクト ID。
     extensions	このプロジェクトで使用する Quarkus 拡張のコンマ区切りリスト。Quarkus 拡張の全リストは、特定のコマンドラインで mvn quarkus:list-extensions を入力します。
     noExamples	テストまたはクラスを使用せずに、プロジェクト構造でプロジェクトを作成します。

     projectGroupID および projectArtifactID プロパティーの値を使用して、プロジェクトバージョンを生成します。デフォルトのプロジェクトバージョンは 1.0.0-SNAPSHOT です。

4. OptaPlanner プロジェクトを表示するには、OptaPlanner Quickstarts ディレクトリーに移動します。

   cd optaplanner-quickstart

5. pom.xml ファイルを確認します。コンテンツの例を以下に示します。

   <dependencyManagement>
     <dependencies>
       <dependency>
         <groupId>io.quarkus.platform</groupId>
         <artifactId>quarkus-bom</artifactId>
         <version>2.13.Final-redhat-00006</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>
       <dependency>
         <groupId>io.quarkus.platform</groupId>
         <artifactId>quarkus-optaplanner-bom</artifactId>
         <version>2.13.Final-redhat-00006</version>
         <type>pom</type>
         <scope>import</scope>
       </dependency>
     </dependencies>
   </dependencyManagement>
   <dependencies>
     <dependency>
       <groupId>io.quarkus</groupId>
       <artifactId>quarkus-resteasy</artifactId>
     </dependency>
     <dependency>
       <groupId>io.quarkus</groupId>
       <artifactId>quarkus-resteasy-jackson</artifactId>
     </dependency>
     <dependency>
       <groupId>org.optaplanner</groupId>
       <artifactId>optaplanner-quarkus</artifactId>
     </dependency>
     <dependency>
       <groupId>org.optaplanner</groupId>
       <artifactId>optaplanner-quarkus-jackson</artifactId>
     </dependency>
     <dependency>
       <groupId>io.quarkus</groupId>
       <artifactId>quarkus-junit5</artifactId>
       <scope>test</scope>
     </dependency>
   </dependencies>

手順

1. Web ブラウザーで https://code.quarkus.redhat.com を開きます。
2. プロジェクトの詳細を指定します。
3. プロジェクトのグループ名を入力します。名前の形式は、Java パッケージ命名規則に従います (例: com.example)。
4. プロジェクトから生成された Maven アーティファクトに使用する名前を入力します (例: code-with-quarkus)。

5. Build Tool > Maven を選択して、作成するプロジェクトが Maven プロジェクトであることを指定します。選択するビルドツールにより、以下の項目が決定されます。

   • 生成されたプロジェクトのディレクトリー構造。
   • 生成されたプロジェクトで使用される設定ファイルの形式。

   • アプリケーションのコンパイルおよび起動用のカスタムビルドスクリプトおよびコマンド (プロジェクトの生成後に code.quarkus.redhat.com が表示)。

     注記

     Red Hat は、code.quarkus.redhat.com を使用した OptaPlanner Maven プロジェクトの作成だけをサポートします。Red Hat では、Gradle プロジェクトの生成はサポートしていません。

6. プロジェクトから生成されたアーティファクトで使用するバージョンを入力します。このフィールドのデフォルト値は 1.0.0-SNAPSHOT です。semantic versioning の使用が推奨されますが、必要に応じて、別のタイプのバージョンを使用できます。

7. プロジェクトをパッケージ化する時に、ビルドツールが生成するアーティファクトのパッケージ名を入力します。

   パッケージ名は、Java パッケージの命名規則に従い、プロジェクトに使用するグループ名と一致するはずですが、別の名前を指定することもできます。

   注記

   code.quarkus.redhat.com Web サイトは、OptaPlanner の最新リリースを自動的に使用します。プロジェクトの生成後に、pom.xml ファイルで BOM バージョンを手動で変更できます。

8. 以下の拡張を選択して、依存関係として組み込みます。

   • RESTEasy JAX-RS (quarkus-resteasy)
   • RESTEasy Jackson (quarkus-resteasy-jackson)
   • OptaPlanner AI 制約ソルバー (optaplanner-quarkus)

   • OptaPlanner Jackson (optaplanner-quarkus-jackson)

     Red Hat は、リストにある個別の拡張に対してさまざまなレベルのサポートを提供します。レベルは、各拡張名の横にあるラベルで示されています。

     • SUPPORTED 拡張: Red Hat は、実稼働環境のエンタープライズアプリケーションでの使用を完全にサポートします。
     • TECH-PREVIEW 拡張: Red Hat は、テクノロジープレビュー機能のサポート範囲 に基づき、限定的に、実稼働環境でのサポートを提供します。
     • DEV-SUPPORT 拡張: Red Hat は、実稼働環境での使用をサポートしていません。ただし、新規アプリケーションの開発での使用に対しては、Red Hat 開発者がこれらのコア機能をサポートしています。

     • DEPRECATED 拡張: 同じ機能を提供する新しいテクノロジーまたは実装に置き換える予定です。

       Red Hat では、ラベル付けされていない拡張の実稼働環境での使用はサポートしていません。

9. Generate your application を選択して選択内容を確認し、生成されたプロジェクトを含むアーカイブのダウンロードリンクのオーバーレイ画面を表示します。オーバーレイ画面には、アプリケーションのコンパイルおよび起動に使用できるカスタムコマンドも表示されます。
10. Download the ZIP を選択して、生成されたプロジェクトファイルを含むアーカイブをマシンに保存します。
11. アーカイブの内容をデプロイメントします。

12. デプロイメントしたプロジェクトファイルが含まれるディレクトリーに移動します。

    cd <directory_name>

13. 開発モードでアプリケーションをコンパイルして起動します。

    ./mvnw compile quarkus:dev

手順

1. Quarkus アプリケーションを作成します。

   quarkus create app -P io.quarkus:quarkus-bom:2.13.Final-redhat-00006

2. 利用可能な拡張機能を表示するには、以下のコマンドを入力します。

   quarkus ext -i

   このコマンドは、以下の拡張機能を返します。

   optaplanner-quarkus
   optaplanner-quarkus-benchmark
   optaplanner-quarkus-jackson
   optaplanner-quarkus-jsonb

3. 以下のコマンドを入力して、エクステンションをプロジェクトの pom.xml ファイルに追加します。

   quarkus ext add resteasy-jackson
   quarkus ext add optaplanner-quarkus
   quarkus ext add optaplanner-quarkus-jackson

4. テキストエディターで pom.xml ファイルを開きます。ファイルの内容は以下の例のようになります。

   <?xml version="1.0"?>
   <project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd" xmlns="http://maven.apache.org/POM/4.0.0"
   	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
     <modelVersion>4.0.0</modelVersion>
     <groupId>org.acme</groupId>
     <artifactId>code-with-quarkus-optaplanner</artifactId>
     <version>1.0.0-SNAPSHOT</version>
     <properties>
   	<compiler-plugin.version>3.8.1</compiler-plugin.version>
   	<maven.compiler.parameters>true</maven.compiler.parameters>
   	<maven.compiler.source>11</maven.compiler.source>
   	<maven.compiler.target>11</maven.compiler.target>
   	<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
   	<project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
   	<quarkus.platform.artifact-id>quarkus-bom</quarkus.platform.artifact-id>
   	<quarkus.platform.group-id>io.quarkus</quarkus.platform.group-id>
   	<quarkus.platform.version>2.13.Final-redhat-00006</quarkus.platform.version>
   	<surefire-plugin.version>3.0.0-M5</surefire-plugin.version>
     </properties>
     <dependencyManagement>
   	<dependencies>
     	<dependency>
       	<groupId>${quarkus.platform.group-id}</groupId>
       	<artifactId>${quarkus.platform.artifact-id}</artifactId>
       	<version>${quarkus.platform.version}</version>
       	<type>pom</type>
       	<scope>import</scope>
     	</dependency>
     	<dependency>
       	<groupId>io.quarkus.platform</groupId>
       	<artifactId>optaplanner-quarkus</artifactId>
       	<version>2.2.2.Final</version>
       	<type>pom</type>
       	<scope>import</scope>
     	</dependency>
   	</dependencies>
     </dependencyManagement>
     <dependencies>
   	<dependency>
     	<groupId>io.quarkus</groupId>
     	<artifactId>quarkus-arc</artifactId>
   	</dependency>
   	<dependency>
     	<groupId>io.quarkus</groupId>
     	<artifactId>quarkus-resteasy</artifactId>
   	</dependency>
   	<dependency>
     	<groupId>org.optaplanner</groupId>
     	<artifactId>optaplanner-quarkus</artifactId>
   	</dependency>
   	<dependency>
     	<groupId>org.optaplanner</groupId>
     	<artifactId>optaplanner-quarkus-jackson</artifactId>
   	</dependency>
   	<dependency>
     	<groupId>io.quarkus</groupId>
     	<artifactId>quarkus-resteasy-jackson</artifactId>
   	</dependency>
   	<dependency>
     	<groupId>io.quarkus</groupId>
     	<artifactId>quarkus-junit5</artifactId>
     	<scope>test</scope>
   	</dependency>
   	<dependency>
     	<groupId>io.rest-assured</groupId>
     	<artifactId>rest-assured</artifactId>
     	<scope>test</scope>
   	</dependency>
     </dependencies>
     <build>
   	<plugins>
     	<plugin>
       	<groupId>${quarkus.platform.group-id}</groupId>
       	<artifactId>quarkus-maven-plugin</artifactId>
       	<version>${quarkus.platform.version}</version>
       	<extensions>true</extensions>
       	<executions>
         	<execution>
           	<goals>
             	<goal>build</goal>
             	<goal>generate-code</goal>
             	<goal>generate-code-tests</goal>
           	</goals>
         	</execution>
       	</executions>
     	</plugin>
     	<plugin>
       	<artifactId>maven-compiler-plugin</artifactId>
       	<version>${compiler-plugin.version}</version>
       	<configuration>
         	<parameters>${maven.compiler.parameters}</parameters>
       	</configuration>
     	</plugin>
     	<plugin>
       	<artifactId>maven-surefire-plugin</artifactId>
       	<version>${surefire-plugin.version}</version>
       	<configuration>
         	<systemPropertyVariables>
           	<java.util.logging.manager>org.jboss.logmanager.LogManager</java.util.logging.manager>
           	<maven.home>${maven.home}</maven.home>
         	</systemPropertyVariables>
       	</configuration>
     	</plugin>
   	</plugins>
     </build>
     <profiles>
   	<profile>
     	<id>native</id>
     	<activation>
       	<property>
         	<name>native</name>
       	</property>
     	</activation>
     	<build>
       	<plugins>
         	<plugin>
           	<artifactId>maven-failsafe-plugin</artifactId>
           	<version>${surefire-plugin.version}</version>
           	<executions>
             	<execution>
               	<goals>
                 	<goal>integration-test</goal>
                 	<goal>verify</goal>
               	</goals>
               	<configuration>
                 	<systemPropertyVariables>
                   	<native.image.path>${project.build.directory}/${project.build.finalName}-runner</native.image.path>
                   	<java.util.logging.manager>org.jboss.logmanager.LogManager</java.util.logging.manager>
                   	<maven.home>${maven.home}</maven.home>
                 	</systemPropertyVariables>
               	</configuration>
             	</execution>
           	</executions>
         	</plugin>
       	</plugins>
     	</build>
     	<properties>
       	<quarkus.package.type>native</quarkus.package.type>
     	</properties>
   	</profile>
     </profiles>
   </project>