Features Explained - User rule operators

When defining user rules, you create a set of conditions for that rule, each of which is evaluated to either true or false based on the condition criteria. The conditions for a rule must all evaluate to true for the rule to be applied. You must choose an operator for each condition that you specify, in addition to providing the value(s) to match, and the profile field with which the values should be compared. The supported operators are: 

• Equals
• Contains
• Is one of

Civica Learning supports a variety of different profile fields, including:

• Text
• Single select list
• Multi select list
• Organisational unit
• Date - We do not recommend using Date profile fields in rules. 
• User - We do not recommend using User profile fields in rules. 

The user rule operators can have differing results based on the type of profile field to which it is being applied. Specifically, Multi select lists have different behaviours to all other supported field types.

• Equals
  • Text / Single select / Organisational unit: Will evaluate to true if the condition criteria exactly matches the value in the user's profile field (ignoring the case of the text). This is either the value typed in the field, or the single selected item in a single select list. Will evaluate false if the condition criteria is not an exact match. E.g. If the condition criteria is Free, will evaluate to true where the profile value is Free, or FREE, but will evaluate to false where the profile value is Freedom.
  • Multi select: Will evaluate to false for most values and is not recommended to be used in conjunction with the Equals operator. 
• Contains
  • Text / Single select / Organisational unit: Will evaluate to true if the condition criteria is included within the value in the user's profile field. Will evaluate to false if the condition criteria is not included within the user's profile field. E.g. If the condition criteria is Free, will evaluate to true where the profile value is Free, or FREE, or Freedom, but will evaluate to false where the profile value is Kingdom.
  • Multi select: Will evaluate to true where the condition criteria exactly matches (ignoring case) any one of the selected values in the user's profile field. Will evaluate to false where the condition criteria is not an exact match. E.g. If the condition criteria is Free, and the user's selected values are Free, and Kingdom, will evaluate to true, but will evaluate to false if the user's selected values are Freedom, and Kingdom. 
• Is one of
  • Text / Single select / Organisational unit: Will evaluate to true if any one of the provided condition criteria exactly matches the value in the user's profile field (ignoring the case of the text). This is either the value typed in the field, or the single selected item in a single select list. Will evaluate false if none of the provided condition criteria are an exact match. E.g. If the condition criteria are Free, or Freedom will evaluate to true where the profile value is Free, FREE, or Freedom, but will evaluate to false where the profile value is Kingdom.
  • Multi select: Will evaluate to false for most values and is not recommended to be used in conjunction with the Is one of operator. 

Summary