手順

1. プロジェクトの Assets メニューから、ShiftAssignment データオブジェクトを開きます。
2. Data Objects パースペクティブで、右側の をクリックして Red Hat Business Optimizer ドックを開きます。
3. Planning Entity を選択します。
4. ShiftAssignment データオブジェクトのフィールドリストで employee を選択します。

5. Red Hat Business Optimizer ドックで Planning Variable を選択します。

   Value Range Id 入力フィールドに employeeRange を入力します。これにより、@ValueRangeProvider アノテーションがプランニングエンティティーに追加され、デザイナーの Source タブをクリックすると表示されます。

   プランニング変数の値の範囲は @ValueRangeProvider アノテーションで定義されます。@ValueRangeProvider アノテーションには id プロパティーが常にあり、@PlanningVariable の valueRangeProviderRefs プロパティーから参照されます。

6. ドックを閉じ、Save をクリックして、データオブジェクトを保存します。

手順

1. 識別子 EmployeeRoster でデータオブジェクトを新規作成します。

2. 以下のフィールドを作成します。

   表4.6 EmployeeRoster

   id	タイプ
   dayOffRequestList	employeerostering.employeerostering.DayOffRequest[List]
   shiftAssignmentList	employeerostering.employeerostering.ShiftAssignment[List]
   shiftList	employeerostering.employeerostering.Shift[List]
   skillList	employeerostering.employeerostering.Skill[List]
   timeslotList	employeerostering.employeerostering.Timeslot[List]

3. Data Objects パースペクティブで、右側の をクリックして Red Hat Business Optimizer ドックを開きます。
4. プランニングソリューション を選択します。
5. Solution Score Type は、デフォルトの Hard soft score のままにします。これにより、タイプが ソリューションスコアとなる EmployeeRoster データオブジェクトに、score フィールドが自動的に生成されます。

6. 次の属性で新しいフィールドを追加します。

   id	タイプ
   employeeList	employeerostering.employeerostering.Employee[List]

7. employeeList フィールドを選択した状態で、Red Hat Business Optimizer ドックを開いて、Planning Value Range Provider ボックスを選択します。

   id フィールドに employeeRange を入力し、ドックを閉じます。

8. 右上で Save をクリックし、アセットを保存します。

手順

1. Menu → Design → Projects に移動して、プロジェクト名をクリックします。
2. Create New Asset → DRL file をクリックします。
3. DRL file 名前フィールドに、ComplexScoreRules と入力します。
4. employeerostering.employeerostering パッケージを選択します。
5. +Ok をクリックして DRL ファイルを作成します。

6. DRL デザイナーの Editor タブで、Employee10HourShiftSpace ルールを DRL ファイルとして定義します。

   package employeerostering.employeerostering;
   
   rule "Employee10HourShiftSpace"
       dialect "mvel"
       when
           $shiftAssignment : ShiftAssignment( $employee : employee != null, $shiftEndDateTime : shift.timeslot.endTime)
           ShiftAssignment( this != $shiftAssignment, $employee == employee, $shiftEndDateTime <= shift.timeslot.endTime,
                   $shiftEndDateTime.until(shift.timeslot.startTime, java.time.temporal.ChronoUnit.HOURS) <10)
       then
           scoreHolder.addHardConstraintMatch(kcontext, -1);
   end

7. Save をクリックして、DRL ファイルを保存します。

手順

1. Menu → Design → Projects に移動して、プロジェクト名をクリックします。
2. Create New Asset → Guided Rule をクリックします。
3. Guided Rule 名 に BalanceEmployeesShiftNumber を入力し、Package で employeerostering.employeerostering を選択します。
4. OK をクリックして、ルールアセットを作成します。
5. WHEN フィールドで をクリックして、WHEN 条件を追加します。
6. Add a condition to the rule ウィンドウで Employee を選択し、+Ok をクリックします。
7. Employee 条件でクリックして制約を修正し、変数名 $employee を追加します。

8. WHEN 条件 From Accumulate を追加します。

   1. From Accumulate 条件の上で click to add pattern をクリックし、ドロップダウンリストでファクトタイプ Number を選択します。
   2. 変数名 $shiftCount を Number 条件に追加します。
   3. From Accumulate 条件の下で click to add pattern をクリックして、ドロップダウンリストで ShiftAssignment ファクトタイプを選択します。
   4. 変数名 $shiftAssignment を ShiftAssignment ファクトタイプに追加します。
   5. ShiftAssignment 条件を再度クリックし、Add a restriction on a field ドロップダウンリストで employee を選択します。
   6. employee 制約の横にあるドロップダウンリストで equal to を選択します。
   7. ドロップダウンボタンの横の アイコンをクリックして変数を追加し、Field value ウィンドウで Bound variable をクリックします。
   8. ドロップダウンリストで $employee を選択します。
   9. Function ボックスに count($shiftAssignment) と入力します。
