Chapter 6. Create rules for employee rostering using guided rules

Procedure

1. Go to Menu Design Projects and click the project name.
2. Click Add Asset Guided Rule.
3. Enter BalanceEmployeesShiftNumber as the Guided Rule name and select the employeerostering.employeerostering Package.
4. Click Ok to create the rule asset.
5. Add a WHEN condition by clicking the in the WHEN field.
6. Select Employee in the Add a condition to the rule window. Click +Ok.
7. Click on the Employee condition to modify the constraints and add the variable name $employee.

8. Add the WHEN condition From Accumulate.

   1. Above the From Accumulate condition, click click to add pattern and select Number as the fact type from the drop-down list.
   2. Add the variable name $shiftCount to the Number condition.
   3. Below the From Accumulate condition, click click to add pattern and select the ShiftAssignment fact type from the drop-down list.
   4. Add the variable name $shiftAssignment to the ShiftAssignment fact type.
   5. Click on the ShiftAssignment condition again and from the Add a restriction on a field drop-down list, select employee.
   6. Select equal to from the drop-down list next to the employee constraint.
   7. Click the icon next to the drop-down button to add a variable, and click Bound variable in the Field value window.
   8. Select $employee from the drop-down list.
   9. In the Function box type count($shiftAssignment).
9. Add the THEN condition by clicking the in the THEN field.

10. Select Modify Soft Score in the Add a new action window. Click +Ok.

    1. Type the following expression into the box: -($shiftCount.intValue()*$shiftCount.intValue())
11. Click Validate in the upper-right corner to check all rule conditions are valid. If the rule validation fails, address any problems described in the error message, review all components in the rule, and try again to validate the rule until the rule passes.
12. Click Save to save the rule.

Procedure

1. Go to Menu Design Projects and click the project name.
2. Click Add Asset Guided Rule.
3. Enter OneEmployeeShiftPerDay as the Guided Rule name and select the employeerostering.employeerostering Package.
4. Click Ok to create the rule asset.
5. Add a WHEN condition by clicking the in the WHEN field.
6. Select Free form DRL from the Add a condition to the rule window.

7. In the free form DRL box, type the following condition:

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

   Copy to Clipboard Toggle word wrap

   This condition states that a shift cannot be assigned to an employee that already has another shift assignment on the same day.

8. Add the THEN condition by clicking the in the THEN field.
9. Select Add free form DRL from the Add a new action window.

10. In the free form DRL box, type the following condition:

    scoreHolder.addHardConstraintMatch(kcontext, -1);

    Copy to Clipboard Toggle word wrap
11. Click Validate in the upper-right corner to check all rule conditions are valid. If the rule validation fails, address any problems described in the error message, review all components in the rule, and try again to validate the rule until the rule passes.
12. Click Save to save the rule.

Procedure

1. Go to Menu Design Projects and click the project name.
2. Click Add Asset Guided Rule.
3. Enter ShiftReqiredSkillsAreMet as the Guided Rule name and select the employeerostering.employeerostering Package.
4. Click Ok to create the rule asset.
5. Add a WHEN condition by clicking the in the WHEN field.
6. Select ShiftAssignment in the Add a condition to the rule window. Click +Ok.
7. Click on the ShiftAssignment condition, and select employee from the Add a restriction on a field drop-down list.
8. In the designer, click the drop-down list next to employee and select is not null.

9. Click on the ShiftAssignment condition, and click Expression editor.

   1. In the designer, click [not bound] to open the Expression editor, and bind the expression to the variable $requiredSkill. Click Set.
   2. In the designer, next to $requiredSkill, select shift from the first drop-down list, then requiredSkill from the next drop-down list.

10. Click on the ShiftAssignment condition, and click Expression editor.

    1. In the designer, next to [not bound], select employee from the first drop-down list, then skills from the next drop-down list.
    2. Leave the next drop-down list as Choose.
    3. In the next drop-down box, change please choose to excludes.
    4. Click the icon next to excludes, and in the Field value window, click the New formula button.
    5. Type $requiredSkill into the formula box.
11. Add the THEN condition by clicking the in the THEN field.
12. Select Modify Hard Score in the Add a new action window. Click +Ok.
13. Type -1 into the score actions box.
14. Click Validate in the upper-right corner to check all rule conditions are valid. If the rule validation fails, address any problems described in the error message, review all components in the rule, and try again to validate the rule until the rule passes.
15. Click Save to save the rule.

Procedure

1. Go to Menu Design Projects and click the project name.
2. Click Add Asset Guided Rule.
3. Enter DayOffRequest as the Guided Rule name and select the employeerostering.employeerostering Package.
4. Click Ok to create the rule asset.
5. Add a WHEN condition by clicking the in the WHEN field.
6. Select Free form DRL from the Add a condition to the rule window.

7. In the free form DRL box, type the following condition:

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

   Copy to Clipboard Toggle word wrap

   This condition states if a shift is assigned to an employee who has made a day off request, the employee can be unassigned the shift on that day.

8. Add the THEN condition by clicking the in the THEN field.
9. Select Add free form DRL from the Add a new action window.

10. In the free form DRL box, type the following condition:

    scoreHolder.addSoftConstraintMatch(kcontext, -100);

    Copy to Clipboard Toggle word wrap
11. Click Validate in the upper-right corner to check all rule conditions are valid. If the rule validation fails, address any problems described in the error message, review all components in the rule, and try again to validate the rule until the rule passes.
12. Click Save to save the rule.