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 returns issues that have a certain link to issues that satisfy the are linked to issues satisfying a JQL subquery.

Code Block
languagebash
titleSyntax
linenumberstrue
linkedIssuesOf(subquery) #Output: Issue list
UI Expand
titleExamples
Parser expressionDescription
Code Block
linenumberstrue
issue in linkedIssuesOf('project = "Asset Management" and type = "Employee"')
This example returns all issues linked to the Employees tracked  tracked in the Asset Management project.
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.
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 those issues you want to the be returned issues.

UI Text Box
typetip

Pro tip

Enclose the subquery with : Write the JQL query in single quotes '' instead of double quotes"". Otherwise everytime every time 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 an

Status
subtletrue
titleissue list


UI Text Box
sizemedium
typeinfo

Variant where you can additionally specify only certain limit the results by specifying 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
linenumberstrue
issue in linkedIssuesOf('project = "Asset Management" and type = "Employee"',"has asset")

This example returns all

assets

issue linked to the Employees tracked in the Asset Management project via the "has asset"

relationship tracked in the Asset Management project.

link type. 

Code Block
languagebash
linenumberstrue
issue in linkedIssuesOf('issuetype = Task and priority = "Blocker"', "is blocked by, causes")

This example returns all issues linked issues that are linked to a Task with priority set to Blocker task either by the "is blocked by" or "causes" link type .



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 issuesthe those issues you want to be returned.

UI Text Box
typetip

Pro tip

Enclose the subquery with : Write the JQL query in single quotes '' instead of double quotes"". Otherwise everytime every time 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 havemust have been used to link to the desired target issues. The list of link types should be a comma-separated list.
UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list


UI Text Box
sizemedium
typeinfo

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

Code Block
languagebash
titleSyntax
linenumberstrue
linkedIssuesOf(subquery, linkTypes, minimumLinked) #Output: Issue list
UI Expand
titleExamples
Parser expressionDescription
Code Block
linenumberstrue
issue in linkedIssuesOf('project = "Asset Management" and type = "Employee"',"has asset",12)

This example returns all

assets

issue linked to the Employees

tracked

 tracked in the Asset Management

project

 project via the "has asset"

relationship, where the Employee has

link type.

In order to be returned by the query each Employee must have at least two

assets

of those linked

to

issues.

Code Block
linenumberstrue
issue in linkedIssuesOf('project = "Asset Management" and type = "PC"',"belongs to",2) AND type = "Employee"
This example returns all Employees that have a PC associated within the Asset Management project, that is also associated with another person.
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 those issues you want to the be returned issues.

UI Text Box
typetip

Pro tip

Enclose the subquery with : Write the JQL query in single quotes '' instead of double quotes"". Otherwise everytime every time 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 havemust have been used to link to the desired target issues. The list of link types should be a comma-separated list.
minimumLinked

Status
subtletrue
titleNumber

A natural number larger than 0.
UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list


Include Page
DECADIS:_snip_limit_JQL_functions
DECADIS:_snip_limit_JQL_functions

Page properties
hiddentrue
Short descriptionSearches for Returns issues linked to other issues with specified by a given subquery.
Output

Status
subtletrue
titleISSUE LIST

Label

Status
subtletrue
colourRed
titlestaff pick

Page properties
hiddentrue

Status
Tech review

Status
colourYellow
titleReady for review

Style guide

Status
colourGreen
titledone

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