手順

1. Business Central で、Menu → Design → Projects に移動します。既存のプロジェクトがある場合には、MySpace のデフォルトのスペースをクリックして、Add Project プルダウンメニューから Try Samples を選択して、サンプルにアクセスできます。既存のプロジェクトがない場合には、Try samples をクリックします。
2. IT_Orders を選択し、OK をクリックします。
3. Assets ウィンドウで orderhardware ビジネスプロセスをクリックしてデザイナーを開きます。
4. キャンバスの空きスペースをクリックし、右上隅の Properties アイコンをクリックします。
5. 下方向にスクロールして、Case Management を展開します。
6. ID-XXXXXXXXXX 形式で Case ID Prefix を入力します。XXXXXXXXXX は、生成された番号で、ケースインスタンスの一意の ID を指定します。接頭辞が指定されていない場合には、デフォルトのセットうじとして、以下の ID に CASE が付けられます。

手順

1. Business Central で、Menu → Design → Projects に移動します。既存のプロジェクトがある場合には、MySpace のデフォルトのスペースをクリックして、Add Project プルダウンメニューから Try Samples を選択して、サンプルにアクセスできます。既存のプロジェクトがない場合には、Try samples をクリックします。
2. IT_Orders を選択し、OK をクリックします。
3. Assets ウィンドウで orderhardware ビジネスプロセスをクリックしてデザイナーを開きます。
4. キャンバスの空きスペースをクリックし、右上隅の Properties アイコンをクリックします。
5. Advanced メニューを展開して Metadata Attributes フィールドにアクセスします。

6. customCaseIdPrefix メタデータ属性の以下の関数を 1 つ指定します。

   • LPAD - 左パディング
   • RPAD - 右パディング
   • TRUNCATE - 省略
   • UPPER - 大文字

手順

1. Web ブラウザーで、以下の URL を開きます。

   /http://localhost:8080/kie-server/docs

2. Case instances :: Case Management で利用可能なエンドポイントの一覧を開きます。

3. 以下の POST メソッドのエンドポイントをクリックし、詳細を開きます。

   /server/containers/{id}/cases/instances/{caseId}/tasks

4. Try it out をクリックしてから、以下のパラメーターを入力します。

   表6.1 パラメーター

   名前	説明
   id	itorders
   caseId	IT-0000000001

   本文

   {
    "name" : "RequestManagerApproval",
    "data" : {
      "reason" : "Fixed hardware spec",
      "caseFile_hwSpec" : "#{caseFile_hwSpec}"
     },
    "subject" : "Ask for manager approval again",
    "actors" : "manager",
    "groups" : ""
   }

5. Swagger アプリケーションで、Execute をクリックして動的タスクを作成します。

手順

1. Web ブラウザーで、以下の URL を開きます。

   /http://localhost:8080/kie-server/docs

2. Case instances :: Case Management で利用可能なエンドポイントの一覧を開きます。

3. 以下の POST メソッドのエンドポイントをクリックし、詳細を開きます。

   /server/containers/{id}/cases/instances/{caseId}/stages/{caseStageId}/tasks

4. Try it out をクリックしてから、以下のパラメーターを入力します。

   表6.2 パラメーター

   名前	説明
   id	itorders
   caseId	IT-0000000001

   本文

   {
    "name" : "InvokeService",
    "data" : {
      "Parameter" : "Fixed hardware spec",
      "Interface" : "org.jbpm.demo.itorders.services.ITOrderService",
      "Operation" : "printMessage",
      "ParameterType" : "java.lang.String"
     },
    "nodeType" : "Service Task"
   }

5. Swagger アプリケーションで、Execute をクリックして動的タスクを作成します。

手順

1. Web ブラウザーで、以下の URL を開きます。

   /http://localhost:8080/kie-server/docs

2. Case instances :: Case Management で利用可能なエンドポイントの一覧を開きます。

3. 以下の POST メソッドのエンドポイントをクリックし、詳細を開きます。

   /server/containers/{id}/cases/instances/{caseId}/processes/{pId}

4. Try it out をクリックして以下のパラメーターを入力します。

   表6.3 パラメーター

   名前	説明
   id	itorders
   caseId	IT-0000000001
   pId	itorders-data.place-order

   pId は、作成するサブプロセスのプロセス ID です。

   本文

   {
    "placedOrder" : "Manually"
   }

5. Swagger アプリケーションで、Execute をクリックして動的サブプロセスを開始します。

手順