9. THEN フィールドで をクリックして、THEN 条件を追加します。

10. Add a new action ウィンドウで Modify Soft Score を選択し、+Ok をクリックします。

    1. ボックスに -($shiftCount.intValue()*$shiftCount.intValue()) と入力します。
11. 右上の Validate をクリックし、ルール条件がすべて有効であることを確認します。ルールの妥当性確認に失敗したら、エラーメッセージに記載された問題に対応し、ルールの全コンポーネントを見直し、エラーが表示されなくなるまでルールの妥当性確認を行います。
12. Save をクリックして、ルールを保存します。

手順

1. Menu → Design → Projects に移動して、プロジェクト名をクリックします。
2. Create New Asset → Guided Rule をクリックします。
3. Guided Rule 名に OneEmployeeShiftPerDay と入力し、Package で employeerostering.employeerostering を選択します。
4. OK をクリックして、ルールアセットを作成します。
5. WHEN フィールドで をクリックして、WHEN 条件を追加します。
6. Add a condition to the rule ウィンドウから Free form DRL を選択します。

7. フリーフォームの DRL ボックスに、以下の条件を入力します。

   $shiftAssignment : ShiftAssignment( employee != null )
   		ShiftAssignment( this != $shiftAssignment , employee == $shiftAssignment.employee , shift.timeslot.startTime.toLocalDate() == $shiftAssignment.shift.timeslot.startTime.toLocalDate() )

   この条件は、同じ日に別のシフトがすでに割り当てられている従業員にはシフトを割り当てることができないことを示しています。

8. THEN フィールドで をクリックして、THEN 条件を追加します。
9. Add a new action ウィンドウから Add free form DRL を選択します。

10. フリーフォームの DRL ボックスに、以下の条件を入力します。

    scoreHolder.addHardConstraintMatch(kcontext, -1);

11. 右上の Validate をクリックし、ルール条件がすべて有効であることを確認します。ルールの妥当性確認に失敗したら、エラーメッセージに記載された問題に対応し、ルールの全コンポーネントを見直し、エラーが表示されなくなるまでルールの妥当性確認を行います。
12. Save をクリックして、ルールを保存します。

手順

1. Menu → Design → Projects に移動して、プロジェクト名をクリックします。
2. Create New Asset → Guided Rule をクリックします。
3. Guided Rule 名に ShiftReqiredSkillsAreMet と入力し、Package で employeerostering.employeerostering を選択します。
4. OK をクリックして、ルールアセットを作成します。
5. WHEN フィールドで をクリックして、WHEN 条件を追加します。
6. Add a condition to the rule ウィンドウで ShiftAssignment を選択します。+Ok をクリックします。
7. ShiftAssignment 条件をクリックし、Add a restriction on a field ドロップダウンリストで employee を選択します。
8. デザイナーで、employee の横のドロップダウンリストをクリックし、is not null を選択します。

9. ShiftAssignment 条件をクリックし、Expression editor をクリックします。

   1. デザイナーで、[not bound] をクリックし、Expression editor を開き、式と変数 $requiredSkill をバインドします。Set をクリックします。
   2. デザイナーの $requiredSkill の横にあるドロップダウンリストで shift を選択し、その隣のドロップダウンリストで requiredSkill を選択します。

10. ShiftAssignment 条件をクリックし、Expression editor をクリックします。

    1. デザイナーで、[not bound] の横にあるドロップダウンリストで employee を選択し、その隣のドロップダウンリストで skills を選択します。
    2. その隣のドロップダウンリストでは Choose を選択したままにします。
    3. その隣のドロップダウンボックスで、please choose を excludes に変更します。
    4. excludes の隣の アイコンをクリックし、Field value ウィンドウで New formula ボタンをクリックします。
    5. 式ボックスに $requiredSkill を追加します。
