Xray Test Case Migration

Note:

The Xray add-on is available as an optional paid add-on. Contact sales@migrayt.ai to enable it for your account. Xray for Jira Cloud must be installed in your Jira project before enabling this add-on.

What Gets Migrated

ADO Work Item Type	Migrated As
Test Case	Xray Test issue with structured test steps
Test Suite	Xray Test Set with linked Test issues
Test Plan	Xray Test Plan

Test Steps

ADO Test Cases store test steps as XML in the Microsoft.VSTS.TCM.Steps field. Migrayt parses this XML and creates structured test steps in Xray via the Xray Cloud API.

Each test step preserves:

Action — What the tester should do
Expected Result — What should happen

ADO Step XML:
  <step id="1" type="ActionStep">
    <parameterizedString>Navigate to Login page</parameterizedString>
    <parameterizedString>Login page is displayed</parameterizedString>
  </step>

Xray Step:
  Action:          Navigate to Login page
  Expected Result: Login page is displayed

Test Set Membership

ADO Test Suite membership (which Test Cases belong to which Test Suite) is preserved by creating Xray Test Sets and linking the corresponding Test issues.

Execution History

ADO Test Run results (pass/fail history) are not migrated. Only the test definitions (steps) and groupings (suites) are migrated. Historical execution results must remain in ADO for reference.

Configuration

Configuration	Description
`xray_client_id`	From Xray Cloud → Settings → API Keys
`xray_client_secret`	From Xray Cloud → Settings → API Keys

Order of Operations

The Xray add-on runs after the core migration completes. Test Case issues are created as standard Jira issues first (by the core engine), then enriched with test steps by the Xray plugin. This means Test Cases appear in Jira immediately during the migration, with step enrichment happening in a second pass.

Limitations

Shared steps (ADO's reusable step groups) are inlined into each test case rather than linked as shared steps in Xray, because Xray does not have a direct equivalent.
Parameterised test cases (data-driven tests with parameter sets) are migrated with the parameter names intact in the step text, but parameter value datasets are not migrated.
Test attachments (screenshots, evidence files) are migrated as standard attachments on the Jira issue, the same as any other work item attachment.

7pace Time Logs Authentication