I. Overview
The Drop-down checkbox widget enables you to concurrently check multiple options for query.
II. Steps
1. Drag the widget
1) Click on the Checkbox Group widget and drag it into the parameter pane. The widget name defaults to comboCheckBox0.
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 string” in the 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 box: 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.
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. Click the formula box of the actual value and input range(12). Click the formula box of the display value and input $$$ + "Month".
2) 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 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. Displayed as label
1) If the [Displayed as Label] is checked, there will be a rounded-corner label in the option box.
2) If the [Displayed as Label] is unchecked, option values will be displayed normally.
15. Return value type: Array
1) If the data to be filtered are numbers, you can set to return an array value.
2) Do not add any single quote to SQL IN Condition, for example, ${TEST1} for ds2.
3) Incorrect demonstration: When a single quote is added to the SQL statement, although you can run a query in the Preview mode, there is no return value in the drop-down box, for example ${TEST2}’for ds3.
4) Click Preview and compare the query results. You can find it fails to execute SQL if adding a single quote.
16. Widget value: String
1) If the data to be filtered are strings or numbers, you can set to return a string value. Enclose the parameter used in the IN statement executed for database query in single quotes.
2) Manually input ',' (single quote + comma + single quote) as the delimiter.
3) Preview.
17. 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.
18. 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.
19. 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 clicking the drop-down box you are not allowed to input any value.
20. 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.
21. 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.
22. 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.
