Meal confirmation prompt configuration for the clock

The clock contains an out-of-the-box configuration for the meal prompt confirmation that is suitable for most use cases and business requirements.

The clock.xml file contains this XML for the configuration of the meal confirmation prompt:


<prompt id="MEAL_CONFIRM" code="MEAL" type="options"  >
	<trigger punch="OUT" />
	<option id="NO" order="5" acceptSwipe="true" data="N" imageName="reject.png />
	<option id="YES" order="6" acceptSwipe="true" data="Y" imageName="accept.png" />
	<cancel allowed="true" acceptSwipe="false" data="C" message="MEAL_CONFIRM_REQUIRED" 
	swipeRejectedReason="MEAL_CONFIRM_CANCELLED"  />
	<timeout seconds="10" acceptSwipe="false" data="T" swipeRejectedReason="MEAL_CONFIRM_TIMEDOUT"  />
</prompt>

Timeout configuration for the meal confirmation prompt

In the configuration above, if the meal confirmation prompt times out:

  • The employee is not clocked out. See acceptSwipe="false" in this part of the syntax above:
    
<timeout seconds="10" acceptSwipe="false" data="T" 
swipeRejectedReason="MEAL_CONFIRM_TIMEDOUT" />
  • The clock journal records a rejected message of MEAL_CONFIRM_TIMEDOUT. This message can be localized in the clock.properties file of your clock configuration.
  • The employee is returned to the badge entry screen without a message.
  • A code of MEAL=T is captured in the EXTRADATA of the clock transaction. This is determined by code="MEAL" and data="T" syntax in the XML configuration above.
  • The image used for the Yes option is accept.png. The image file is stored in /opt/infor/clock/resources.
  • The image used for the No option is reject.png. The image file is stored in /opt/infor/clock/resources.

Canceling the meal confirmation prompt

If the employee selects the Clear button during a meal confirmation prompt:

  • The employee is not clocked out. See acceptSwipe="false" in this part of the syntax above:
    
<cancel allowed="true" acceptSwipe="false" data="C" 
message="MEAL_CONFIRM_REQUIRED" swipeRejectedReason="MEAL_CONFIRM_CANCELLED" />
  • The employee is shown a message of MEAL_CONFIRM_REQUIRED and a rejected message of MEAL_CONFIRM_CANCELLED is recorded in the clock journal. These messages can be localized in the clock.properties file of your clock configuration.
  • A code of MEAL=C is captured in the EXTRADATA of the clock transaction. This is determined by code="MEAL" and data="C" syntax in the XML configuration.

UI configuration for default meal confirmation prompt

In the above configuration in the XML file, the option IDs of option id="NO" order="5" and option id="YES" order="6" mean that the function key options for the user on the clock of No and Yes will display in vertical positions 5 and 6 on the clock. This corresponds to function keys F5 and F6 of eight possible horizontal function keys on the clock.