Form Validations components
Validations display (throw) validation messages to the end users when defined conditions are met.
To define a validation, go to the Actions & Validations wizard and click the Add button within the Validations tab:
Validations are defined by two components: Condition and Validation message.
Conditions (If)
Click Add a condition. A new row will be displayed to add a condition.
Conditions are defined by:
- Control: Defines the control to be evaluated. This control MUST be included into the form where the validations are configured.
Note:
Exclusive boolean controls within a table cannot be used as controls within actions and validations.
- Operator: Defines the comparison operator for the condition.
| Operator | Description | Applies to |
|---|---|---|
| changes to | Evaluates if the value of a control has changed to a specific value | Combo, Cascading combo, List, Radio, Search, Suggest, Currency, Number, Date |
| is different to | Evaluates if the value of a control is different to a specific value | Combo, Cascading combo, List, Radio, Search, Suggest, Currency, Number, Date |
| is empty | Evaluates if the control is empty | Combo, Cascading combo, List, Radio, Search, Suggest, Currency, Number |
| is not empty | Evaluates if the control is not empty | Combo, Cascading combo, List, Radio, Search, Suggest, Currency, Number |
| changes | Evaluates if the value of a control has changed | Combo, Cascading combo, List, Radio, Search, Suggest, Currency, Number, Date |
| does not contain | Evaluates if the value of a control does not contain a specific character | Text box |
| contains | Evaluates if the value of a control contains a specific character | Text box |
| begins with | Evaluates if the value of a control begins with a specific character | Text box |
| does not begin with | Evaluates if the value of a control does not begin with a specific character | Text box |
| is an invalid email | Evaluates if the value of a control is an invalid email | Text box |
| less than | Evaluates if the value of a control is less than a specific value | Date, Currency, Number |
| less than or equal to | Evaluates if the value of a control is less than or equal to a specific value | Date, Currency, Number |
| greater than | Evaluates if the value of a control is greater than a specific value | Date, Currency, Number |
| greater than or equal to | Evaluates if the value of a control is greater than or equal to a specific value | Date, Currency, Number |
| has a row deleted | Evaluates if a row has been deleted in a table | Table |
| click | Evaluates if a button has been clicked | Button |
| is true | Evaluates if the value of a control is equal to true | Boolean |
| is false | Evaluates if the value of a control is equal to false | Boolean |
| has a file uploaded | Evaluates if a file control has a file uploaded | File |
| has no files uploaded | Evaluates if a file control has not files uploaded | File |
- Argument: Defines the value to be compared with the control. This value can be a constant or a data binding.
Date type arguments
The date type arguments can be defined in two ways, a fixed date or a function.
- As a fixed date, you choose the specific date to be compared with the control.
- As a function, you have available two functions: today and now, both take the current day as the date to be compared with the control. The now function additionally contains the hour of the day and is available for date controls that have enabled the "show time" property.
Multiple conditions
You can create compound conditions connected with AND and OR.
- To create a compound condition connected with an AND, click Add a condition.
- To create a compound condition connected with an OR, click Add a condition group.
Validation message (Then)
Defines the message that will be displayed to the end users when the defined conditions are met. This message can be localized in order to be displayed in the proper language according to the end user's configurations.