Disable Form Groups
The Disable Form Groups construct is used make specific validations groups or entire forms non-editable. When applied, the form controls within the validations group(s) are disabled, preventing any user modifications.
Key Benefits
- Makes the form or form controls in a validation group read-only.
- Prevents accidental or unauthorized modifications.
- Disables validation rules for the affected fields.
Use Case Examples
- Read-Only Mode: Displaying a form in read-only mode when the user lacks edit permissions.
- Conditional Form Locking: Disabling specific form sections until a prerequisite condition is met.
- Data Review: Temporarily locking form fields during data review processes.
Follow the below steps to add the Disable Form Groups construct in an event flow:
- In the designer canvas of an Interface, Master Layout and component event flow, drag and drop the Disable Form Groups construct into the flow.
- Double-click the construct to configure the properties as required and then click Save.
| Property | Description | Comments |
|---|---|---|
| Label | Labels help developers quickly understand each step in the logic flow without examining the details of the construct. | It is recommended to provide a simple precise label that can improve the readability. |
| Form Selection | Select ‘Whole Form’ or ‘Individual Groups’ from the list. Following are the options: Whole Form Individual Groups | Whole Form If the Whole form is selected, the whole form will be disabled. Individual Groups If the Individual Groups are selected, a multi-select dropdown will appear (Groups). |
| Groups | Allowing user to choose and disable specific form group(s). | When individual groups are selected, only the form groups corresponding to the selected validation groups will be disabled. |
| Comment | Specify whether to comment this construct or not. Either Yes or No. | If marked as Yes, the construct is treated as a commented expression and ignored in code generation. |
| Description | Provides details about the Disable Form Groups purpose and behaviour. | Helps in understanding Disable Form Groups construct. |
Note: An asterisk (*) denotes that the property is mandatory for adding the Disable form group.
The success message displays upon successfully adding the construct.