Customizing messages

The 9000 displays different messages depending on the result of the employee's action. Generally, each clock validation has at least one success message and one failure message. For example, when punching in, the badge validation message displays whether or not a valid badge was swiped. If an invalid badge was used, the failed badge validation message is displayed. The details of the messages determine what is displayed on the clock. The message details are configured in the settings.conf file.

Within the settings_<language>.conf file, the clock messages are listed in the format:

  • message.validation.ValidationName.okmessage.XX =
  • message.validation.ValidationName.badmessage.XX =

where ValidationName is the name of the validation, such as BadgeValidation or SupervisorValidation and .XX (a number between 01 and 08) defines on which line the message text is displayed.

If a message is only one line in length, the message does not contain this number. The text following the equal sign defines the message text. For example, the message displayed when a schedule validation fails is defined as:

message.validation.ScheduleValidation.badmessage = Not scheduled to start at this time. Contact your supervisor if necessary.

Not scheduled to start at this time. Contact your supervisor if necessary. is displayed on the clock.

The messages can contain plain text and ‘tokens’ which act as variables. The value of the variable is inserted when the message is displayed. This line defines a message which contains both plain text and variables:

message.validation.BadgeValidation.okmessage.01 = ^&F ^&L, \nShift started at \n^&h:^&m^&A

In this example, the token ^&F represents the employee’s first name. So any message with the ^&F token in it displays the first name of the employee who is performing the clock punch. These tokens can be used:

Token Description
^&F First Name
^&L Last Name
^&D Labor Metric Description
^&S The greeting based on swipe type. Check the message.validation.swipetypegreeting.x settings.
^&T The timed greeting based on the time of day. Can only be used in the message.validation.swipetypegreeting.x settings.
^&N New line. This tells the 9000 to display the text following this token on the next line.
^&H The hour of the swipe in 24 hour format.
^&h The hour of the swipe in 12 hour format.
^&m The minute of the swipe.
^&M The month of the swipe in the MM format.
^&K The month of the swipe in the MMM format.
^&Y The year of the swipe in YYYY format.
^&y The year of the swipe in YY format.
^&d The day of the swipe in DD format.
^&e The day of the swipe in DDD format.
^&A AM / PM indicator