Editable Dropdown Parameters

Some parameters provide dropdown menus, also known as enum parameters, that allow users to select a value from a predefined list of options.

These parameters simplify configuration by presenting common values directly in the user interface.


Standard dropdown parameters contain a fixed list of predefined options.

Users can select one of the available values from the list.

This type of parameter is commonly used when only a limited number of valid values exist, such as:

  • mode selections

  • device configurations

  • predefined states


Editable Dropdowns

Some dropdown parameters are editable.

In this case, the dropdown still provides a list of predefined options, but users can also enter custom values or modify the available options.

This allows users to adapt the dropdown list to the needs of a specific project.


Editing Dropdown Entries

The list of entries for an editable dropdown can be modified through the Parameter Settings.

To edit the dropdown entries:

  1. Right-click the parameter

  2. Select Parameter Settings

  3. Open the dropdown editor

Within the editor, new entries can be added using the + icon.

Each entry contains two values:

Field
Description

Key

The label displayed in the dropdown menu

Value

The internal value used by the system or programming logic

The Key defines what the user sees in the interface, while the Value can be used by workflows, scripts, or other systems.


Using Values in Programming

When working with dropdown parameters in programming systems, it is possible to reference either:

  • the Value defined in the dropdown entry

  • the index position of the entry in the list

Using the Value is generally recommended.

If the index is used instead, changing the order of the entries may break existing logic.

Defining explicit values ensures that the parameter remains stable even if the list order changes.


Reordering Entries

Entries can be reordered easily using drag and drop inside the dropdown editor.

This allows users to organize the dropdown list in a logical order without needing to recreate the entries.

Last updated