Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Parameters are embedded within the test specifications using the following notation:  ${PARAMETER_NAME}f or Steps definitions andUnstructured tests, and <PARAMETER_NAME> for Gherkin.

This notation is used to reference parameters within the test definition. You can reference parameters on any text-based test step custom field, Unstructured definition, or Gherkin Scenarios.

Parameters are defined within datasets. However, it is possible to reference a parameter that is not yet defined (meaning it does not have a corresponding name within the dataset). In this case, the parameter will be highlighted in red.


Datasets

The parameters, along with their values, are defined within a dataset. A dataset is a collection of data represented with a tabular view where every column of the table represents a particular variable (or parameter), and each row corresponds to a given record (or iteration) of the dataset.

...

Defining a parameterized test

In order to reference parameters within test steps:

  1. Create or edit a given step using either the inline view within the test issue or the steps dialog.
  2. When specifying a step, to reference a parameter you have two options:
    1. Start typing ${. If there is a default dataset defined on the test, you should see a list of the available parameters. Choose the desired parameter using the cursor keys or mouse. The parameter will be placed with the text.
    2. Use the toolbar button ${. After pressing this button, and if there is a default dataset defined on the test, you should see a list of the available parameters. Choose the desired parameter using the cursor keys or mouse. The parameter will be placed on the cursor position.


In order to reference parameters within the Unstructured definition:

  1. Edit the definition using the inline view within the test issue.
  2. To reference a parameter, you have two options:
    1. Start typing ${. If a default dataset is defined on the test, you should see a list of the available parameters. Choose the desired parameter using the cursor keys or mouse. The parameter will be placed with the text.
    2. Use the toolbar button ${. After pressing this button, and if there is a default dataset defined on the test, you should see a list of the available parameters. Choose the desired parameter using the cursor keys or mouse. The parameter will be placed on the cursor position.

In order to reference parameters within Gherkin Scenario:

  1. Create or edit a given step using either the inline view within the test issue or the steps dialog.
  2. When specifying a Scenario, to reference a parameter you should start typing <If there is a default dataset defined on the test, you should see a list of the available parameters. Choose the desired parameter using the cursor keys or mouse. The parameter will be placed with the text.

Creating a dataset

In order to create or edit the default dataset (within a test):

...