Versions Compared

Key

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

February 15th17th, 2023

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

This version features support for issue archiving in Jira data center. Users will be able to archive existing executions from Xray, this version also adds support for Xray Enterprise, the next level of Enterprise Quality Management Remote Jobs trigger, a seamless way to integrate with your CI/CD platform and In-App Notifications a new way to get the latest news from Xray.

Column
width20%

Table of Contents

...

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

Upgrading Xray to 6


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 to make 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 and 3.3.x

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

Downgrading from Xray 6


Expand
titleDowngrading to any version

Downgrading from Xray 5.x.x to a previous version will have the following side - effects on Test Runs with a dataset:

  • Test parameters will no longer be converted on the Test Run page, ; this includes Test Step definitions and Pre-Conditions;
  • When loading a Test Run created on version 5.x.x, the merge/reset message will be displayed;
  • When merging a Test Run created on version 5.x.x with the new Test Step definition, all Test Step results will be updated but the reset/merge message will still be displayed;
  • A Test Run created on version 5.x.x with iterations will be displayed in a "flat mode." The iterations will no longer be available and all the Test Step results from each iteration will be presented on in the Test Steps section;
  • After the downgrade, the integrity checker will fail on "Check for invalid Mementos" for all Test Runs created on version 5.x.x. We recommend running the integrity checker before downgrading to get rid of eliminate possible invalid mementos.

Downgrading from Xray 6.x.x to a previous version will have the following side - effects:

  • Test Issue:
    • A Call Test will be converted to a regular test step with a warning message
  • Test Run Page
    • The Merge/Reset action will be displayed
Expand
titleDowngrading to versions ≤ 4.1.x

The Test Step Custom Fields and Test Run Custom Fields of the 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 with 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 6.x to a version less than 3.2.0 implies that you must perform performing 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 due to supporting multiple projects whenever projects 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

Remote Jobs Trigger

Image Modified

Column
width40%


Column
width60%


This highly requested Xray Enterprise feature allows triggering triggers CI/CD builds without ever leaving Xray.

Multiple remote triggers management

Users can manage multiple build parameters and configurations and streamline their test execution for both manual and automated tests. A new configuration page is available at the project-level settings, allowing the setup of multiple configurations for the main CI/CD platforms together with and specific parameters to allow a more precise build control.

Learn more here.

One-click Remote Jobs Triggering

Testers can reduce wasted time and the overhead of switching between multiple tools by automating the test process and reporting results with a simple push of a button. Simply select a configured job in Xray from the Test Plan or Test Execution, and the results are published after the job runs remotely. Remote jobs job triggering can bridge the gap between manual and automated tests for broader quality lifecycle management.

Learn more here.



Panel
borderColor#F3F3F3
bgColor#FAFAFA
borderWidth1px
Section

In-App Notifications


Column
width60%

Receiving Announcements in Xray

With In-App MessagingNotifications, you can stay up to date with Xray new 's newest versions, features, and other information, by receiving product and release-related announcements.

Clicking When you click on the snippets showing up on the bottom left side, you are taken to that announcement detail, and by clicking on the floating button on the bottom right, you can see the history of all received announcements.

Opt-in/Opt-out

You can chose choose to turn off In-App Notifications selectively , or totally in the "Xray Notification Settings" page accessible from your user profile menu. 

You can also see the history of all received announcements in on this page.

Learn more here.

Column
width40%

...

Documentation is always important, and sometimes you may miss it. We added a set of relevant articles to our already extensive documentation.

In this release, we have created a new section dedicated to the brand-new Test Case Designer (available on Xray Enterprise)  where you . You will find many articles full of tips related to test modeling, and pairwise and n-wise testing.

We also invested on in refining some existing Xporter and Document Generator templates, document documenting some of them, so you can use them as-is or customize them to your own test reporting needs. 

...

...