Migration Tool for XRAY Test Management Tool Now Available

28-May-2024 by Adam Sandman Product News

With the final sunsetting of Jira Server in February 2024, customers that are running Jira Server are looking at their options:

  • Upgrade to Jira DataCenter, which is designed for larger organizations, and has a minimum 500 users pricing model.
  • Migrate to Jira Cloud, which is the preferred option by Atlassian.
  • Look for an alternative to Jira.

However, many customers using some of the plugins for Jira Server, such as XRAY for test management, are also looking at different options. In the case of XRAY, one of the issues has been that the cloud version of XRAY works differently than the Server/DataCenter version, and many customers have been unable to migrate from XRAY Server to XRAY Cloud.

Therefore, we at Inflectra have extended our Jira migration tool to support the migration of XRAY artifacts to SpiraTest. This lets us assist customers in two different use cases:

  • Jira Server + XRAY Server customers that want to remain on-premise, and are looking to migrate to SpiraTeam or SpiraPlan
  • Jira Server + XRAY Server customers that want to move to the cloud, and are looking to migrate to Jira Cloud + SpiraTest Cloud.

How It Works

The XRAY additions to our Jira Migration Tool allows you to simply connect to your instance of Jira (either Cloud, Server or DataCenter) and choose which XRAY artifacts you want to migrate (test case and/or test runs) in conjunction with the standard Jira artifacts:

Jira Migration Tool with XRAY Options

We all the selected data project at the same time from Jira to Spira. We do this because many of the XRAY objects are in fact simply customized Jira issues (test case, test execution and test set/plan) and will be associated with other related Jira issues (requirements and defects). This ensures that you can view the resulting requirements test coverage, and other key metrics from within Spira (post migration).

Mapping Jira and XRAY Types

In the Spira/Jira artifact mapping screen, you will generally map the XRAY artifacts as follows:

  • Test Cases and Pre-Conditions are mapped to SpiraTest Test Cases
  • Test Sets and Test Plans are mapped to SpiraTest Test Sets
  • Test Executions and Sub Test Executions are mapped to SpiraTest Test Runs

What is Migrated

The XRAY part of the Jira migration tool currently handles the following:

  • Test Case Folders (Repository Path)
    • Name
    • Description
  • Test Cases
    • Standard Fields
    • Custom Fields
    • Attachments
    • Repository Path
    • Test Parameters / Data Sets
    • Associations to Requirements
  • Test Steps
    • Step Description
    • Expected Result
    • Sample Data
    • Attachments
    • Linked (Nested) Child Test Cases
    • Test Parameter Values
  • Test Sets (Test Sets + Test Plans)
    • Name
    • Description
    • List of Mapped Test Cases
  • Test Runs (Test Executions, Sub Test Executions)
    • Name
    • Description
    • Execution Status
    • Attachments
    • Fix Version / Release
    • Custom Properties
  • Test Run Steps
    • Step Description
    • Expected Result
    • Actual Result
    • Sample Data
    • Attachments
    • Association to Defects/Bugs

The following screenshots illustrate the data imported from some sample XRAY projects (sanitized):

Test Case Repository

The test case folders, hierarchy and names are imported, along with the IDs of the various XRAY test cases:

Test Steps

The migration tool will migrate XRAY test cases that contain standard steps with an Action, Description, Description and Sample Data:

Note that it will convert XRAY parameters from the formal used in XRAY to those in SpiraTest. It also migrates over the test parameter values from the corresponding XRAY data set.

It will also correctly migrate over any test cases that contain links to other test cases as their steps (or a combination of both):

Test Sets and Test Plans

The migration tool will migrate the XRAY test sets and test plans into SpiraTest as test sets:

The test sets will be imported into a flat list in SpiraTest (that you can organize by folder, post-migration), together with the mapping to the various test cases included in the XRAY test set or test plan.

Test Executions

The XRAY test executions and sub-test executions will be imported into SpiraTest together with their mapped test cases and test runs. These will be migrated into SpiraTest as a test run. The various fields and statuses are faithfully migrated.

The test run migration includes the test run step level of detail, with the appropriate XRAY test run step results imported, including the expected result, actual result and any test parameter values:

What About Other Jira Test Management Plugins?

We have heard from other potential customers using different Jira test management plugins that they are also looking for migration options. So, depending on customer demand, we anticipate developing similar Jira migration extensions for the following test management plugins:

  • Zephyr Squad from SmartBear (formerly Zephyr)
  • Zephyr Scale from SmartBear (formerly TM4J from Adaptavist)