Starting from version 7.0 of Xray Enterprise, users can create different versions of a Test case within the same Test issue. A Test case can evolve as the requirements change or improvements are made to the application under test. Although Xray logs test specification changes in the Jira history, it is not easy to revert to a specific test case version. With Test case versioning, you can now create multiple versions of the same Test allowing you to:
Please refer to this article: TTT - Test Versioning if you're wondering how to use Jira versions and Xray Test case versioning. |
A Test Version is composed of the following fields on a Test issue:
A Test Version is defined with a name. You can choose the name for the versions explicitly when creating new versions. Xray will try to generate the version name automatically based on the latest version if the name ends with a suffix that is recognized as a version number. Nevertheless, you can always change this auto-generated name. It is also possible to rename existing versions.
To create a new version:
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.
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.
Also, the default version is the one found on the Xray custom fields:
The default version of a Test can not be deleted or archived.
To set the default version:
You can also set the default version through the "Manage Versions" dialog.
When Xray enterprise is installed, a dropdown selector field for the Test versions will be provided on the top right corner of the Test Details web panel on the Test issue. This dropdown provides all the Test versions as options and groups them into Active and Archived. The Test Type is also displayed for each version. The default version will be identified with a "default" lozenge.
When the Test issue is opened, the default version will be selected.
The Pre-Conditions web panel is also affected by the currently selected version as it only displays the Pre-Conditions associated with the selected version.
To switch between versions, you only need to choose a version from the versions dropdown selector:
To better view and manage all versions of a Test, you can access a dialog with a list of all the versions in the Test. Here you can do specific actions like:
To open the dialog:
It is also possible to archive (and unarchive) Test versions. Archived versions can not be executed. They exist just for the historical record.
All Test runs of archived versions will remain accessible as a copy of the Test specification is always made whenever a Test Run is started.
To archive a Test version:
The unarchive version action is the opposite of archiving and can also be found on the same Actions menu next to the version number in the top right corner of the Test Details web panel on a Test issue.
You can also archive Test versions from the manage versions dialog.
You can create new executions of a specific version from the Test Runs web panel on the Test issue page.
To create a new Test Execution:
To add a new Test Run into an existing Test Execution issue:
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.
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.
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:
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.