1. ケースに関連するロールを定義するには、エディターのキャンバスの空いているスペースをクリックします。 をクリックして Properties メニューをクリックします。

2. Case Management を展開してケースロールを追加します。

   ケースのロールには、ロールの名前とケースカーディナリティーが必要です。ケースカーディナリティーとは、ケースインスタンスでロールに割り当てられたアクターの数です。たとえば、IT_Orders サンプルのケース管理プロジェクトには、以下のロールが含まれます。

   図8.1 ITOrders ケースロール

   

   この例では、ケースの owner にアクター (ユーザーまたはグループ) 1 つのみを、manager ロールには 1 つのアクターのみを割り当てることができます。supplier ロールには、アクターを 2 つ割り当てることができます。ケースによっては、ロールに設定済みのケースカーディナリティーをもとに、特定のロールにいくつでもアクターを割り当てることができます。

手順

1. 以下のエンドポイントで POST REST API コールを作成します。

   http://host:port/kie-server/services/rest/server/containers/itorders/cases/itorders.orderhardware/instances

   • itorders: KIE Server でデプロイしているコンテナーエイリアス。
   • itorders.orderhardware: ケース定義の名前。

2. 要求の本文に以下のロール設定を追加します。

   {
     "case-data" : {  },
     "case-user-assignments" : {
       "owner" : "cami",
       "manager" : "cami"
     },
     "case-group-assignments" : {
       "supplier" : "IT"
    }
   }

手順

1. Tasks 一覧を開き、プロセス設定パレットにケース定義を追加するユーザーまたはサービスタスクをドラッグします。
2. タスクノードを選択して、 をクリックし、デザイナーの右側の Properties パネルを開きます。

3. Implementation/Execution を展開し、Actors プロパティーの下にある Add をクリックして、タスクを割り当てるロール名を選択するか、入力します。グループの割当も同じように、Groups プロパティーを使用します。

   たとえば、IT_Orders のサンプルプロジェクトでは、Manager approval ユーザータスクが manager ロールに割り当てられています。

   

   この例では、Prepare hardware spec ユーザータスクが完了すると、manager ロールに割り当てられているユーザーは、Business Central の Task Inbox で Manager approval を受け取ります。

手順

1. Showcase アプリケーションで、Case list から作業するケースをクリックし、ケースの概要を開きます。

2. ページの右下の Roles ボックスで、変更するロール割り当てを探します。

   
3. ロールの割り当てからユーザまたはグループを削除するには、対象のロール割り当ての横にある をクリックします。確認ウィンドウで、Remove をクリックして、ロールからユーザーまたはグループを削除します。
4. ロールからロール割り当てすべてを削除するには、ロールの横にある をクリックして、Remove all assignments オプションを選択します。確認ウィンドウで、Remove をクリックして、ロールからユーザーとグループ割り当てすべてを削除します。
5. ロール割り当てを別のユーザーやグループに変更するには、ロールの横にある をクリックして、Edit オプションを選択します。

6. Edit role assignment ウィンドウで、ロール割り当てから削除する割り当て先の名前を削除します。ロールに割り当てるユーザーの名前を User フィールドに入力するか、割り当てるグループを Group フィールドに追加します。

   ロール割り当ての編集時に、1 つ以上のユーザーまたはグループが割り当てられている必要があります。

7. Assign をクリックしてルールの割り当てを完了します。

手順

1. 以下のエンドポイントで GET リクエストを使用して現在のロール割り当ての一覧を取得します。

   /http://localhost:8080/kie-server/services/rest/server/containers/{id}/cases/instances/{caseId}/roles

   表8.1 パラメーター

   名前	説明
   id	itorders
   caseId	IT-0000000001

   これにより、以下の応答が返されます。

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <case-role-assignment-list>
         <role-assignments>
               <name>owner</name>
               <users>Aimee</users>
         </role-assignments>
         <role-assignments>
               <name>manager</name>
               <users>Katy</users>
         </role-assignments>
         <role-assignments>
               <name>supplier</name>
               <groups>Lenovo</groups>
         </role-assignments>
   </case-role-assignment-list>

2. manager ロールに割り当てられているユーザーを変更する場合は、最初に DELETE を使用して、ユーザー Katy からロール割り当てを削除する必要があります。

   /server/containers/{id}/cases/instances/{caseId}/roles/{caseRoleName}

   Swagger クライアントリクエストに以下の情報を追加します。

   表8.2 パラメーター

   名前	説明
   id	itorders
   caseId	IT-0000000001
   caseRoleName	manager
   user	Katy

   Execute をクリックします。

