Applies to versions: 1.11, 2.0, 2.1, 2.2, 2.3, 2.4, 2.5, 3.0, 3.1, 3.2, 3.3, 4.0

Remote Clocking Whitelist Expressions

This article explains the purpose of expressions in remote clocking whitelists and provides the available configuration options.

Remote Clocking Whitelists

Whitelists are used to grant employees access to the remote clocking interface. Whitelists can restrict access based on the IP address of the employee and can be further limited to a defined set of employees. Additionally whitelists can be further restricted using custom logic through the use of an expression. For a full explanation of whitelists and their interface view this article.

Purpose of Expressions

Expressions allow you to tailor the restriction of whitelists based on whatever criteria you need to match your company policy. Examples include only allowing access at certain times of day or to employees from a certain group (payroll type, schedule group, organizational unit etc) or any other conditional rule.

Format of Expressions

Expressions must start with an equals sign '='. They provide a single line of code that is evaluated and reduced down to either TRUE or FALSE. If the expression evaluates to TRUE then it is valid and the whitelist applies to the employee's clock attempt. If it is FALSE then the whitelist will not grant access to the employee.

Supported Functions

Remote clocking whitelist expressions utilize the same expression parser as Custom Reports. As such the same functions are available. The list of functions is available at this article.

Available Variables

The following information is available. Variable names are case sensitive. 

time

ip

user

Examples

Only allow clocks for employees who have a manager named "Bob"

=if([user][manager][nameFirst] = "Bob", true, false)

Prevent anyone in the production schedule group from using this whitelist

=if([user][scheduleGroup][name] = "Production", false, true)

Only let office workers clock if it is after 8 am

=if([user][orgUnit][name] = "Office Staff" && utcdate( "G", [time], [user][usersID] ) < 8, false, true)