Introduction

Business rule conditions determine which Persons are in scope of a business rule. In other words, they select the subset of Persons which will receive a rule's associated entitlements.

Every business rule has only a single condition, but a condition may contain multiple filters. By default, a business rule has only one filter: active contract. This means that upon enforcement, the rule will be applied to every currently imported Person whose contract attribute is set to 'active.' You can change the contract status filter, as well as add or remove other filters based on Persons attributes, including custom attributes you've defined.

This article will walk you through modifying business rule conditions, in order to change which Persons are in scope. It will explain all the filters which are available to you.

Modify business rule conditions

While adding a new business rule or modifying an existing one, you can edit the rule's condition. To do so, select the relevant wrench icon in the Condition section. You are taken to the Edit Condition page.

Using the three sections on the left side of the page, you can change the criteria that Persons must meet in order to qualify for the business rule. On the right, you can see a dynamically-updated list of qualifying Persons.

Contract

Here, you can choose whether the rule applies to employees with active or inactive employment contracts. An active contract is one whose start date is before today, and whose end date is after today.

Timeframe

This section is only shown if the selected contract status is Active. You can modify the number of days before contract start, or after contract end, that the business rule will apply. For example, if you want a rule that applies five days before contract start, put the number "5" in the Days Before Start box.

Options

Here, you can create additional filters to narrow down the list of qualifying persons. Filters can be based on the following data from your source system:

• Person attributes
• Contract attributes
• Departments
• Titles

Person and Contract attributes include any custom fields you've defined for the source system.

Note: Multiple filters may be added for Person attributes and Contract attributes, whereas Departments and Titles can only have (and only ever require) one filter each. Filters are stacked with AND logic (e.g., person attribute X AND person attribute Y, or person attribute X AND department Z). However, within filters, values are evaluated with OR logic (e.g., person attribute X OR person attribute Y, or department X OR department Y).

Add a Person attribute filter

You may add as many Person attribute filters as you like. Each filter takes a single attribute, and any number of values for that attribute.

To add a Person attribute filter to the rule's condition, select its plus (+) sign button.

Select the filter to start configuring it. You are presented with the Selected Attribute drop-down menu and the Attribute Values text box:

Select a single attribute in the Selected Attribute drop-down menu. In the Attribute Values text box, enter a value to match for the selected attribute. Any person with that value will qualify for the filter. To add additional values, select the plus (+) sign button.

The following animation shows how to add more than one value for an attribute.

Add a Contract attribute filter

The process for adding a Contract attribute filter is nearly identical to adding a Person attribute filter. Select the plus (+) sign button for Contract attribute and follow the same instructions provided above.

Add a Departments filter

Unlike Persons and Contracts attributes filters, you may only add one Departments filter. 

To add a Departments filter to the rule's condition, select its plus (+) sign button.

Select the filter to start configuring it. You are presented with the Departments drop-down menu and the Selected Departments text box:

Select a department in the Departments drop-down menu, and then select the plus (+) button to add it to the Selected Departments list. Any person in one of these departments will qualify for the filter. To add additional departments, repeat this process.

The following animation shows how to add more than one department:

Add a Titles filter

The process for adding a Titles filter is nearly identical to adding a Departments filter. Select the plus (+) sign button for Titles and follow the same instructions provided above.

Finishing up

When you are finished editing the rule's condition, click the Apply button to save your changes.