Description:
This widget control lets you define a list of checkboxes for selection. The user can select one or more checkboxes. The user can also specify a display condition for other widgets on the Form.
Inputs
- ID/Name - Name of widget generated by FlowWright
- Checkboxes - Define the list of items required as checkboxes (comma suffix and unique value for reference)
- Display type - Select between Horizontal / Vertical
- Required - Select the checkbox for mandatory (tick mark)
- Hide - Select the checkbox to Hide (tick mark)
- Read Only - Select the checkbox to Read-Only (tick mark)
- Allow Select All - Select the checkbox to select/unselect all items.
- Display Condition - Define a display condition for other widgets based on the checkbox value
- Styles - Select Label Styles (Bold, Italic, Underline). Select ForeColor and BackColor. Select Font Size. Enter the CSS scripts for widget styles
- Apply Classes - Select between custom classes defined
- Tool Tip - Enter information to display on mouse hover on form render
- Save - Save the input values
- Delete - Remove this form widget from the designer page
- Close - Close the input popup window
Design:
Example:
Let’s build and execute the “CheckboxDef” example.
- Create a Form definition called “CheckboxDef.” Navigate to Forms - Definitions in the left pane to create it. On the Form Definitions page, select Actions - Create. Check with your FlowWright administrator if you don't have access to generate Form Definitions.
- Drag a “BootstrapGrid, Label, Text, Checkbox, and Submit” control onto the canvas and arrange them as shown below.
- Double-click the “Checkbox” widget to configure the “Settings” properties. Provide a name for the widget. Enter the static values in “value, key” format. The “key” is required to configure the conditional display (show or hide) of other Form fields. Set the default “key” value to render the checkbox as pre-selected. Select the display type as “horizontal” or “vertical”. Select the “Required” checkbox for mandatory input. Select the “Multiple items” checkbox to select multiple items from the drop-down list. Select the “Hide” checkbox to hide this widget at runtime. Select the “Read-Only” checkbox to view the list without making any selections. Select the “Allow” checkbox to select or unselect all options using a single select checkbox. Click the Save button.
- Double-click the “Checkbox” widget to configure the “Conditions” properties. Click the plus sign (+) to insert an empty row. Configure the display conditions here. Provide the control key value and map it to the required Form field to show under this condition. Otherwise, the selected Form field is hidden at runtime. The example below shows the label and text Form fields at runtime when the user selects the appropriate “Show” checkbox. Click the plus sign (+) to add more display conditions. The Form controls are displayed when the appropriate checkbox values are selected at runtime. Click the Save button.
- Double-click the “Checkbox” widget to configure the “Styling” properties. Select the checkbox to apply bold, italic, and underline styles to the label. Select the Fore and Back colors from the drop-down list. Select the font size from the drop-down list. Provide the syntax for the CSS styles. Select the classes to apply from the global drop-down list. Click the Save button.
- Double-click the “Checkbox” widget to configure the “Other” properties. Enter the tool tip text. Click the Save button.
- Double-click the “Checkbox” widget to configure the “Globalize” properties. The application will alert you if there is nothing to globalize, as shown below. Otherwise, select a language from the drop-down list, then click the Translate button. Click the Save button.
- Save the Form definition. Select Actions - Create Form Instance from the menu. Generate a new Form Instance and select the check box to edit it. Check with your FlowWright administrator if you don't have access to generate Form Instances.
- The Form is rendered for the user as shown below.
- Select the check box to render the label and text (based on the display condition)
Definition Sample:
You may download the sample definition(s) from the link provided and later import them (drag-and-drop) into your FlowWright Process Definition (XML file) or Form Definition (HTML file) page.
Note: Please verify and complete the process steps for any missing configurations, such as file path references and database connections, after the import. Then, save the definition to confirm the changes.