Introduction
This article provides a guide to troubleshooting common issues and optimizing your testing workflow when importing tests using the Xray API or UI on both Jira Data Center and Jira Cloud.
Common Issues & Potential Solutions:
Software Version
Confirm whether you are using Xray Cloud or Xray Data Center and adapt to our documentation accordingly.
Do you want to confirm your Xray Version? → [Xray] How can I find my Xray version?
- Looking for Xray Data Center article? → [Xray DataCenter] I'm unable to import Tests
Authentication Issues
Ensure you have the correct authentication credentials for the Xray API. This typically involves a client_id and client_secret.
- How-to → [Xray Cloud] How to get API Keys & [Xray Cloud] Can't generate API Keys (no user found)
- Documentation → Authentication - REST v2PUBLISHED
Readme
The method you choose to import your test results will determine the aspects you need to address.
Importing using API
API Version Issues:
If you are encountering issues with the v1 API, consider switching to the v2 API.- Cloud v1 → REST API v1
- Cloud v2 → REST API v2
Incorrect API Endpoint:
Make sure you’re using the correct API endpoint for importing test results. For Xray Cloud, the endpoint is different from the one used for Xray Data Center.- Cloud v1 → Importing Tests - REST
- Cloud v2 → Importing Tests - REST v2PUB
Data Format Issues:
Ensure your test results are in the correct format. For example, when importing JUnit results, make sure your tests are generating JUnit reports in the correct format.- Verify JUnit Structure → Taking advantage of JUnit XML reports
Importing using UI
Data Format Issues:
Ensure your test results are in the correct format. For example, when importing JUnit results, make sure your tests are generating JUnit reports in the correct format.- Verify JUnit Structure → Taking advantage of JUnit XML reports
Note:
Other Common Issues:
Error Messages: Understand common error messages and their solutions.
For example, a 404 error might indicate that you’re trying to import results to the wrong server.
A “No Project” error might indicate an issue with the project key in your import file.
Software Version Issues: If you’re encountering issues after an Xray or Jira update, it could be a software bug. Check the Xray support portal for known issues and updates.