Page History
| Table of Contents |
|---|
...
- Mark specific milestones of the Test with versions
- View all previous Test versions and revert to a particular version if needed.
- Have multiple active versions simultaneously, even of different Test Types, as you can execute them all independently.
| Info | ||
|---|---|---|
| ||
Please refer to this article: TTT - Test Versioning if you're wondering how to use Jira versions and Xray Test case versioning. |
Creating Test Versions
A Test Version is composed of the following fields on a Test issue:
...
- Choose the "New version" option on the Actions menu next to the version number in the top right corner of the Test Details web panel on a Test issue.
- A popup dialog will appear where you can set the version name and choose a base version to copy the definition from. You can also choose to make the new version the Default version.
- When you press "Create", the new version is created and selected automatically on the Test Details web panel.
...
Every Test has a default version. The default version is the one Xray chooses when you create a new Test Run for the Test without specifying any particular version. Therefore, the default version should be the most recent version ready to execute.When you create a Test, Xray automatically set the v1 as default.
The default version must be set manually by users. This can be done anytime using the "Set Default" option on the Actions menu next to the version selector.
| Tip |
|---|
To make sure you always run your Test with the version you aim, usually the most up-to-date one, you can manually mark a version as the default one. Note that there can be multiple versions active but only one can be marked the default one; therefore the "default" version is your preferred version. |
Also, the default version is the one found on the Xray custom fields:
...
- Press the "Execute in" dropdown button on the left toolbar in the Test Runs web panel.
- Choose a Test version to execute the Test.
- Fill in the necessary fields on the Create issue dialog and press "Create"
...
- Press the "Execute in" dropdown button on the left toolbar in the Test Runs web panel.
You can also create new Test Runs and specify a Test version when you add Tests to a Test Execution through the Test Execution issue screen.
Delete a Test Version
You can delete versions from a given Test using the Delete action provided by Xray in the Test details section. The Default version can not be deleted.
| Note |
|---|
When deleting a Test Version, all Test Runs executed for that version will also be deleted from Jira. |
To delete a given Test version from a Test:
- Choose the "Delete Version" option on the Actions menu next to the version number in the top right corner of the Test Details web panel on a Test issue.
- A popup confirmation dialog will be displayed. If the Test version being deleted has Test Runs, the number of Test Runs to be deleted will also be displayed to the user in the popup dialog.
- After the user confirms, the version and any associated Test Runs will be deleted from Jira.
History Changes
All changes related to Test specification fields on Test versions are also logged to Jira History view. Nevertheless, Xray provides a new History view named "Test History" that allows you to view all changes of the Test Issue and also filter changes by Test version.
