Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
width80%

June 2nd, 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.


Column
width20%

Table of Contents

Upgrade Notes

Panel
borderColor#F3F3F3
bgColor#FAFAFA
borderStylesolid
Section
Column
width33%

Upgrading Xray to 7


Expand
titleUpgrading from versions < 3.2.x

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.

Note
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.
Expand
titleUpgrading from versions 3.2.x and 3.3.x

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.

Note
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.
Column
width33%

Downgrading from Xray 7


Expand
titleDowngrading to any version

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 

Panel
borderColor#F3F3F3
bgColor#FAFAFA
borderWidth1px
Section

Test Case Versioning

Column
width40%



Column
width60%


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

 

Jira
serverXpand IT Issue Tracker
columnIdsissuekey,summary,issuetype,created,priority,status,resolution
columnskey,summary,type,created,priority,status,resolution
maximumIssues50
jqlQueryproject = XRAY and fixVersion = "7.0.0" and level is EMPTY and issuetype not in subTaskIssueTypes() order by issuetype desc
serverIdb6309ad5-5416-33d6-9a09-a3e02f20d3e6