Xray Integration

Connect Jira Xray test management tool to the Oobeya Test Analytics module.

Overview

Xray integration allows Oobeya to:

• Analyze manual test results from Xray projects.

• Track UAT success and escaped defects across projects.

• Measure team-level testing efficiency and defect resolution performance.

• Display metrics and trends in Team Health > Scorecards and organization dashboards.

---

Prerequisites

Before starting the integration:

• You must have an active Jira instance with the Xray plugin installed.

• Your user account must have permission to access Xray APIs.

• An API Token or Basic Auth credentials are required.

---

Authentication Methods

Oobeya supports both authentication types depending on your Jira environment:

Environment	Authentication Type
Xray Cloud	API Token or Basic Auth
Xray Server / DC	API Token or Basic Auth

For Xray Cloud users, you can generate your API token from Atlassian Account → Security → API Tokens.

---

Setting up the Integration

Step 1 — Enable Xray Plugin

Go to Integrations → Test → Xray and make sure the Xray addon is installed.

Step 2 — Add Data Source

1. Navigate to Data Sources.

2. Click Xray addon and click New Data Source.

3. Fill in the connection details:

Field	Description	Example
Data Source Name	A custom name for your connection.	Company Xray Server
Server URL	Base URL of your Jira Xray instance.	Server: https://JIRA_SERVER_URL Cloud: https://yourcompany.atlassian.net
Access Type	Choose Basic or Token.	-
Username / Email	Your Jira username or email address.	[email protected]
Password / Token	Jira password or API token.	●●●●●●●

1. Click Test Connection to validate credentials.

2. Once the connection succeeds, click Add to save.

Xray Data Source Configuration

---

How It Works

Once connected, Oobeya can retrieve and process data from Xray:

• Test Executions – total test runs, status (pass/fail), duration, and owner.

• Test Cases – manual test details and associated UAT mappings.

• Defects – linked or related bugs for each test execution.

This data is normalized and displayed within the Test Analytics module.

---

Troubleshooting

Issue	Possible Cause	Resolution
Connection test fails	Wrong URL or expired token	Recheck credentials and API token validity.
No test data retrieved	Insufficient API permissions	Ensure your Jira user has Xray API access.