BuildForge Help

Creating a Long Value List for a Variable

If the list of values for an environment variable exceeds the 255-character limit, you can:

  1. Create multiple environment variables (each less than 255 characters) to hold the values.
  2. Create a separate variable to join the multiple-variable lists.
    Note: Do not use the ${varname} variable syntax with this feature, and make sure the .include occurs before the combined variable.

To create long value list, do the following:

  1. Create an environment to manage the environment variables. In this example, the environment is called MyLongValueList.
  2. Create as many environment variables as you need to hold the values. Each variable must be 255 characters or less.

    Separate individual values in the list using the pipe (|) character, as shown for environment variables A and B:

    • A = "value1|value2|value3"
    • B = "value4|value5|value6"
    Note: Optionally set the On Project property for A and B to Suppress Display to prevent them from being displayed and selected when the project is run.
  3. Use the .include command to add the environment MyLongValueList to your project's environment:
    .include = "MyLongValueList"
    Note: Make sure the .include is listed before the combined environment variable in the project environment.
  4. Define a new environment variable in your project environment to combines the value lists in environment variables A and B.
    LongList = $A|$B
  5. Execute the project. When you execute the project, the system combines the values from and A and B and lists them in the Value list box.