3. 最初の手順の GET リクエストを再実行し、manager ロールがユーザーに割り当てられなくなったことを確認します。

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <case-role-assignment-list>
         <role-assignments>
               <name>owner</name>
               <users>Aimee</users>
         </role-assignments>
         <role-assignments>
               <name>manager</name>
         </role-assignments>
         <role-assignments>
               <name>supplier</name>
               <groups>Lenovo</groups>
         </role-assignments>
   </case-role-assignment-list>

4. 以下のエンドポイントで PUT リクエストを使用して、Cami ユーザーを manager ロールに割り当てます。

   /server/containers/{id}/cases/instances/{caseId}/roles/{caseRoleName}

   Swagger クライアントリクエストに以下の情報を追加します。

   表8.3 パラメーター

   名前	説明
   id	itorders
   caseId	IT-0000000001
   caseRoleName	manager
   user	Cami

   Execute をクリックします。

5. 最初の手順の GET リクエストを再実行し、manager ロールが Cami に割り当てられていることを確認します。

   <?xml version="1.0" encoding="UTF-8" standalone="yes"?>
   <case-role-assignment-list>
         <role-assignments>
               <name>owner</name>
               <users>Aimee</users>
         </role-assignments>
         <role-assignments>
               <name>manager</name>
               <users>Cami</users>
         </role-assignments>
         <role-assignments>
               <name>supplier</name>
               <groups>Lenovo</groups>
         </role-assignments>
   </case-role-assignment-list>

手順

1. ダイアグラムエディターの左側にある事前定義済みのノードパネルから、Ad-Hoc ノードをデザインキャンバスにドラッグアンドドロップして、ステージノードの名前を指定します。

2. ステージをアクティベートする方法を定義します。

   • 受信ノードがステージをアクティベートした場合は、ステージを、受信ノードのシーケンスフローラインに接続します。
   • シグナルイベントで、このステージが代わりにアクティベートされている場合は、シグナルイベントに、最初の手順で設定したステージの名前で SignalRef を設定します。
   • または、条件が満たされると、ステージをアクティベートするように AdHocActivationCondition プロパティーを設定します。
3. ステージにタスクノードを追加する余裕を持たせるために、必要に応じてノードのサイズを変更します。
4. 関連タスクをステージに追加して、必要に応じて設定します。

5. (任意) ステージの完了条件を設定します。アドホックサブプロセスとして、ステージはデフォルトで autocomplete として設定されます。これは、ステージが自動的に完了し、ステージ内のすべてのインスタンスがアクティブでなくなると、ケース定義の次のアクティビティーが発生することを示しています。

   完了条件を変更するには、ステージノードを選択して、右側の Properties パネルを選択し、Implementation/Execution を展開して、 必要な完了条件になるように free-form Drools 式を使用して AdHocCompletionCondition を変更します。ステージ完了条件に関する情報は、「ステージのアクティベーションおよび完了条件の設定」を参照してください。

6. ステージを設定したら、シーケンスフローラインを使用して、ケース定義内の次のアクティビティーに接続します。

手順

1. ステージを選択して、 をクリックし、デザイナーの右側の Properties パネルを開きます。
2. Implementation/Execution を展開して、AdHocActivationCondition プロパティーエディターを開き、開始ノードのアクティベーション条件を定義します。たとえば、autostart: true と設定して、新規ケースインスタンスが開始されたら、ステージが自動的にアクティベートされるようにします。
3. AdHocCompletionCondition はデフォルトでは、autocomplete に設定されています。これを変更するには、free-form Drools 式を使用して完了条件を入力します。たとえば、org.kie.api.runtime.process.CaseData(data.get("ordered") == true) と設定して、以前の例の 2 つ目のステージをアクティベートします。

手順

1. Showcase アプリケーションを使用して新規ケースインスタンスを開始します。Showcase の使用に関する情報は、『ケース管理への Showcase アプリケーションの使用』を参照してください。

   このケースはステージを使用して作成されているため、ケース詳細ページにはステージの追跡が表示されます。

   

   最初のステージは、ケースインスタンスの開始時に自動的に開始します。

2. manager ユーザーとして、Business Central の Menu → Track → Task Inbox の下で、ハードウェア明細書を承認し、ケースの進捗を確認します。

   1. Business Central で Menu → Manage → Process Instances の順にクリックし、アクティブケースインスタンス IT-0000000001 を開きます。
   2. Diagram をクリックして、ケースの進捗を表示します。

