Enable Relay Control

This section describes how to enable optional relay control functionality of the Dayforce Touch Clock. You can configure clocks that operate in standalone mode to close or open internal relays based on the results of clock entry validations or at scheduled intervals.

For example, you can configure the clock to open a relay for two seconds on any successful clock entry, while for any unsuccessful clock entry, a second relay is opened for three seconds. The relays can be wired to external devices such as bells, buzzers, or external lights.

Note: This section specifies only the changes you need to make to the custom config file to enable relay control. For more information about editing config files and publishing your configuration, see Configure the Clock Program.

To enable relay control in the custom config file:

1. In the <relay control> section, specify one of the following, depending on whether you want to control relays using clock entries or a schedule:
2. • To configure the clock so that relays open and closed based on employee clock entries, specify:
   • <function_based enabled="yes">
     <accepted do1="10000" do2="none" />
     <rejected do1="none" do2="none" />
     </function_based>
   • If necessary, you can edit the amount of time (in milliseconds) each relay is open for either an accepted or rejected clock entry by editing the do1 and do2 attributes in the <accepted> and <rejected> tags. By specifying "none" you are specifying that the relay closes with that clock entry.
   • To configure the clock so that relays open and closed based schedules, specify:
   • <schedule_based enabled="yes"/>
   • Note: You set up relay schedules in the main application, in System Admin > Relay Control Schedules. See Configure Relay Control.
2. In the <validations> section, specify the following:
3. <validation name="Relay Control Validation"
class="com.dayforce.devices.validationframework.validation.
RelayControlValidation" active="yes" order="190"
supervisor="no" />
4. This validation shows a confirmation when employees perform relay control clock entries. If necessary, you can also edit the following attributes for the relay control validation:
   • To change the order in which the clock performs the relay control validation in relation to the other validation it performs, change the number in the order attribute.
   • To exempt supervisors from the validation, specify supervisor="no"
3. If necessary, to configure the clock so that it restricts relay control clock entries based on an employee’s schedule, specify the following in the validations section:
4. <validation name="Relay Control Employee Schedule Validation"
class="com.dayforce.devices.validationframework.validation.
RelayControlEmployeeScheduleValidation" active="yes" order="200" supervisor="no" />
5. For example, you could use this functionality to prevent employees from entering their work area when they aren’t scheduled to do so.
6. As with the other validations in this section, you can also edit the following attributes:
   • To change the order in which the clock performs the relay control validation in relation to the other validation it performs, change the number in the order attribute.
   • To exempt supervisors from the validation, specify supervisor="no"
4. In the <functions> section, specify which clock entries open and close relays by specifying "yes" for the rc attribute for that function.
5. For example, to configure the clock so that start shift clock entries open and close relays, specify the following:
6. <function id="in" punchtype="Punch_In"
class="com.dayforce.devices.function.Function" rc="yes" />