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>
    <condition field="swipe.type" operator="=" value="OUT"/>
  </trigger>
  <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. You can localize this message 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 code is determined by code="MEAL" and data="T" syntax in the XML configuration above.
  • If Yes is selected, use the accept.png image file. If No is selected, use the reject.png image file. The image files are 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. You can localize these messages in the clock.properties file of your clock configuration.
  • A code of MEAL=C is captured in the EXTRADATA of the clock transaction. This code 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 No and Yes is displayed in vertical positions 5 and 6 on the clock for the user . These positions corresponds to function keys F5 and F6 of eight possible horizontal function keys on the clock.