Quick Import from Xray Server/DC

Import projects and test cases from self-hosted Xray Server or Data Center into BrowserStack Test Management using Quick Import.

Quick Import copies your projects and test cases from Xray Server/DC into BrowserStack Test Management. You do not have to export files or map fields. After you connect your Jira instance and select projects, the import runs in the background. Test Management emails you when it completes.

Xray Server/DC is the Xray plugin on a self-hosted Jira Server or Data Center instance. If your Xray runs on Jira Cloud, follow Quick Import from Xray Cloud instead.

Prerequisites

Before you connect, make sure that:

• Your Jira Data Center version is 9.x.
• Your Xray Server/DC version is between 6.x and 8.x.
• You have a Jira personal access token (PAT) for an account that can access all projects you want to import.

Start a Quick Import

Click Quick Import on the top-right corner of the dashboard, or start a Quick Import from an existing project.

On the Quick Import screen:

1. In the Select your preferred tool to import test cases from section, select Xray.
2. In the Select Xray type section, select Xray Server/DC.

Connect to Xray Server/DC

1. Enter Jira Data Centre URL. This is the base URL of your self-hosted Jira instance, for example, https://jira.yourcompany.com.
2. Enter your Personal Access Token. To create one, see Using personal access tokens in the Atlassian documentation.
3. Click Test Connection to verify the details.
4. Click Proceed to save and establish the connection.

Select what to import

1. Optional: Select Retain Test Case IDs from Xray Server/DC while importing to Test Management. Retaining IDs can cause import failures if duplicate test case IDs exist. If you opt out, Test Management generates new IDs for all test cases and keeps the original IDs in a separate field.
2. Select the projects that you want to import.
3. Optional: If your plan includes AI Deduplication, turn on Scan for Duplicates next to a project. The Deduplication Agent scans the project for duplicate test cases after the import. Learn how to review and resolve duplicate test cases.
4. Click Begin Import.

Track import progress

The All Projects page shows the progress of a running import. Click View Details to open the detailed Quick Import view.

If required, you can cancel the import from the detailed view.

After the import completes, click View Report to review what was imported.

An email notification is also sent to your registered email ID when the import completes.

Review Import Logs

The Import Logs tab on the Quick Import screen lists your current and past imports. Each entry shows:

• The import status, updated in real time as the import progresses.
• The number of imported test cases and projects.
• The team member who started the import and the start time.

Use the action menu, the three dots next to an import, to open View Report or Retry Import. View Report shows detailed results and error messages. Retry Import reruns a failed import.

Next steps

• Import from Xray Cloud if you also run Xray on Jira Cloud.
• Compare the Xray types to check what each one imports.
• Review and resolve duplicate test cases flagged by the Deduplication Agent.
• Troubleshoot Quick Import errors if your connection or import fails.