June 8th, 2023

The Xray team is proud to announce the release of Xray 7.0.0.

This version features Test case versioning for Xray Enterprise, test cases evolve when 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.


Upgrade Notes

Upgrading Xray to 7


If you are upgrading from a version lower than 3.2, this implies that an upgrade task will run to pre-calculate historical data. This one-time action will run in the background so that Xray remains available during the upgrade. A  re-index operation of your Jira instance is required to make the internal data searchable and usable by Xray.

Please be aware that this upgrade task will run immediately after updating Xray. As this operation can take some time and use a considerable amount of server resources, we suggest scheduling the upgrade of Xray outside of business hours. It is always possible to cancel the recalculation operation in the Xray configuration section → Custom Fields → Maintenance.

If upgrading from v3.2.x or v3.3.x to v7, you must recalculate data in the Xray configuration section → Custom Fields. This recalculation is necessary because of the huge improvement in the amount of data that Xray needs to add to the table and the Lucene indexes.

As this operation can take some time and use a considerable amount of server resources, we suggest scheduling the upgrade of Xray and recalculating the custom fields outside of business hours.

Downgrading from Xray 7


Downgrading from Xray 7.x.x to a previous version may have the following side effects:

After creating some specific data using Test Case Versions, the user may have some glitches when downgrading to a specific version of Xray

  • On a Test Issue, multiple manual test versions with steps, when downgrading the test issue will show all steps from all the versions
  • On a Test Issue, multiple manual test versions with specific datasets, when downgrading the test issue will show the parameters from all the datasets 
  • On a Test issue, having different test versions linked to the same precondition issue when downgrading, the test issue will show an integrity error instead of showing the precondition table


    And the precondition will show the warning of being linked to an archived test

Release highlights 

Test Case Versioning




This highly requested Xray Enterprise feature allows users to create and manage multiple versions of the same test case, to easily track and revert changes in your test specification.

Why Test case versioning?

Test cases are not static. They evolve when 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 a new version of a test case with a single click
  • Compare different versions of a test case and see what has changed
  • Restore a previous version of a test case if needed
  • Assign a test case version to a test execution or a test plan
  • Track the test execution results for each test case version
  • Mark specific milestones of the Test with versions
  • Have multiple active versions simultaneously, even of different Test Types, as you can execute them all independently.

How does Test case versioning work?

Test case versioning works in the same way as versioning of other issue types in Jira. Since Xray's Tests are Jira issues, we follow the same approach so your users work in the same manner they already do.

To create a new version of a test case, you just need to click on the "Create new version" button on the test issue screen. 

Test case versioning is a powerful feature that can help you manage your test specification more efficiently and effectively. It is available for Xray Enterprise customers only.


If you want to learn more about Test case versioning, please visit our documentation page here.





Just one more, yet important, thing...

Documentation is always important, and sometimes you may miss it.

This time we added some process-related articles detailing how to integrate and perform exploratory testing with Xray and some ideas on implementing acceptance criteria and tracking related testing results.


Here's a summary of all the relevant articles that we've added and updated recently:


All New Features and Bug Fixes in this release

 

Key Summary T Created P Status Resolution
Refresh



  • No labels