12.1.2.1.1.18.2.2. Control Properties – Single-Select Tab

In the Single-Select tab, users can configure and customize various aspects of the dropdown control, including its data source, loading behavior, display options, search functionality, and search type.

1. Dropdown Data Source: This field retrieves the list of dropdown data sources available in either the application or system. Depending on the data source chosen in this field, the available options for selection in the single-select dropdown control will vary.
   • To define a new dropdown data source, select the button.
     • It will display the Query Editor window, in which users can configure static or dynamic items.
   • To modify an existing dropdown data source, select the button.
   • To remove a dropdown data source, select the button.
     • This button will only be visible once users have added/selected a dropdown data source.

*If sourced from within the application, the dropdown data sources in this field will be retrieved from the Dropdown Data Sources section of the Forms module. If sourced from the system itself, they will be retrieved from the database directly.

2. Load Data Asynchronously: This is a checkbox which, if selected, allows the dropdown data to be retrieved in the background while the user interacts with other parts of the application.
   • Selecting this checkbox will speed up the display of dropdown options, improving performance.
3. Sort By Display Member: This is a checkbox which, if selected, allows users to sort the dropdown options by their display values, instead of their original order in the data source.
   • Users can specify the display member by editing the query in the Query Editor window
4. Page Size: This field allows users to set the number of items that are displayed in the dropdown at one time.
   • By default, the size is set to 1000. To adjust this size, users can enter numbers into the field either manually or by clicking the increment/decrement arrows.
     

     **When the ‘More Items’ option is selected, the dropdown will update to display the number of items according to the number specified in this field, and will continue to update by that amount for subsequent selections until all items are displayed.

5. Load Delay (ms): This field allows users to set the amount of time, in milliseconds, that the multi-select dropdown control will wait before loading or displaying its options.
   • By default, this value is set to 100. To adjust this value, users can enter numbers into the field either manually or by clicking the increment/decrement arrows.
6. Min Characters for Search: This field allows users to specify the minimum number of characters a user must input into the search field before the search function is activated.
   • By default, the minimum value is set to 0. To adjust this value, users can enter numbers into the field either manually or by clicking the increment/decrement arrows.
     

     **By setting a minimum value in this field, users can not only help prevent unnecessary searches, but they can also ensure that a search query is specific enough to return relevant results.

7. Search Type: This field displays the list of search types. It allows users to choose how the search function will match their search query with the available options.
   • Search Types: Contains, Starts With, or Ends With.
     • Contains: This option will return results that include the search query anywhere in the text.
     • Starts With: This option will return results that begin with the search query.
     • End With: This option will return results that end with the search query.
8. Apply: This button allows users to save their changes.
9. OK: This button allows users to save their changes and exit the Control Properties window.
10. Cancel This button allows users to cancel their changes and exit the Control Properties window.