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 executes. 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 Types specified do 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 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 = 12 00 is not allowed; correct to REG = 1200. 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.

Rule runtime errors

When the rule executes, 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.
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.