Versions Compared

Old Version 4

changes.mady.by.user Liliia Ostrovska

Saved on

compared with

New Version Current

changes.mady.by.user Liliia Ostrovska

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel6
outlinefalse
styledisc
typelist
printablefalse

Xray Test Management Overview

Xray app allows users to manage all tests as Jira issues, monitor test coverage, and analyze test statuses. When building Jira reporting in BI software such as Looker Studio, it is important to have this data to bring consistency to business analytics.

Looker Studio Connector for Jira allows exporting Xray app data easily from Jira to Looker Studio.

Info

Xray Test Management Fields can be found in a separate tab.

Xray.gif

How to Add Xray Client ID

Xray Client ID is required to export Xray data.

  1. Being signed in to your Jira Cloud instance, select Apps, and then select Manage your apps.

  1. Scroll down, and then select API Keys.

  1. Select Create API Key.

The Create API Key pop-up window will appear.

  1. Enter your name or name of desired user.

  1. Select Generate.

Tip

The API Key was successfully generated pop-up window will appear.

  1. Copy Client Id and Client Secret, and the select Close.

  1. Select Apps, and then select Looker Studio Connector for Jira.

  1. Select Tokens API Integrations, and then select Xray.

Image Removedapi-integrations-xray.gifImage Added

  1. In the Client Id* and Client Secret* fields, paste your client ID and client secret, and then select Validate & Save.

Image Removedxray-validate-and-save.gifImage Added

Tip

Starting now, all users with granted permission to work with the data sources can select Xray tables and fields for export.

Xray Tables Filtering

Looker Studio Connector for Jira Cloud offers

Status
colourBlue
titleGLOBAL
and
Status
titleLOCAL
filters:

  • Status
    colourBlue
    titleMODIFIED FROM

  • Status
    titleTEST TYPE

  • Status
    titleTESTS

  • Status
    titleTEST EXECUTIONS

  • Status
    titleTEST RUN ASSIGNEES

Global and local filters.gif

If you apply the

Status
colourBlue
titleMODIFIED FROM
filter, it will be applied to all Xray tables. If the filter is not needed for a specific table, you can deselect it individually for each table.

Modified from.gif

There are also JQL and Basic filters available to apply. Unlike the

Status
colourBlue
titleMODIFIED FROM
filter, JQL and Basic filters are applied to the Jira issue itself. The
Status
colourBlue
titleMODIFIED FROM
filter is applied to Xray fields.

Info

The JQL and Basic filters are only applied to the following tables:

  • Tests

  • Test Steps

  • Preconditions

  • Test Preconditions 🔗

  • Test Set Tests 🔗

  • Test Plan Tests 🔗

  • Test Plan Executions 🔗

  • Test Plan Folders

  • Test Execution Tests

  • Test Execution Environment

  • Test Step Attachment

Filter Options.gif

As per linking tables, JQL or Basic filter is applied to the main table only. All linking tables are marked with the link icon 🔗.

Info

For example, the Test Preconditions 🔗 table links the Test issue types (Xray tests) and the Precondition issue types. In this case, only the Test issue types will be filtered by JQL or Basic filter. This means you’ll get all the Test issue types that match the specified filter along with their preconditions.

The

Status
titleTEST TYPE
filter allows selecting the specific type of tests for export: Manual, Generic, or Cucumber. You can select only one type at once.

Test Type.gif

The

Status
titleTEST
filter allows selecting the specific test(s) for export.

The

Status
titleTEST EXECUTIONS
filter allows selecting the specific test execution(s) for export.

The

Status
titleTEST RUN ASSIGNEE
filter allows selecting the certain test run(s) for export performed by a specific user (assignee).

Local filters.gif

If you need to export test runs for specific tests, simply select them using the Tests filter.

Tests.gif

If the specific tests you need to export are already grouped within a single test execution, just select that test execution using the Test Executions filter. You can select a few test executions.

Info

When selecting a specific test execution in the Test Executions filter, and then selecting tests in the Tests filter that don't belong to the specified test execution, the exported table will be blank as a result.

Test Executions.gif

If you need to export test runs assigned to a specific user, select their name in the Test Run Assignees filter. You can select a few assignees.

Info

When selecting a specific assignee’s name in the Test Run Assignees filter, and then selecting tests in the Tests filter, the exported table will be blank as a result (the same logic is applied for selecting test executions).

Test Run Assignees.gif