11. THEN フィールドで をクリックして、THEN 条件を追加します。
12. Add a new action ウィンドウで Modify Hard Score を選択し、+Ok をクリックします。
13. スコアアクションボックスに -1 を入力します。
14. 右上の Validate をクリックし、ルール条件がすべて有効であることを確認します。ルールの妥当性確認に失敗したら、エラーメッセージに記載された問題に対応し、ルールの全コンポーネントを見直し、エラーが表示されなくなるまでルールの妥当性確認を行います。
15. Save をクリックして、ルールを保存します。

手順

1. Menu → Design → Projects に移動して、プロジェクト名をクリックします。
2. Create New Asset → Guided Rule をクリックします。
3. Guided Rule 名に DayOffRequest と入力し、Package で employeerostering.employeerostering を選択します。
4. OK をクリックして、ルールアセットを作成します。
5. WHEN フィールドで をクリックして、WHEN 条件を追加します。
6. Add a condition to the rule ウィンドウから Free form DRL を選択します。

7. フリーフォームの DRL ボックスに、以下の条件を入力します。

   $dayOffRequest : DayOffRequest( )
   		ShiftAssignment( employee == $dayOffRequest.employee , shift.timeslot.startTime.toLocalDate() == $dayOffRequest.date )

   この条件は、休暇申請を行った従業員にシフトを割り当てている場合に、その従業員をその日のシフト割り当てから削除できることを示しています。

8. THEN フィールドで をクリックして、THEN 条件を追加します。
9. Add a new action ウィンドウから Add free form DRL を選択します。

10. フリーフォームの DRL ボックスに、以下の条件を入力します。

    scoreHolder.addSoftConstraintMatch(kcontext, -100);

11. 右上の Validate をクリックし、ルール条件がすべて有効であることを確認します。ルールの妥当性確認に失敗したら、エラーメッセージに記載された問題に対応し、ルールの全コンポーネントを見直し、エラーが表示されなくなるまでルールの妥当性確認を行います。
12. Save をクリックして、ルールを保存します。

手順

1. Assets パースペクティブで EmployeeRosteringSolverConfig を開きます。これにより、Solver 設定 デザイナーが開きます。
2. Termination セクションで Add をクリックして、選択した論理グループに新しい終了要素を作成します。
3. ドロップダウンリストから、終了タイプ Time spent を選択します。これは、終了条件の入力フィールドとして追加されます。
4. 時間要素の横の矢印を使用して、経過時間を 30 秒に設定します。
5. 右上の Validate をクリックし、Score Director Factory 設定が正しいことを確認します。妥当性確認に失敗したら、エラーメッセージに記載された問題に対応し、エラーが表示されなくなるまで妥当性確認を行います。
6. Save をクリックして、Solver 設定を保存します。

手順

1. 以下のヘッダーを使用して HTTP 要求を作成します。

   authorization: admin:admin
   X-KIE-ContentType: xstream
   content-type: application/xml

2. 以下の要求を使用して Solver を登録します。

   PUT

   http://localhost:8080/kie-server/services/rest/server/containers/employeerostering_1.0.0-SNAPSHOT/solvers/EmployeeRosteringSolver

   要求の本文

   <solver-instance>
     <solver-config-file>employeerostering/employeerostering/EmployeeRosteringSolverConfig.solver.xml</solver-config-file>
   </solver-instance>

3. Solver に要求を送信します。

   POST

   http://localhost:8080/kie-server/services/rest/server/containers/employeerostering_1.0.0-SNAPSHOT/solvers/EmployeeRosteringSolver/state/solving

   要求の本文

   <employeerostering.employeerostering.EmployeeRoster>
     <employeeList>
       <employeerostering.employeerostering.Employee>
         <name>John</name>
         <skills>
           <employeerostering.employeerostering.Skill>
             <name>reading</name>
           </employeerostering.employeerostering.Skill>
         </skills>
       </employeerostering.employeerostering.Employee>
       <employeerostering.employeerostering.Employee>
         <name>Mary</name>
         <skills>
           <employeerostering.employeerostering.Skill>
             <name>writing</name>
           </employeerostering.employeerostering.Skill>
         </skills>
       </employeerostering.employeerostering.Employee>
       <employeerostering.employeerostering.Employee>
         <name>Petr</name>
         <skills>
           <employeerostering.employeerostering.Skill>
             <name>speaking</name>
           </employeerostering.employeerostering.Skill>
         </skills>
       </employeerostering.employeerostering.Employee>
     </employeeList>
     <shiftList>
       <employeerostering.employeerostering.Shift>
         <timeslot>
           <startTime>2017-01-01T00:00:00</startTime>
           <endTime>2017-01-01T01:00:00</endTime>
         </timeslot>
         <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee/skills/employeerostering.employeerostering.Skill"/>
       </employeerostering.employeerostering.Shift>
       <employeerostering.employeerostering.Shift>
         <timeslot reference="../../employeerostering.employeerostering.Shift/timeslot"/>
         <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee[3]/skills/employeerostering.employeerostering.Skill"/>
       </employeerostering.employeerostering.Shift>
       <employeerostering.employeerostering.Shift>
         <timeslot reference="../../employeerostering.employeerostering.Shift/timeslot"/>
         <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee[2]/skills/employeerostering.employeerostering.Skill"/>
       </employeerostering.employeerostering.Shift>
     </shiftList>
     <skillList>
       <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee/skills/employeerostering.employeerostering.Skill"/>
       <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee[3]/skills/employeerostering.employeerostering.Skill"/>
       <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee[2]/skills/employeerostering.employeerostering.Skill"/>
     </skillList>
     <timeslotList>
       <employeerostering.employeerostering.Timeslot reference="../../shiftList/employeerostering.employeerostering.Shift/timeslot"/>
     </timeslotList>
     <dayOffRequestList/>
     <shiftAssignmentList/>
   </employeerostering.employeerostering.EmployeeRoster>

