Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Section
Column
width80%

9 October 2020

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

This version features support for xUnit XML reports, updating existing Test cases using the Test Case Importer, configuring the columns on the Test Runs List gadget, Document Generator improvements, and performance improvements when executing manual tests with lots of steps.

Discover the new features below. (smile)

Column
width20%

Image Removed Image Added

Table of Contents

...

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

Upgrading Xray to 4.2.x


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 is a one-time action that will run in the background so that Xray is still available during the upgrade. A  re-index operation of your Jira instance is required so that the internal data becomes 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

If you are upgrading from v3.2.x or v3.3.x to v4.2, 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 to 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 the recalculation of the custom fields, outside of business hours.
Column
width50%

Downgrading from Xray 4.2.x


Expand
titleDowngrading from versions ≥ 4.2.x to ≤ 4.1.x

The Test Step Custom Fields and Test Run Custom Fields of type User Picker will have to be deleted in the project configuration as they are not supported. Following that, the Test Runs that are using a User Picker field will have to be merged or reset. This includes Test Runs that have the field for the Test Run itself and also Test Runs for Manual Tests where the Test Steps contained the User Picker field.

Expand
titleDowngrading from any version

Downgrading from Xray 4.x to a version less than 3.2.0 implies that you must perform a re-index afterward. This is because from Xray 3.2.0 onwards, the content and format of what Xray indexes have changed.

Historical Coverage Gadget

Some configuration parameters for this gadget were modified as a result of supporting multiple projects whenever using a saved filter as a source. It is possible that some users will get errors on the gadget after downgrading from 4.x. If this happens, please edit the configuration to ensure the gadget is configured properly. 

...

Panel
borderColor#F3F3F3
bgColor#FAFAFA
borderWidth1px
Section

Configurable Test Runs List Gadget Columns


Column
width60%

Column
width40%

You are now able to configure the columns on the Test Runs List Gadget. You can add additional columns as well as remove any existing "default" columns.

The available fields are:

  • All Navigable Test issue fields (eg. Summary, Key, Component, Priority, etc.)
  • Test Execution Fields
    • Key
    • Fix Version
    • Revision
    • Test Environments
  • Dedicated Test Run Fields
    • Assignee
    • Executed By
    • Comment
    • Start Date
    • Finish Date
  • Test Run Custom Fields

Learn more here.



Panel
borderColor#F3F3F3
bgColor#FAFAFA
borderWidth1px
Section

Support for xUnit test results


Column
width80%

xUnit.net is a technology for unit and integration testing C#, F#, VB.NET, and other .NET languages. xUnit.net works with ReSharper, CodeRush, TestDriven.NET, and Xamarin. It is part of the  .NET Foundation.

Xray now supports xUnit execution results. You can send directly the XML report generated by xUnit into Xray, either using the  REST API  or the user interface.


Learn more more here.

Column
width30%



Panel
borderColor#F3F3F3
bgColor#FAFAFA
borderWidth1px
Section

Document Generator Improvements


Column
width60%

Column
width40%

You can now export Tests from within the Test Repository  Repository or the  Test Plan board using the Document Generator.

Context actions are provided on the folders and in bulk selections so that you can easily select and export the Tests you need.


When configuring templates, you also select the  the target  Xray entities as well as the  the scopes/screens  screens where these templates can be used. 


Document Generator now supports Test Run activity logs.


Jira administrators can also enable/disable the Document Generator feature.


Find out more about this feature here.



Panel
borderColor#F3F3F3
bgColor#FAFAFA
borderWidth1px
Section
Column
width60%

Performance Improvements

As part of our effort for continuous performance improvements, we have boosted the execution page load times, especially for manual Tests with more than 100 steps. These performance improvements can reach 80%.

Improving performance is an ongoing effort for us, so you can expect additional enhancements to come ahead.

Please take a look at the resources, Usage tips to improve performance, containing setup, and "best practices" for optimizing Xray performance. 

Column
width40%

...

In this release, you may find new articles to help you take advantage of xUnit XML reports. We also created a section for API testing and included a tutorial for Postman.

Here's a sum-up of all the relevant articles that we've added:

All New Features and Bug Fixes in this release

 

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

...