Creating pulldowns for a variable

About this task

You can define multiple possible values for a variable. The values you provide are displayed as selectable options in a pulldown.

To create a pulldown for an environment variable:

  1. Select Projects > Environments.
  2. In the list, select the environment.
  3. Click Add Environment Variable. Fill in its properties as follows.
    • Name: enter the environment variable name.
    • Type: select Pulldown List.
    • Action: select an action.
    • On Project: select a property.
  4. Click Save.
  5. Click the variable.
  6. Click the Pulldown Options tab.
  7. Add values for the pulldown as follows:
    1. Specify a name for the pulldown option. The user sees this as a choice name in the pulldown. Pulldown names can use only alphanumeric characters (a-z, A-Z, 0-9) and the underscore character ( _ ). The maximum length is 255 bytes:
      • Single-byte character sets: 255 characters
      • Double-byte character sets: 127 characters
    2. Specify a value for the pulldown option. You can set a value that is the same as the variable name if you want the user to see the value that is being used. If a variable is used in the value, it is interpreted on the operating system where the step runs. It is not preprocessed or evaluated before the step runs.
    3. Click Create. The option is added to the list.
    4. Repeat for each desired value.
  8. Click Save Variable.
  9. Set the default option presented. Do this after you have populated Pulldown Options and saved the variable. Click the environment. In the Details tab, change the Default Option property from --NONE-- to the name of the value you want to be presented by default.

    Note that when viewing the Details tab for the variable, if Default Option is not set (its value is --NONE--), the first item in the Pulldown Options list is presented by default in the Value column.

  10. Click Save Variable.
You can further work with options as follows:
  • Use the Edit icon Edit icon to the left of each option name to position options in the list or delete them.
  • Click on an option to edit it. You can edit both the Name and Value fields. Click Save when done.
  • Click Clear to clear the Name and Value fields. You normally do this after viewing an existing option to create a new option.

Feedback