I. Overview
The Drop-down Box Widget gives you multiple options for query.
II. Steps
1. Drag the widget
1) Click on the Checkbox widget and drag it into the parameter pane. The widget name defaults to comboBox0.
2) You are allowed to change the widget name. The widget name is used to bind the widget to a certain parameter. Specifically, the widget will be bound to a parameter when they have the same name. In the Preview mode, the values selected with the widget will be passed to the parameter.
2. Disable the widget
1) Check [Enabled]. In the Preview mode, you are allowed to check the options the widget displays.
2) Uncheck [Enabled]. In the Preview mode, the widget has a shallow color and you are not allowed to check the options the widget displays.
3. Hide the widget
1) Check [Visible]. In the Preview mode, the widget is visible.
2) Uncheck [Visible]. In the Preview mode, the widget is not visible.
4. Widget value: String
1) Widget value refers to the option selected by default in the Preview mode, which can be string, field or formula.
2) The widget value is string by default. Type “I'm comboBox” in the text box.
3) Preview.
5. Widget value: Field
1) Select [Field] as the widget value.
2) Select the dataset [ds1] and the field [Salesperson].
3) Preview.
6. Widget value: Formula
1) Select [Formula] as the widget value. Click on the [=] and a Formula Definition window pops up. Input the following formula in the text value("ds1",1,1).
2) Preview.
7. Data dictionary
1) In the Preview mode, the options of the widget are set with the data dictionary. The types of the data dictionary include database table, data query, custom and formula.
2) Click on […] after [Data Dictionary] to configure the settings.
8. Data dictionary: Database table
1) Settings of the data dictionary:
Type: Database table
Database: FRDemoEN
Database table: Sales_Basic
Actual value and display value: Region
2) Preview. The options are regions.
9. Data dictionary: Data query
1) Settings of the data dictionary:
Type: Data query
Dataset: ds2
Actual value and display value: Salesperson
2) Preview.
10. Data dictionary: Custom
1) Settings of the data dictionary:
Type: Custom
Input the actual value and the display value by taking the steps shown in the figure below.
(2) Preview.
11. Data dictionary: Formula
1) Select [Formula] as the widget value. Click on the [=] and a Formula Definition window pops up. Input the following formula in the text range(12).
2) Click on the formula icon of the display value and input $$$ + “Month”.
3) Preview.
12. No repeat
1) If [No Repeat] is checked, all the duplicate values will be combined.
2) If [No Repeat] is not checked, all the duplicate values will be separately listed.
13. Watermarks and font size
1) If you type a watermark text in the corresponding text box in the right-hand pane, a light-grey watermark will be shown in the widget option box in the Preview mode, and it will disappear after clicking on the widget. So we can add watermarks to display texts or numbers.
2) You are allowed to change the font size.
14. Allow returning a null
1) If [Allow Null] is checked, it allows you to make a query without displaying any option.
2) In the Preview mode, no option is checked and no error tip pops up after clicking on Query.
15. Not allow returning a null
1) If [Allow Null] is unchecked, select at least one option for query.
2) In the Preview mode, no option is checked and an error tip pops up on the right side of the browser window after clicking on Query.
16. Allow edit
1) If [Allow Edit] is checked, after clicking the drop-down box you are allowed to input values for fuzzy query.
2) If [Allow Edit] is unchecked, after click the drop-down box you are not allowed to input any value.
17. Allow custom data
1) If [Allow Custom Data] is checked, after clicking the drop-down box you are allowed to input a value that is in or not in the drop-down list.
2) If [Allow Custom Data] is unchecked, and if you input a value that is not in the drop-down list after clicking the drop-down box, there will be a pop-up window that reads the value is not in the drop-down list.
18. Widget position
1) Widget position refers to the coordinates of the widget in the parameter pane.
2) Manually input the widget coordinates or directly drag the widget to any position at your option.
19. Widget size
1) To resize the widget, put your cursor onto a border line and the cursor will change into a streamlined arrow, then click and drag.
2) Directly input the width and height of the widget.
