User Guide | 2019.2

Adding test variant custom fields

Test variants are variable attributes of a tested application, such as operating systems, databases, or client types. When generating test runs, you select the test variant values to use and a 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 test runs for a component only supported on Windows, select that value so test runs are not generated for the other operating systems.

Before you can use test variants, you need to add them as custom fields. Test variant fields are displayed in test cases and test runs. See Managing test variants.

Tip:  You can use test variant custom field codes in test case text fields. When you generate test runs, the field code is replaced with the variant value used to generate the test run. Field codes in test case custom fields are only replaced in test run custom fields if the fields are mapped. See Configuring item mapping rules.

1. Choose Tools > Administration > Custom Fields.

The Setup Custom Fields dialog box opens.

2. Select Test Variant as the item Type.

Test variant custom fields are displayed.

3. Click Add.

The Add Custom Fields dialog box opens.

4. Enter a Field name.

5. Enter the Long label.

Long labels are displayed in drop-down lists and help users distinguish between the same fields in different events.

6. Enter the Field code.

The field code automatically generates data and is used with email templates and reports.

7. Select an existing Value list or click Setup List Items to add a custom value list to the pop-up menu. See Configuring custom value lists.

8. Click OK to save the changes.