Show TOC

 Dropdown BoxLocate this document in the navigation structure

Definition

Web item that allows you to display and select contents in a dropdown box.

Use

You can specify the content of the dropdown box as follows:

  • Characteristic Values for Filtering

    Using the Dropdown Box Web item, you can easily filter one or more connected data providers by a characteristic value. When you select an entry from the dropdown box, the connected data provider is filtered according to this value. If a different method is used to select a filter value for the characteristic in the dropdown box, the current filter value appears in the dropdown box.

  • Query View Selection

    By selecting an entry from the dropdown box, you can switch, in one step, from a data provider and its display (in a table, for example) to another data provider that may be displayed in a different way (in a chart, for example).

  • Fixed List of Options

    When you select an entry from the dropdown box, an associated command from the Web Design API is executed.

  • Fixed List of Options: Manual Update

    When you select an entry from the dropdown box, an associated command from the Web Design API is executed. It is also possible to trigger a manual update.

  • Variable Selection

    When you select an entry from the dropdown box, the data displayed depends on the variable selection. 

Structure 

The following information list the parameters for the Dropdown Box Web item, arranged according to the various parameter groupings.

Display

Parameter Description

Width in Pixels (WIDTH)

You use this parameter to specify the width of the Web item.

Height in Pixels (HEIGHT)

You use this parameter to specify the height of the Web item.

Visibility (VISIBILITY)

You use this parameter to specify whether the Web item is to be visible in the Web application.

With Tray (WITH_TRAY)

You use this parameter to specify whether the Web item is to have a symbol that allows it to be expanded and collapsed in the Web application. For more information about this parameter, see Parameter Tray .

Internal Display

Parameter Description

Maximum Length of the Text (TEXT_MAXLENGTH)

You use this parameter to specify the maximum text length for the values.

Maximum Number of Displayed Values

(ENTRIES_MAXCOUNT)

You use this parameter to specify the maximum number of values to be displayed in the dropdown box.

Behavior

Parameter Description

Allow Navigation (INTERACTION_ALLOWED)

You use this parameter to specify whether navigation or other interaction, such as in the Web application, is to be possible. 

Data Binding

Parameter Description

Data Binding Type (DATA_BINDING_TYPE)

The default value is: "CHARACTERISTIC_SELECTION"

Char/Structure Member:

CHARACTERISTIC_SELECTION

Query View Selection:

QUERY_VIEW_SELECTION

Fixed List of Options:

STATIC_OPTION_LIST

Fixed List of Options: Manual Update:

STATIC_OPTION_LIST_MANUAL

Variable Selection:

VARIABLE_SELECTION

You use this parameter to specify the content of the entries in the dropdown box: In the dropdown box, you can display characteristic values for filtering, a selection of query views and their graphical presentation, a fixed list of options that you have defined, or a fixed list of options with manual update. You can also add variable values to the selection in the dropdown box.

Additional parameters must be set, depending on the data binding type. See the links below.

Additional parameters must be set, depending on the selected data binding type. For more information about each of the data binding types, see:

Data Binding Type CHARACTERISTIC_SELECTION

Data Binding Type QUERY_VIEW_SELECTION

Data Binding Type STATIC_OPTION_LIST

Data Binding Type STATIC_OPTION_LIST_MANUAL

Data Binding Type VARIABLE_SELECTION