5.2. 従業員の勤務表サンプルプロジェクトの再作成

手順

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

5. OptaPlanner ドックで Planning Variable を選択します。

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

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

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

手順

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

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

   表5.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 パースペクティブで、右側の をクリックして、OptaPlanner のドックを開きます。
4. Planning Solution を選択します。
5. Solution Score Type は、デフォルトの Hard soft score のままにします。これにより、タイプがソリューションスコアとなる EmployeeRoster データオブジェクトに、score フィールドが自動的に生成されます。

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

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

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

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

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

手順

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

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

   package employeerostering.employeerostering;
   
   rule "Employee10HourShiftSpace"
       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. Business Central で、Menu Design Projects に移動して、プロジェクト名をクリックします。
2. Add 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. Business Central で、Menu Design Projects に移動して、プロジェクト名をクリックします。
2. Add 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. Free form の 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. Free form の DRL ボックスに、以下の条件を入力します。

    scoreHolder.addHardConstraintMatch(kcontext, -1);

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

手順

1. Business Central で、Menu Design Projects に移動して、プロジェクト名をクリックします。
2. Add 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. Business Central で、Menu Design Projects に移動して、プロジェクト名をクリックします。
2. Add 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. Free form の 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. Free form の DRL ボックスに、以下の条件を入力します。

    scoreHolder.addSoftConstraintMatch(kcontext, -100);

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