You are viewing the documentation for Blueriq 13. Documentation for other versions is available in our documentation directory.
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
- Select the Home tab
- From the Domain group select the Validation rule icon
- Fill in the required fields
- Click Save or Save & close
Properties
Property | Description |
---|---|
Name | The only mandatory field. It identifies the object. Maximum 100 characters (only letters, numbers and underscores (_)) are allowed. |
Functional name | Optional, can be used in documentation |
Description | Optional |
Expression | Insert the valid condition the attributes value has to meet. |
Icon Expression editor | Opens 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 |
Blocking | Tick 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
Select the attribute you want to add the validation rule to
- Click on the new item icon to add the validation
- Choose the validation rule you wish to add to the attribute
- Click Save or Save & Close
2 Comments
Rory Tans
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.
Unknown User (w.van.den.berg)
fixed it