Page History
...
Parameters are embedded within the test specifications using the following notation: ${PARAMETER_NAME} or for Steps definitions and Unstructured tests,and <PARAMETER_NAME> for Gherkin.
This notation is used to reference parameters within the test definition. You can reference parameters on any in 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.
...
Section | |||||||
---|---|---|---|---|---|---|---|
|
Dataset scopes
...
Info | ||
---|---|---|
| ||
We have plans to improve how test environments are managed in Xray. It will be possible to specify or generate combinations of environments for different variables. Please check our roadmap. |
Defining a parameterized test
...
Manual Steps
- Create or edit a given step using either the inline view within the test issue or the steps dialog.
- When specifying a step, to reference a parameter you have two options:
- 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.
- 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.
...
Generic or Unstructured definition
...
- Edit the definition using the inline view within the test issue.
- To reference a parameter, you have two options:
- 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.
- 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.
...
Gherkin Scenarios
...
- Create or edit a given step using either the inline view within the test issue or the steps dialog.
- 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
...