3. Web ブラウザーで、以下の URL を開きます。

   /http://localhost:8080/kie-server/docs

4. Case instances :: Case Management で利用可能なエンドポイントの一覧を開きます。

5. 以下の POST メソッドのエンドポイントをクリックし、詳細を開きます。

   /server/containers/{id}/cases/instances/{caseId}/stages/{caseStageId}/tasks

6. Try it out をクリックして、以下のパラメーターを完了します。

   表9.1 パラメーター

   名前	説明
   id	itorders
   caseId	IT-0000000001
   caseStageId	Order delivery

   caseStageId は、ケース定義に含まれるステージ名です。このケース定義で、動的タスクが作成されます。これには、動的またはサービスタスクペイロードを指定できます。サンプルについては、「REST API を使用した動的サブプロセスの作成」または「REST API を使用した動的サービスタスクの作成」を参照してください。

手順

1. ダイアグラムエディターの左側にある事前定義済みのノードパネルから、Milestone オブジェクトをパレットにドラッグアンドドロップします。

   
2. マイルストーンを選択して、 をクリックし、デザイナーの右側の Properties パネルを開きます。
3. Data Assignments を展開して完了条件を追加します。マイルストーンには、デフォルトで condition パラメーターが含まれます。
4. マイルストーンに完了条件を定義するには、Source 一覧から Constant を選択します。条件は Drools 構文で定義する必要があります。

5. Implementation/Execution を展開して、Adhoc Autostart プロパティーを設定します。

   • ケースインスタンスの開始時に自動的に開始する必要があるマイルストーンの場合は、チェックボックスを選択して、このプロパティーを true に設定します。
   • シグナルイベントで発生させるマイルストーンの場合は、チェックボックスを選択せずに、このプロパティーを false に設定します。

6. (任意) ケースゴールが達成した場合にマイルストーンを発生させるシグナルイベントを設定します。

   1. ケース設計パレットでシグナルイベントを選択した状態で、右側に Properties パネルを開きます。
   2. Signal Scope プロパティーを Process Instance に設定します。

   3. SignalRef 式エディターを開いて、発生させるマイルストーンの名前を入力します。

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

手順

1. validate-document.drl という名前で、以下のビジネスルールファイルを作成します。

   package defaultPackage;
   
   import java.util.Map;
   import java.util.HashMap;
   import org.jbpm.casemgmt.api.CaseService;
   import org.jbpm.casemgmt.api.model.instance.CaseFileInstance;
   import org.jbpm.document.Document;
   import org.jbpm.services.api.service.ServiceRegistry;
   
   rule "Invalid document name - reupload"
   when
       $caseData : CaseFileInstance()
       Document(name == "invalid.pdf") from $caseData.getData("hwSpec")
   
   then
   
       System.out.println("Hardware specification is invalid");
       $caseData.remove("hwSpec");
       update($caseData);
       CaseService caseService = (CaseService) ServiceRegistry.get().service(ServiceRegistry.CASE_SERVICE);
       caseService.triggerAdHocFragment($caseData.getCaseId(), "Prepare hardware spec", null);
   end

   このビジネスルールは、invalid.pdf ファイルをケースファイルにアップロードしたタイミングを検出します。これは invalid.pdf ドキュメントを削除し、Prepare hardware spec ユーザータスクの新しいインスタンスを作成します。

2. Deploy をクリックして、IT_Orders プロジェクトをビルドし、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 オプションを選択します。デフォルトでは、KIE Server および Business Central のすべての新規プロジェクトは開発モードになっています。Development Mode をオンにしたプロジェクトをデプロイしたり、実稼働モードになっている KIE Server に手動で SNAPSHOT バージョンの接尾辞を追加したプロジェクトをデプロイしたりすることはできません。

3. invalid.pdf ファイルを作成し、ローカルで保存します。
4. valid-spec.pdf ファイルを作成し、ローカルで保存します。
5. Business Central で、Menu → Projects → IT_Orders に移動して、IT_Orders プロジェクトを開きます。
6. ページの右上で Import Asset をクリックします。

7. validate-document.drl ファイルを default パッケージ (src/main/resources) にアップロードし、Ok をクリックします。

   

   validate-document.drl ルールがルールエディターに表示されます。Save をクリックするか、ルールエディターを閉じて終了します。

8. Apps launcher (インストールされている場合) をクリックするか、/http://localhost:8080/rhpam-case-mgmt-showcase/jbpm-cm.html に移動して、Showcase アプリケーションを開きます。

