Combo Box refresh variable for web reports

ComboBox refresh variables prompt users to select a value from a specified table column. The selected value is used to filter the data sources in the report that are dependent on the variable.

The list of values is displayed in a searchable drop-down list (the combo box). The list can be filtered to only show a subset of the values from the column.

This topic provides information on how Combo Box refresh variables behave in web reports and their configuration settings. For general information on defining refresh variables for web reports and creating dependencies between refresh variables and data sources, see Configuring refresh variables for web reports.

NOTE: When using a Combo Box refresh variable, the user can only select one value from the list. If you want the user to be able to select multiple values, use a Grid variable instead.

Variable behavior

The variable displays as a drop-down list with a searchable entry box. The user can scroll the list and select the value directly, or type into the box to find a particular value.

Example ComboBox refresh variable

The drop-down list is limited to displaying the first 100 values. However, all values can be found by using the search box. The search matches on the primary value, any description columns, and any additional columns included in the display format.

The values in the drop-down list are sorted based on the display format if defined, otherwise based on the value column.

Variable properties

This section explains how to complete the variable properties for a Combo Box variable in a web report.

General variable properties

All refresh variables use a common set of general properties such as the variable display name, and whether the variable is enabled or required. Any special considerations for Combo Box variables are noted.

(missing or bad snippet)

Variable-specific properties

The following additional properties apply to ComboBox variable types:

Item	Description
Choose Variable Type	Specifies the variable type. Select Combo Box to allow the user to select a single value from a table column.
Column	(missing or bad snippet)
Placeholder Text	Optional. Specifies placeholder text to display within the combo box until a value is selected. If blank, then the default text "Choose a value for ColumnName" is used.
Default Value	(missing or bad snippet)
Column Filter	(missing or bad snippet)
Display Format	(missing or bad snippet)
Tooltip Column	(missing or bad snippet)