Description:

Checkbox — Provides a Checkbox control that can be placed on a FlowWright form to capture a selectable Boolean-style user response.

This widget control allows you to define a list of checkboxes for selection. The user can select one or more checkboxes and specify display conditions for other widgets on the form.

Design:

The Checkbox widget is a FlowWright form widget in the Standard Controls category. It is implemented by FlowWright.Forms.checkbox in FlowWright.Forms.dll and is displayed in the form designer as Checkbox. Checkbox

Because Checkbox is defined as a form widget, it is intended to be used as a user-interface control on a FlowWright form rather than as a conventional workflow process step.

Use the Checkbox widget when a FlowWright form needs to present a selectable option to the user.

Use a checkbox when a user needs to indicate whether a condition applies, confirm an item, provide consent, or select an optional requirement.

Typical Workflow Suggestions:

Terms and Conditions Confirmation

Use the Checkbox widget on a registration form when the user must confirm that they have reviewed applicable terms and conditions.

Example workflow:

Start → Registration Form → Validate Information → Review Confirmation → Create Account → End

The checkbox can provide a clear confirmation control on the registration form.

Approval Confirmation

Use a Checkbox on an approval or review form when an approver needs to confirm that a required condition has been reviewed.

Example workflow:

Start → Request Form → Manager Review → Approval Form → Process Decision → End

Include the checkbox alongside the information the approver is expected to review.

Employee Onboarding

Use the Checkbox widget to capture confirmation that an employee onboarding activity or requirement has been completed.

Example workflow:

Start → Employee Onboarding Form → HR Review → Confirm Requirements → Complete Onboarding → End

Use individual checkboxes when the form requires users to indicate completion or confirmation.

Service Request Options

Use a Checkbox when a service request form allows users to indicate whether an optional requirement applies to their request.

Example workflow:

Start → Service Request Form → Validate Request → Assign Service Team → Process Request → End

The checkbox gives the requester an easy way to select an applicable option.

Document Review

Use a Checkbox on a document review form to capture confirmation that a document has been reviewed.

Example workflow:

Start → Document Review Form → Reviewer Assessment → Review Confirmation → Approve Document → End

Include the checkbox as part of the reviewer's confirmation information.

Example:

Let’s build and execute the “CheckboxDef” example.  

• Create a Form Definition called “CheckboxDef.” Navigate to Forms > Definitions on the left pane to create it. On the Form Definitions page, select Actions > Create. Check with your FlowWright administrator if you do not 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 its “Settings” properties. Provide a name for the widget. Enter static values in the “value, key” format. The “key” is required to control the conditional display (show or hide) of other form fields. Set the default “key” value to pre-select the checkbox. Choose the display layout as “horizontal” or “vertical.” Check the “Required” box for mandatory input. Check the “Multiple items” box to allow multiple options to be selected from the drop-down list. Check the “Hide” box to hide this widget at runtime. Check the “Read-Only” box to view the list without making selections. Check the “Allow” box to enable selecting or unselecting all options with a single checkbox. Click the “Lock Widget” button to toggle the lock/unlock feature and prevent accidental configuration changes. Click the “Save” button. 

• Double-click the “Checkbox” widget to configure the “Conditions” properties. Click the plus sign (+) to add an empty row. Set up the display conditions here. Enter the control key value and link it to the necessary Form field to display it under this condition. Otherwise, the selected Form field remains hidden at runtime. The example below illustrates 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 appear when the correct checkbox values are selected at runtime. Click the “Lock Widget” button to toggle the lock/unlock feature and prevent accidental configuration changes. Click the “Save” button. 

• Double-click the “Checkbox” widget to configure the “Styling” properties. Select the checkbox to add bold, italic, and underline styles to the label. Choose the Fore and Back colors from the drop-down list. Pick the font size from the drop-down list. Provide the CSS syntax. Select the classes to apply from the global drop-down list. Click the “Lock Widget” button to toggle the lock/unlock feature and prevent accidental configuration changes. Click the “Save” button. 

• Double-click the “Checkbox” widget to configure the “Other” properties. Enter the tooltip text and then 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 and then click the “Translate” button. You can overwrite the translated text with something more suitable for your style. Click the “Save Translation” button. 

• Navigate to Page > Globalization menu. Select a language from the drop-down list and then click the “Translate” button. Click the “Save” button. 

• Save the Form Definition. Choose Actions > Create Form Instance from the menu. Generate a new form instance and select the box to edit it. Contact your FlowWright administrator if you are unable to create 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)

• Select the culture flag to view the control in a globalized format. 

Tips:

• Use a Checkbox when the user needs to select or confirm an individual option.
• Give the checkbox a clear and meaningful label when configuring the form.
• Use checkboxes for independent options rather than mutually exclusive choices.
• Place the checkbox close to the information or statement to which it applies.
• Test the form to confirm that the selected state is handled correctly by the surrounding business process.
• Do not infer default-state or validation behavior from the XML because those properties are not exposed in the definition.

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: After the import, verify and complete any missing configurations, such as file path references and database connections. Then, save the definition to confirm the changes. 

Click here to download the sample file.