Validations

Clocks Guide

Version
R2024.2.0
Validations

The tags in the <validations> section represent the different tests and checks that the clock performs to verify clock entries. The clock performs these validations when it’s operating in standalone mode (that is, the <local_punch_validation> tag in the <system> section is set to yes). Invalid clock entries are rejected with an appropriate message.

When the clock is operating in online mode (that is, the <local_punch_validation> tag is set to no), clock entries are validated in Dayforce using the validations specified in System AdminClocking Sequence Validation.

Each validation described below has the following attributes:

  • name: The validation name. Don’t edit this value.
  • active: The validation’s active status. Set to yes to enable the validation, or no to disable it.
  • order: The validation’s place in the hierarchy. Type the relative order the validation is performed. For example, the clock runs the validation with order="10" before one with order="20".
  • supervisor: Set to yes to enable the validation even when the clock is in supervisor mode, or no to disable it in supervisor mode.

Consider this example:

<validation name="Employee Badge Validation" class="com.dayforce.devices.validationframework.validation.EmployeeBadgeValidation" active="yes" order="20" supervisor="yes" />

This entry gives the validation name ("Employee Badge Validation") and class ("com.dayforce.devices.validationframework.validation.EmployeeBadgeValidation"), and then specifies that the validation is active, the order is 20, and supervisors can override the validation.

The available validations are described below.

"Start System Validation"

Validates that the clock time is correct.

"Supervisor Badge Validation"

Validates that the badge swiped to enter into supervisor mode belongs to a supervisor.

Supervisor mode is used by managers, or other users set up as supervisors, to override other clock validations. An example of this is clocking in on an employee’s behalf if they weren’t scheduled, or if they’re trying to clock in later than the clock is configured to allow. Supervisors can also perform enrollment tasks, such as enrolling users for biometric verification or picture capture.

"Employee Badge Validation"

Validates employees badge numbers.

"Employee Status Validation"

Validates that the employee performing a clock entry has the necessary time entry policy assigned and is active in the application.

"Biometric Validation"

Validates that the employee’s finger scan matches the template saved in the database.

"Picture Validation"

Validates that the clock was able to capture a picture of the employee with their clock entry. The clock itself doesn’t compare the employee’s picture with the picture stored in the database. Managers must manually compare the pictures in the application using the Clock Entry Audits feature or in the Clock Data panel in Timesheets.

"Employee PIN Validation"

Validates the employee and supervisor PINs. This validation is used only if the clock is configured to prompt for PINs in the <system> section.

"Bio Consent Validation"

Validates that the employee clocking in with biometric verification consented to submit their fingerprint templates after reviewing the legal disclaimer. If the employee declined to consent to the submission of their fingerprint templates, the clock entry is rejected.

"Consecutive Clock Entry Validation"

Filters out consecutive clock entries of the same type time stamped within a specified time (for example, when two directionless clock entries occur within a short time). The times are specified in the application when time entry policies are set up.

"Clock Entry Order Validation"

Validates the order in which employees perform clock entries. For example, when enabled, the clock doesn’t allow employees to clock out before they’ve clocked in for the day.

This validation should be configured with <reject>yes</reject>.

"Meal Subsidy Validation"

Validates the meal subsidy entered by the employee on the clock based on your organization’s time entry policy.

"Shift Start Validation"

Validates employees’ shift start times when they clock in. When enabled, the clock doesn’t allow employees to clock in for a shift unless they are scheduled.

"Shift End Validation"

Validates employees’ shift end times when they clock out. When enabled, the clock doesn’t allow employees to clock out for a shift if it violates their time entry policy (for example, clocking out too early).

"Meal Start Validation"

Validates employees’ meal start times when they clock out for a meal. When enabled, the clock doesn’t allow employees to clock out for a meal unless they are scheduled for one.

"Break Start Validation"

Validates employees’ break start times when they clock out for a break. When enabled, the clock doesn’t allow employees to clock out for a break unless they are scheduled for one.

"Meal End Validation"

Validates employees’ meal end times when they clock back in from a meal. When enabled, the clock doesn’t allow employees to clock in from a meal when they aren’t scheduled to.

"Break End Validation"

Validates employees’ break end times when they clock back in from a break. When enabled, the clock doesn’t allow employees to clock in from a break when they aren’t scheduled to.

"Meal Length Validation"

Validates employees’ meal lengths. When enabled, the clock doesn’t allow employees to clock in from a meal if the meal they took didn’t meet the scheduled duration.

"Break Length Validation"

Validates employees’ break lengths. When enabled, the clock doesn’t allow employees to clock in from a break if the break they took didn’t meet the scheduled duration.

"Shift Override Validation"

Not a validation, but used to return a message to the clock stating that a shift override is in effect.

"Docket Validation"

Validates the docket that the employees select when recording docket transfers.

"Project Validation"

Validates the project the employees select when recording project transfers.

"Employee Project Validation"

Validates that an employee is assigned to the project that they select when recording a project transfer.

"Quantity Validation"

Validates the quantity that employees select when recording a docket transfer

"Transfer Validation"

Validates the transfer code employees enter.

"Employee Transfer Validation"

Validates that an employee can transfer to the work assignment that they selected for a work transfer.

"Out With Meal Break Validation"

Validates the information employees record when completing out with meal break clock entries, and ensures that the meals and breaks the employees recorded fall within the shift times.

"Tip Type Validation"

Validates the tip type that the user selects when recording tips.

"Relay Control Validation"

Shows a confirmation message when employees perform relay control clock entries.

"Relay Control Employee Schedule Validation"

Validates that the employee is scheduled to work. When enabled, it doesn’t allow employees to perform relay control clock entries outside of their schedule.

"Labor Metrics Type Validation"

Validates that the employee entered a valid labor metrics type when recording a labor metrics transfer.

"Labor Metrics Code Validation"

Validates that an employee entered a valid labor metrics code when recording a labor metrics transfer.

"Labor Metrics Time Entry Policy Validation"

Validates that the labor metrics type specified by the employee during a labor metrics transfer is assigned to the time entry policy.

"Labor Metrics Employee Code Assignment Validation"

Validates that an employee is assigned to the labor metrics code they select when recording a labor metrics transfer.

"Multiple Transfers Validation"

Validates the multiple transfer codes that employees enter.

"In With Transfer Validation"

Validates that an employee can clock in and transfer to the work assignment they selected for a work transfer.