Adding test variant fields

Test variants are variable attributes of a tested application, such as operating systems, databases, or client types. When generating manual test runs, you select the test variant values to use and a manual test run is generated for each unique combination of the selected values.

For example, if you test applications on multiple operating systems, you can create a test variant named Operating System that includes values for Windows, Mac, and Linux. When generating manual test runs for a component only supported on Windows, select that value so manual test runs are not generated for the other operating systems.

Before you can use test variants, you need to add them to the project. Test variant fields are displayed in test cases and manual test runs. See Managing test variants for manual tests.

1. Click Administration.

The Admin Home page opens.

2. Click Test Variants.

The Test Variants page opens.

3. Click Add.

The Add Test Variant page opens.

4. Enter the Field name.

The Long label and Field code field values are automatically added. You can change them.

  • Long label—The long label can help users distinguish between the fields with the same name in various areas of Helix ALM. The long label is displayed in the Name column on the Test Variants page.
  • Field code—A field code is a variable that is replaced with a specific field value. They can be used in test cases, emails, reports, and other areas. For example, if you use a %Z_OPERATINGSYSTEM% field code in a test case, it is replaced with the selected Operating System variant value when manual test runs are generated.

5. Enter or select the field Properties.

  • Value list—Select the list of values to use for the test variant field.
    • If the project does not have a list of values you want to use for the field, select Add a new list. Click Configure List Values to add the value list. See Configuring dropdown field values. When you finish adding the list, you return to the Add Test Variant page and the list name is displayed.
    • If the project already has a list of values you want to use for the field, select Use an existing list and then select the list to use. Other fields using the list are displayed for reference. Click Configure List Values to make any changes to the value list. See Configuring dropdown field values. When you finish adding the list, you return to the Add Test Variant page.
  • Required—Select to make the field required. Users cannot save an item until they select a value in the field.
  • Allow users to select multiple values—Select to allow users to select more than one value in the list.

6. Click Save.

The variant is added. You return to the Test Variants page.