4. 計画問題に最適解をリクエストします。

   GET

   http://localhost:8080/kie-server/services/rest/server/containers/employeerostering_1.0.0-SNAPSHOT/solvers/EmployeeRosteringSolver/bestsolution

   応答例

   <solver-instance>
     <container-id>employee-rostering</container-id>
     <solver-id>solver1</solver-id>
     <solver-config-file>employeerostering/employeerostering/EmployeeRosteringSolverConfig.solver.xml</solver-config-file>
     <status>NOT_SOLVING</status>
     <score scoreClass="org.optaplanner.core.api.score.buildin.hardsoft.HardSoftScore">0hard/0soft</score>
     <best-solution class="employeerostering.employeerostering.EmployeeRoster">
       <employeeList>
         <employeerostering.employeerostering.Employee>
           <name>John</name>
           <skills>
             <employeerostering.employeerostering.Skill>
               <name>reading</name>
             </employeerostering.employeerostering.Skill>
           </skills>
         </employeerostering.employeerostering.Employee>
         <employeerostering.employeerostering.Employee>
           <name>Mary</name>
           <skills>
             <employeerostering.employeerostering.Skill>
               <name>writing</name>
             </employeerostering.employeerostering.Skill>
           </skills>
         </employeerostering.employeerostering.Employee>
         <employeerostering.employeerostering.Employee>
           <name>Petr</name>
           <skills>
             <employeerostering.employeerostering.Skill>
               <name>speaking</name>
             </employeerostering.employeerostering.Skill>
           </skills>
         </employeerostering.employeerostering.Employee>
       </employeeList>
       <shiftList>
         <employeerostering.employeerostering.Shift>
           <timeslot>
             <startTime>2017-01-01T00:00:00</startTime>
             <endTime>2017-01-01T01:00:00</endTime>
           </timeslot>
           <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee/skills/employeerostering.employeerostering.Skill"/>
         </employeerostering.employeerostering.Shift>
         <employeerostering.employeerostering.Shift>
           <timeslot reference="../../employeerostering.employeerostering.Shift/timeslot"/>
           <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee[3]/skills/employeerostering.employeerostering.Skill"/>
         </employeerostering.employeerostering.Shift>
         <employeerostering.employeerostering.Shift>
           <timeslot reference="../../employeerostering.employeerostering.Shift/timeslot"/>
           <requiredSkill reference="../../../employeeList/employeerostering.employeerostering.Employee[2]/skills/employeerostering.employeerostering.Skill"/>
         </employeerostering.employeerostering.Shift>
       </shiftList>
       <skillList>
         <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee/skills/employeerostering.employeerostering.Skill"/>
         <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee[3]/skills/employeerostering.employeerostering.Skill"/>
         <employeerostering.employeerostering.Skill reference="../../employeeList/employeerostering.employeerostering.Employee[2]/skills/employeerostering.employeerostering.Skill"/>
       </skillList>
       <timeslotList>
         <employeerostering.employeerostering.Timeslot reference="../../shiftList/employeerostering.employeerostering.Shift/timeslot"/>
       </timeslotList>
       <dayOffRequestList/>
       <shiftAssignmentList/>
       <score>0hard/0soft</score>
     </best-solution>
   </solver-instance>