第7章 ケースロール

手順

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

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

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

   図7.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

   Expand

   表7.1 パラメーター

   名前	説明
   id	itorders
   caseId	IT-0000000001

   Show more

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

   <?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 クライアントリクエストに以下の情報を追加します。

   Expand

   表7.2 パラメーター

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

   Show more

   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 クライアントリクエストに以下の情報を追加します。

   Expand

   表7.3 パラメーター

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

   Show more

   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>