Description:

This widget displays a drop-down list of choices. These choices could be based on a static list, database call, roles, or a lookup list category.

Design:

Example:

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

• Create a new Form Definition called “SelectWidgetDef.” 
• Drag a “BootstrapGrid, Label, Select, Submit” control onto the canvas and arrange them as shown below.

• Double-click the SelectWidget to configure the “Settings” properties. Provide a name for the control. Choose the “Data Connection Type” to bind values to the drop-down list, and set any additional properties as needed. Select “Static” and enter options in the “value, key” format. The “key” is required to configure conditional display, if needed. You may use the checkbox for mandatory input, hide the form, and mark it read-only at runtime. Select the checkbox for multiple selection and a type-ahead search feature. Click the Preview button to view the list of items. Click the Save button. Note: The selected data connection type is used at runtime. 

• Select the “Conditions” tab. Click the plus sign (+) to add an empty row. Enter the control field value and select the form field to toggle the show/hide behavior. Click the Save button. You may add multiple display conditions using the plus sign. Note: The control and mapping form field values should be unique to ensure expected behavior. 

• Save the Form Definition. Select Actions > Create Form Instance. Generate a new Form Instance, then select the check box to edit it.

• The Form is shown to the user below. Click the drop-down list to make a selection. 

• Click the drop-down list to make a selection. The Form field remains hidden because the control field (or value) is not selected in the example below. Click the Submit button to complete.  

• Click the drop-down list to make a selection. The Form field is displayed as the control field (or value) is selected, as shown in the example below. Click the Submit button to complete.  

• Double-click the SelectWidget to configure the “Settings” properties. Provide a name for the control. Choose the “Data Connection Type” to bind values to the drop-down list, and set any additional properties as needed. Choose the “Database” option and select the connection from the drop-down list. Provide the SQL SELECT statement. You may use the checkbox to require input, hide the form, and mark it read-only at runtime. Select the checkbox for multiple selection and a type-ahead search feature. Click the Preview button to view the list of items. Click the Save button. Note: The focused data connection type is used at runtime. 

• Select the “Conditions” tab. Click the plus sign (+) to add an empty row. Enter the control field value and select the form field to toggle the show/hide behaviour. Click the Save button. You may add multiple display conditions using the plus sign. Note: The control and mapping form field values should be unique to ensure expected behavior. 

• Save the Form Definition. Select the Actions - Create Form Instance menu option. Generate a new Form Instance, then select the check box to edit this Form Instance.

• The Form is displayed to the user as shown below. Click the drop-down list to select an option. 

• Click the drop-down list to make a selection. The Form field remains hidden because the control field (or value) is not selected in this example. Use the type-ahead feature to search the list. Click the Submit button to complete.  

• Click the drop-down list to make a selection. The Form field is displayed as the control field (or value) is selected, as shown in the example below. Click the Submit button to complete.  

• Double-click the SelectWidget to configure the “Settings” properties. Provide a name for the control. Choose the “Data Connection Type” to bind values to the drop-down list, and set any additional properties as needed. Choose the “Roles” option and select the role from the drop-down list. You may use the checkbox for mandatory input, hide the form, and mark it read-only at runtime. Select the checkbox for multiple selection and a type-ahead search feature. Click the Preview button to view the list of items. Click the Save button. Note: The selected data connection type is used at runtime. The roles should be configured before using the Administration > User Management > Roles menu option. 

• Save the Form Definition. Select the Actions - Create Form Instance menu option. Generate a new Form Instance, then select the check box to edit this Form Instance.

• The Form is displayed to the user as shown below. Select an option from the drop-down list, then click Submit to complete.  

• Double-click the SelectWidget to configure the “Settings” properties. Provide a name for the control. Choose the “Data Connection Type” to bind values to the drop-down list, and set any additional properties as needed. Choose the “Lookup” option and select the lookup category from the drop-down list. You may use the checkbox to require input, hide the form, and mark it read-only at runtime. Select the checkbox for multiple selection and a type-ahead search feature. Click the Preview button to view the list of items. Click the Save button. Note: The focused data connection type is used at runtime. The Lookup values should be configured before using the Manage Config - Lookup Data menu option. 

• 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.

• Use the drop-down list to make a selection. Click the Submit button to complete.  

• Select the “Styling” properties. Choose the input width from the drop-down list. Enter the CSS syntax. Select the classes to apply from the global drop-down list. Click the Save button. 

• Select the “Other” properties. Provide the tool tip text. Click the Save button. 

• Select the “Globalize” properties. The application will alert you if there is nothing to globalize, as shown below. Otherwise, select the language from the drop-down list, then click the Translate button. Click the Save button. 

• Note: You can also globalize the form fields using the Page > Globalization menu option. 

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 import process steps for 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.