9. IT_Orders の Start Case をクリックします。

   この例では、Aimee がケースの owner、Katy が manager、および業者グループが supplier になります。

   
10. Business Central からログアウトし、supplier グループに属するユーザーでログインし直します。
11. Menu → Track → Task Inbox に移動します。
12. Prepare hardware spec タスクを開いて、Claim をクリックします。これにより、タスクがログインユーザーに割り当てられます。

13. Start をクリックして をクリックし、 invalid.pdf ハードウェア仕様ファイルの場所を特定します。 をクリックしてファイルをアップロードします。

    

14. Complete をクリックします。

    Prepare hardware spec の Task Inbox の値が Ready になります。

15. Showcase で、右上隅の Refresh をクリックします。Prepare hardware task メッセージが Completed の列と、In Progress の列に表示されていることを確認します。

    

    これは、最初の Prepare hardware spec タスクが明細書ファイル invalid.pdf を使用して完了されているためです。その結果、ビジネスルールによりタスクおよびファイルが破棄され、新しいユーザータスクが作成されます。

16. Business Central の Task Inbox で手順 12 および 13 を繰り返し、invalid.pdf の代わりに valid-spec.pdf ファイルをアップロードします。

手順

1. 任意のエディターで、JBOSS_HOME/standalone/deployments/kie-server.war/WEB-INF/classes/case-authorization.properties ファイルを開きます。

   デフォルトでは、ファイルには以下の操作制限が含まれます。

   CLOSE_CASE=owner,admin
   CANCEL_CASE=owner,admin
   DESTROY_CASE=owner,admin
   REOPEN_CASE=owner,admin

2. この操作に対するロールパーミッションを追加または削除します。

   1. ロールが操作を実行するためのパーミッションを削除するには、case-authorization.properties ファイルでその操作に対して認証されているロールの一覧から削除します。たとえば、admin ロールを CLOSE_CASE 操作から削除すると、すべてのケースで、そのケース所有者に対してケースを閉じるパーミッションに制限がかかります。

   2. ケース操作を実行するロールパーミッションを付与するには、case-authorization.properties ファイルでその操作に対して承認されているロールの一覧に追加します。たとえば、manager ロールがあれば CLOSE_CASE 操作を実行できるように許可する場合は、ロールの一覧に、コンマ区切りのロールを追加できます。

      CLOSE_CASE=owner,admin,manager

3. ファイルに挙げられているその他のケース操作にロール制限を追加するには、行から # を削除し、以下の形式でロール名を一覧表示します。

   OPERATION=role1,role2,roleN

   ファイル内で # で始まる操作の制限は無視され、ケースに関与するユーザーは誰でも実行できます。

4. ロールパーミッションの割り当てを終了したら、case-authorization.properties ファイルを保存して閉じます。

5. 実行サーバーを開始します。

   ケース認証設定は、実行サーバーのすべてのケースに適用します。

手順

1. Web ブラウザーで Swagger REST API クライアントを開きます。

   /http://localhost:8080/kie-server/docs

2. Case Instances :: Case Management の下で、以下のエンドポイントで POST リクエストを開きます。

   /server/containers/{id}/cases/instances/{caseId}

3. Try it out をクリックし、必要なパラメーターを入力します。

   表15.1 パラメーター

   名前	説明
   id	itorders
   caseId	IT-0000000001

4. 任意で、ケースファイルに含まれるコメントを追加できます。コメントを残す場合は、body テキストフィールドに 文字列 で入力します。
5. Execute をクリックして、ケースを閉じます。
6. ケースが閉じたことを確定するには、Showcase アプリケーションを開いて、ケースリストのステータスを Closed に変更します。

手順

1. Showcase アプリケーションで、ケースインスタンスの一覧から閉じるケースインスタンスを見つけます。
2. 詳細を確認せずに先にケースを終了するには、Close をクリックします。

3. ケース詳細ページからケースを閉じるには、リストでケースをクリックして、開きます。

   ケースの概要ページで、ケースにコメントを追加して、ケース情報に基づいて正しいケースを閉じていることを確認します。

4. Close をクリックして、ケースを閉じます。
5. ページ右上で Back to Case List をクリックし、Showcase ケース一覧ビューに戻ります。
6. Status の横にあるドロップダウンリストをクリックし、Canceled をクリックすると、閉じたケースおよびキャンセルしたケースの一覧が表示されます。