You are viewing the documentation for Blueriq 13. Documentation for other versions is available in our documentation directory.

What is it for?

Validation rules are used for validating (checking) input, or calculations made based on input

What is it?

A validation rule specifies the condition(s) the value of the Attribute has to meet in order to make it a valid entry. The outcome of a validation rule is always true, false or unknown (Boolean).

A validation rule passes if the outcome is true or unknown.

When do validation rules apply?

Validation rules apply when:

  • connected to an attribute, AND
  • the attribute is put on a page AND
  • the attribute is not read-only AND
  • the page is submitted.

Validations are also triggered upon "refresh" (see Containers).

Validations only block progression to another page if the Attribute is placed on the Page as "Required" and the validation is set to "Blocking" (see below).

Validation types

Several predefined, more complicated validations are automatically imported into Blueriq projects (they are defined in the AquimaLibrary library). These are documented on the page for Validation types.

How to – create a validation rule

  1. Select the Home tab
  2. From the Domain group select the Validation rule icon
  3. Fill in the required fields
  4. Click Save or Save & close


Properties

PropertyDescription
NameThe only mandatory field. It identifies the object. Maximum 100 characters (only letters, numbers and underscores (_)) are allowed.
Functional nameOptional, can be used in documentation
DescriptionOptional
ExpressionInsert the valid condition the attributes value has to meet.
Icon Expression editorOpens an expression editing page.
Message

Describe the message you want to show the user when the condition defined in the expression is not met. (You can also add the message when connecting the validation to the attribute. This will override the message defined within the validation rule).

The message can contain Text Substitution Language: TSL

BlockingTick this box if you want the validation rule to be blocking. (In this case the user has to make the condition valid before he can continue with the application).

How to – add a validation rule to an attribute

  1. Select the attribute you want to add the validation rule to

  2. Click on the new item icon to add the validation
  3. Choose the validation rule you wish to add to the attribute
  4. Click Save or Save & Close
  • No labels

2 Comments

  1. In the example the message and expression do not match. A 18 year old will be evaluated to false (18 > 18 instead of 18 >= 18) but the message displays as at least 18. This is a bit confusing, I believe.

    1. Unknown User (w.van.den.berg)