This article describes possible use cases of JQL Search Extensions and Xray.

External use

Xray integrates well with the Jira UI. What’s missing in Xray cloud is a good support for JQL and issue sourcing.

...

• dashboard gadgets

• boards

• Jira search - simply use this syntax filter="Your filter name"

• 3rd party apps that accept filters and JQL

Examples of use cases

Source requirements associated with tests

Standard JQL makes it possible to get requirements for one Test issue:

...

issue in linkedIssuesOfQuery("project='ACME tests' and labels=Q3", "tests")

Source tests associated with requirements

Standard JQL makes it possible to get tests for one Requirement issue:

...

issue in linkedIssuesOfQuery("project='ACME requirements' and labels=Q3", "is tested by")

Source tests associated with requirements of the input fix versions of the specified project

This can be achieved with the following nested query:

issue in linkedIssuesOfQuery("project='ACME requirements and fixVersion in ('v1.0', 'v1.1')", "is tested by")

Source defects created during the execution of the specified Test

With standard JQL you can get defects created by a sigle test:

...

issue in linkedIssuesOfQuery("project='ACME tests' and labels=Q3", "created")

Source list of defects created during the execution of Test Execution

To get all the defects:

issue in linkedIssuesOfQuery("project='ACME tests' and type='Test Execution'", "created")

...

issue in linkedIssuesOfQuery("project='ACME tests' and type='Test Execution'", "created") and assignee="John Doe"

Source defects created during the execution of Tests covering the specified requirement

First create a filter Tests for requirements that matches all the tests of your requirements:

...