Use
The Yes/No control displays a Boolean attribute for the end user to select between Yes and No options.
Related to attribute types
This control is related to Boolean attributes.
Properties
Every control has a set of properties that allow to customize its behavior in the Work Portal. However, some properties are exclusive to a specific control. The following properties are exclusive to the Yes/No control:
Basic tab
PROPERTY |
DESCRIPTION |
|---|---|
Display as |
Defines how the control will be visually displayed. •Option: Displays two options, Yes and No. Only one option can be selected. •Checkbox: Displays a checkbox. If checked, the control value will be "Yes"; otherwise it will be "null". |
Is exclusive |
This property applies when the control is included as table column and the property Display as is Checkbox. When enabled all the check-boxes displayed in the table are mutually exclusive. That is, a user can only select ONE box from a set of boxes in a table. To make sure the user selected an option use expressions with a validation instead of setting the control as required (This will cause all the Yes/No controls in the tabled to be required when only one can be selected). Keep in mind that when the Display as property is set to Checkbox, the isNull function for validations works the same as isFalse, since for this type of control there are only two possible values (not checking the box means that the attribute is set to false). |
|
Exclusive boolean controls within a table cannot be used as controls within actions and validations. |
Display as example
|
When a boolean control is displayed as checkbox and it is also configured as Required in the control properties, its value can only be set to true (in other words, the checkbox must be marked always. It cannot be leaved unmarked). Hence, if you need to set false values in a required boolean control, you must display it as option (radio buttons). |
Is exclusive example
Advanced tab
PROPERTY |
DESCRIPTION |
|---|---|
Automatically sets a value when the form opens for the first time. As soon as a value is chosen by the user the default will be replaced. If the associated attribute is valued by means of an expression, the default value of the Yes/No control will be ignored. |
|
Submit on change |
This property is deprecated. We suggest using Actions and Validations. When enabled, as the end user selects a value from the control, the entire form will refresh and execute all Actions, Validations and visibility rules, saving what has been entered. |
|
Clicking the Set to default value icon will reset the properties. |
Example
In a Vacation Request Process when an employee requests vacations, he/she must read and accept the company's vacation policies. To allow the user to access accept or reject these policies a Yes/No control has to be inserted onto the Request form.
1. The first requirement is a Boolean attribute in your Data Model. We will create an attribute named Accept policies in the Process Entity.
2. Drag and drop the Accept Policies attribute from the data model onto the Display area. The attribute is automatically interpreted as a Yes/No control.
3. Save the Form and go to the Work Portal to test the control.
Last Updated 1/6/2022 11:28:16 AM