Rule errors

The Hour Set Description parameter's value is validated when you submit the rule, and any employee value fields or UDFs are checked for valid values when the rule runs. This section describes the potential errors that can occur on rule submission and run.

Rule submission errors

When you submit the rule's configuration, the application verifies the syntax of the Hour Set Description parameter, as well as if the specified employee value fields or UDFs, if any, exist. These errors can occur:


Error	Reason
Error: Hour Type: [Hour Type's Name] specified does not exist.	The Hour Set Description parameter contains an invalid hour type.
Error: Employee value is not defined in the application.	The Hour Set Description parameter contains an invalid EMP_VAL token. You must use employee value fields numbered 1 to 20.
Error: Employee UDF [UDF's Name] is not defined.	The Hour Set Description parameter contains an invalid EMPUDF token. You must reference an existing UDF in the format EMPUDF~EMPUDF_Name, where EMPUDF_Name is the name of an existing UDF.
Error: Hour Set Description syntax error, please redefine.	Syntax errors can be one of these errors: Numeric values must be 0 or positive. Extra spaces. You cannot specify spaces between the name of employee value fields, UDFs, or the duration values. For example, REG = 48 0 is not allowed, correct to REG = 480. Also, REG = EMP _ VAl1 is not allowed, REG = EMP_VAL1 is allowed. Invalid characters. The parameter can only contain digits 0-9, =, \|, *, letters A-Z (upper or lowercase), (, ), and ~. The \| and () characters are only valid with employee values or UDFs. Invalid UDF naming. If the parameter references a UDF, you must specify the tilde (~) symbol after the prefix and before the UDF's name. REG = ~Weekly Minutes and REG = UDF Weekly Minutes are not allowed, REG = EMPUDF~Weekly Minutes is allowed.

The rule also verifies the values and syntax of the Overtime Reset Description parameter. These errors can occur:


Error	Reason
A time code specified in both the Overtime Reset Description and Work Detail Time Codes will not be considered towards overtime.	The Overtime Reset Description parameter contains a time code that is also in the Work Detail Time Codes parameter. Time codes cannot be used both as reset time codes and still count as eligible work.
Error: Overtime Reset time code specified does not exist.	The Overtime Reset Description parameter contains an invalid time code.
Error: Duplicate Overtime Reset time codes exist.	The Overtime Reset Description parameter contains duplicate time codes. Ensure each reset time code is only specified once.
Error: Overtime Reset duration for time code must be a non-negative value.	Duration values must be 0 or a positive number.
Error: Overtime Reset Description syntax error, please redefine.	Syntax errors can be one of these errors: Extra spaces. You cannot specify spaces between the duration values. For example, LATE = 6 0 is not allowed, correct to LATE = 60. Invalid characters. The parameter can only contain digits 0-9 and =.
A time code listed in Protected Work Detail Time Codes must also exist in the Work Detail Time Codes parameter	Time codes specified in the Protected Work Detail Time Codes parameter must also exist in the Work Detail Time Codes parameter.
An hour type listed in Protected Work Detail Hour Types must also exist in the Work Detail Hour Types parameter	Hour types specified in the Protected Work Detail Hour Types must also exist in the Work Detail Hour Types parameter.

Rule runtime errors

When the rule runs, the application verifies the values of any employee value fields or UDFs. Any errors are displayed on the employee's timesheet. These errors can occur:


Error	Reason
Error: Employee value is not defined for this employee.	The employee's configuration contains a null value in an employee value field specified in the Hour Set Description parameter. You must either specify a default value in the rule's configuration for the employee value field, or ensure every employee is set up in the application with an appropriate value in the field.
Error: Employee value [employee value name = value] does not contain a valid value.	The employee's configuration contains a non-numeric value or a value less than 0 in an employee value field specified in the Hour Set Description parameter. You must either specify a default value in the rule's configuration for the employee value field, or ensure every employee is set up in the application with an appropriate value in the field.
Error: Employee UDF is not defined for this employee.	The employee's configuration contains a null value in a UDF specified in the Hour Set Description parameter. You must either specify a default value in the rule's configuration for the UDF, or ensure every employee is set up in the application with an appropriate value in the field.
Error: Employee UDF value [employee UDF name = value] does not contain a valid value.	The employee's configuration contains a non-numeric value or a value less than 0 in a UDF specified in the Hour Set Description parameter. You must either specify a default value in the rule's configuration for the UDF, or ensure every employee is set up in the application with an appropriate value in the field.