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:
- Select
- In the list, select the environment.
- 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.
- Click Save.
- Click the variable.
- Click the Pulldown Options tab.
- Add values for the pulldown as follows:
- 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
- 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.
- Click Create. The option is added to the
list.
- Repeat for each desired value.
- Click Save Variable.
- 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.
- Click Save Variable.
You can further work with options as follows:
- Use the 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.