Description:

This widget shows a drop-down list of options. These options can come from a static list, a database query, roles, or a lookup list category.

Design:

Example: 

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

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

• Double-click the “Select” widget to configure the “Settings” properties. Provide a name for the control. You can select one of the “Data Connection Types” from the UI. Choose the “Static” type and set the additional properties. Enter the static values in “value, key” format. The “key” is required to configure conditional display (show or hide) for other form fields. Check the “Data Sort” box to sort the list values. Provide the default “key” value to make a drop-down list item pre-selected. Check the “Required” box for mandatory input. Check the “Multiple items” box to allow multiple selections 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 a selection. Check the “Use type ahead” box to select an item by typing its value. Click the “Preview” button to view the list at design time. Finally, click the Save button. 

• Double-click the “Select” widget to configure the “Settings” properties. Select the “Database” type and set the additional properties. Choose the DB connection from the drop-down list. Enter the SQL Select query. Check the “Required” box for mandatory input. Check the “Multiple items” box to allow multiple selections 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 a selection. Check the “Use type ahead” box to select an item by typing its value. Click the “Preview” button to view the list at design time. Click the Save button. 

• Double-click the “Select” widget to configure its “Settings” properties. Choose the “Roles” type and set the additional properties. Select the application role from the drop-down list. You may select multiple roles from the list. At runtime, users belonging to the selected application roles will be listed. Check the “Required” box for mandatory input. Check the “Multiple items” box to select multiple items 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 a selection. Check the “Use type ahead” box to select an item by typing its value. Click the “Preview” button to view the list at design time. Click the Save button. Note: To create and manage application roles, navigate to the Administration > User Management > Roles page. 

• Double-click the “Select” widget to configure the “Settings” properties. Choose the “Lookup” type and set the additional properties. Select the lookup data from the drop-down list. You can select multiple items from the list. The values from the lookup data category are displayed at runtime. Choose the category filter from the drop-down list. Check the “Required” box for mandatory input. Check the “Multiple items” box to enable multiple selections 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 a selection. Check the “Use type ahead” box to select an item by typing its value. Click the “Preview” button to view the list during design time. Click the Save button. Note: To create and manage lookup values, go to the Manage Config > Lookup Data page. 

• Double-click the “Select” 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 map it to the required Form field to display under this condition. Otherwise, the selected Form field remains hidden at runtime. The example below shows the label Form field at runtime when the user chooses the “Jan or Feb” values from the drop-down list. Click the plus sign (+) to add more display conditions. The Form controls appear when the appropriate checkbox values are selected at runtime.     

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

• Double-click the “Select” widget to configure the “Other” properties. Enter the tooltip text. Click the Save button. 

• Double-click the “Select” widget to configure the “Globalize” properties. The application will notify you if there is nothing to globalize, as shown below. Otherwise, choose a language from the drop-down list and then click the Translate button. Finally, click the Save button. 

• Save the Form definition. Select Actions > Create Form Instance from the menu. Generate a new Form instance and choose the check box to edit it.

• The Form is displayed to the user as shown below. 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. Click the Submit button to complete.  

• Click the drop-down list to select an option. The Form field appears as the control field (or value) is chosen, as shown in the example below. Click the Submit button to finish.  

Note : 

• The translation options are available on the resource page.  
• The widget configured with the "read-only" option shows a list of selected items when the form is rendered on mouse hover. The widget in "read-only" mode can still be clicked to open and view the previous selection. 
• The 'x' feature clears the user selection for Static, Database, Roles, and Lookup options. When using the 'x' feature, the Static option should be set to an empty value. 
• In read-only mode, the drop-down list can be clicked to display all items, including the selected ones, as shown below. 

Definition Sample:

You may download and extract 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. 

Click here to download the sample file.