Page History
...
Parameters are embedded within the test specifications using the following notation: ${PARAMETER_NAME} for Steps definitions and Unstructured tests,and <PARAMETER_NAME> for Gherkin.
This notation is used to reference parameters within the test steps test definition. You can reference parameters on the Action, Data, Expected Result, and even on any test step custom fields that are 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
...
Currently, the test parameterization feature is only available for Manual Tests. Xray will support defining parameters and use datasets on BDD and generic test types as well.
Datasets
The parameters, along with their 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 | |||||||
---|---|---|---|---|---|---|---|
|
...
All iterations for a given test are executed within the context of the same test run. Each iteration can be expanded and the steps executed individually. The step parameters will be replaced by the corresponding iteration values. The steps affect the iteration status that, in turn, affects the overall test run status.
Please check the Execution page for more details.
...
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
...
7.2. Click on the "Generate all combinations." A confirmation dialog will appear. Confirming the changes will apply the cartesian product between the combinational parameter values and the seeding parameter rows.
8. Move left/right:
You can re-order any parameters in your dataset, by selecting the "Move left/right" option.
8.1. Open the options menu in either a Combinatorial or non-combinatorial (seeding) parameter, you will have a "Move left/right" option available. Notice that if the parameter is already place on the most outer left (right) position, the "Move left" (right) option is not available.
8.2. Select the move left/right option, This will swap the positions of the parameters.
9. After having performed all changes in the dataset, you need to press the "Save" button in order to persist the dataset into the database.
...