Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
UI Text Box
sizemedium
typeinfo

This JQL function can be used to search for issues that have a certain link to issues that satisfy the JQL subquery.

Code Block
languagebash
titleSyntax
linenumberstrue
linkedIssuesOf(subquery) #Output: Issue list
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
issue in linkedIssuesOf('issuetype = Task and priority = "Blocker"')
This example returns all issues that are linked to a Task with priority set to Blocker.
Code Block
linenumberstrue
issue in linkedIssuesOf('project = "Example Project" and assignee = j.carrey')
This example returns all issues that are linked to an issue that belongs to the Example Project's project and whose assignee is j.carrey.
UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
subquery

Status
subtletrue
titletext

A JQL query to select the issues that are linked to the returned issues.

UI Text Box
typetip

Pro tip: Write the JQL query in single quotes instead of double quotes. Otherwise everytime a double-quotation is used in the subquery, they must be jumped with a slash, just like in the previous example.

UI Expand
titleOutput

This function returns a an

Status
subtletrue
titleissue list


UI Text Box
sizemedium
typeinfo

Variant where you can additionally specify only certain link types you want to allow.

Code Block
languagebash
titleSyntax
linenumberstrue
linkedIssuesOf(subquery, linkTypes) #Output: Issue list
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
issue in linkedIssuesOf('issuetype = Task and priority = "Blocker"', "is blocked by, causes")
This example returns all issues whose link type is either is blocked by or causes, and they are linked to a Task with priority set to Blocker.
Code Block
linenumberstrue
issue in linkedIssuesOf('project = "Example Project" and assignee = j.carrey', "relates to")
This example returns all issues whose link type is relates to, and they are linked to an issue that belongs to the Example Project's project and whose assignee is j.carrey.
UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
subquery

Status
subtletrue
titletext

A JQL query to select the issues that are linked to the returned issues.

UI Text Box
typetip

Pro tip: Write the JQL query in single quotes instead of double quotes. Otherwise everytime a double-quotation is used in the subquery, they must be jumped with a slash, just like in the previous example.

linkTypes

Status
subtletrue
titletext

The link type or link types that the returned issues should have. The list of link types should be a comma-separated list.
UI Expand
titleOutput

This function returns a an

Status
subtletrue
titleissue list


UI Text Box
sizemedium
typeinfo

Variant where you can additionally specify a minimum of issues that need to be linked, fulfilling the given link types.

Code Block
languagebash
titleSyntax
linenumberstrue
linkedIssuesOf(subquery, linkTypes, minimumLinked) #Output: Issue list
UI Expand
titleExamples
UI Text Box
typetip

Imagine the following example:

The computation of that JQL would be as follows:

  1. Grab all issues that fulfill the JQL "project = WEB" and take their linked issues → SOF-1, SOF-2, SOF-3, SOF-4, SOF-5
  2. Only grab the issues linked with link type "blocks" → SOF-1, SOF-2, SOF-3
  3. Only grab those issues where at least 2 issues are linked to the same issue → SOF-1, SOF-2

So the final result of that JQL would be SOF-1 and SOF-2.


Parser expressionDescription
Code Block
languagebash
linenumberstrue
issue in linkedIssuesOf('issuetype = Task and priority = "Blocker"', "is blocked by, causes", 2)
This example returns all issues whose link type is either is blocked by or causes, and that are linked to a Task with priority set to Blocker. In addition only those issues will be returned where more than 2 issues are linked to the same issue will be returned.
UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
subquery

Status
subtletrue
titletext

A JQL query to select the issues that are linked to the returned issues.

UI Text Box
typetip

Pro tip: Write the JQL query in single quotes instead of double quotes. Otherwise everytime a double-quotation is used in the subquery, they must be jumped with a slash, just like in the previous example.

linkTypes

Status
subtletrue
titletext

The link type or link types that the returned issues should have. The list of link types should be a comma-separated list.
minimumLinked

Status
subtletrue
titleNumber

A positive natural number larger than 0.
UI Expand
titleOutput

This function returns a an

Status
subtletrue
titleissue list


Include Page
DECADIS:_snip_limit_JQL_functions
DECADIS:_snip_limit_JQL_functions

Page properties
hiddentrue
Short descriptionSearches for linked issues with a given subquery.
Output

Status
subtletrue
titleISSUE LIST

Label
Page properties
hiddentrue

Status
Tech review

Status
colourYellow
titleReady for review

Style guide

Status
colourYellowGreen
titleReady for reviewdone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged