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.

You can save JQL as a filter and use it in:

• 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 linkedIssues(TST-123,"tests")

To get a list of requirements that match a JQL:

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 linkedIssues(REQ-123,"is tested by")

To get a list of tests that match a JQL:

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 linkedIssues(TST-123,"created")

To get a list of defects that match a JQL:

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")

You can filter the defects by assignee:

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:

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

Create another filter that matches the defects created during the tests:

issue in linkedIssuesOfQuery("filter='Tests for requirements'", "created")