Choice
A Choice element is a menu from which the user can select a single item. To add a Choice element and populate the menu with values, follow the steps below:

1. Expand the Style Studio Toolbox panel. Drag a Choice component from the Toolbox panel to the desired location in the report.
2. Right-click the Choice element, and select 'Properties' from the context menu. This opens the 'Choice Properties' dialog box.

3. Select the Choice tab.
4. To populate the menu options from an existing data source, follow the steps below:
If you select the 'Query' option in addition to the 'Embedded' option, the query results are merged with the embedded list values.
a. In the 'List Values' panel, select the 'Query' option and press 'Edit'. This opens the 'Selection List' dialog box.

b. Select the Data tab. Choose the data source that will provide the labels and values for the Choice element.

If you want the labels and values to be the same, select only a single column.
c. Select the Columns tab. Choose one column to provide the labels for the Choice element, and one column to provide the values for the Choice element.

The labels determine the choices that are displayed to the user in the menu. The values determine the corresponding data that is submitted when the user makes a selection. To swap the 'label' field with the 'value' field, click the 'Move up' or 'Move down' arrow above the right panel. For information about the other buttons, see Binding Data to a Table Element.
To adapt the menu choices based on user input, specify a parameterized condition. See Parameterizing a Condition.
d. (Optional) Select the Condition tab. Specify a condition to filter the options (labels/values) displayed by the Choice element. See Filtering Data in Data Binding Wizard for more information on specifying a filter.
e. Press 'OK' to close the 'Selection List' dialog box.
5. To populate the menu options by manually entering the label/value pairs, follow the steps below:
If you select the 'Embedded' option in addition to the 'Query' option, the embedded values are merged with the query results.
a. In the 'List Values' panel, select the 'Embedded' option and press 'Edit'. This opens the 'Selection List' dialog box.

b. Press the 'Add' button to add a new label/value pair. Double-click on a label or value to edit the text.

The labels determine the choices that are displayed to the user in the menu. The values determine the corresponding data that is submitted when the user makes a selection.
c. Check the 'Selected' box to make the corresponding label/value pair the default option in the Choice box.
d. Repeat the above steps to add additional labels.
e. To reorder the label/value pairs, press the arrow buttons above the label/value list.
f. Press 'OK' to close the 'Selection List' dialog box.
6. (Optional) To enable the Choice element to submit the user's selection immediately (without requiring a 'Submit' button), enable the 'Submit on Change'. This is especially useful in conjunction with parameter staging, because it allows the user's selection to enable the next control in the input sequence. See Staged Parameters for more information.
7. Press 'OK' to close the 'Choice Properties' dialog box.
| << Radio Button | © 1996-2013 InetSoft Technology Corporation (v11.5) | List >> |