Parameterized Tests

To create a test with a set of parameters:

1. Go to Test Management > Test Library.

2. Click Add New.

3. Specify the information about a new test.

4. On the Steps tab, add the needed steps, then enclose the name of your token in percent signs within the description of the step and in the Expected Result field.

   

   Click the image to enlarge it.

   For example, if you want to create a parameter that represents the first name of a user, it might look like this:

   %firstname%

   In parameter names, use only valid alphanumeric characters and underscore – that is, no symbols, spaces, extended or special characters.

5. Go to the Parameters tab. Click Add Parameter. A row for a new parameter will appear:

   

   Click the image to enlarge it.

6. Give your parameter a name. In our case, it should look like this:

   firstname

7. (Optional) Supply an arbitrary description in the Description column.

8. (Optional) Specify a default value for this parameter in the Default Value column.

9. Click Save and Close to apply the changes.

After this, when you launch the Test Runner for this test, a dialog window will appear, offering you to provide values for all parameters included in this test:

The parameter placeholder (that is, %firstname% in our case) will be replaced with the value you specify.

To use the same set of parameters within the test set:

1. Create a test set.

2. Go to the Parameters tab. Click Add Parameter. A row for a new parameter will appear.

3. Give your parameter a name.

4. (Optional) Supply an arbitrary description in the Description column.

5. (Optional) Specify a default value for this parameter in the Default Value column.

6. Go to the Tests tab and append the needed tests to the new test set. For each test, a dialog will appear, offering you to specify the values of this test’s parameters within the test set.

   • If you want these parameters to retrieve values from the test set parameters, specify them as parameter placeholders. For example, if you have the email-address parameter in the test, and you want its value to be equal to the value of the test set’s email parameter, enter the following:

     %email%

   • If you want these parameters to use default values from the test itself, specify them as usual.

7. Click Save and Close to apply the changes.

After this, when you launch the Test Runner for this test set, a dialog window will appear, offering you to provide values for all parameters included in this test set. The parameter placeholder will be replaced with the value you specify.