linkedIssuesOf()

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

Syntax

linkedIssuesOf(subquery) #Output: Issue list

Examples

Parser expression	Description
issue in linkedIssuesOf('project = "Asset Management" and type = "Employee"')	This example returns all issues linked to the Employees tracked in the Asset Management project.
issue in linkedIssuesOf('issuetype = Task and priority = "Blocker"')	This example returns all issues that are linked to a Task with priority set to Blocker.

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`subquery`	TEXT	A JQL query to select the issues that are linked to the returned issues. 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.

Output

This function returns an ISSUE LIST

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

Syntax

linkedIssuesOf(subquery, linkTypes) #Output: Issue list

Examples

Parser expression

Description

issue in linkedIssuesOf('project = "Asset Management" and type = "Employee"',"has asset")

This example returns all assets linked to the Employees via the "has asset" relationship tracked in the Asset Management project.

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

This example returns all issues linked to a Blocker task either by the "is blocked by" or "causes" link type.

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`subquery`	TEXT	A JQL query to select the issues that are linked to the returned issues. 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`	TEXT	The link type or link types that the returned issues should have. The list of link types should be a comma-separated list.

Output

This function returns an ISSUE LIST

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

Syntax

linkedIssuesOf(subquery, linkTypes, minimumLinked) #Output: Issue list

Examples

Parser expression	Description
issue in linkedIssuesOf('project = "Asset Management" and type = "Employee"',"has asset",1)	This example returns all assets linked to Employees tracked in the Asset Management project via the "has asset" relationship, where the Employee has at least two assets linked to.
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.

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`subquery`	TEXT	A JQL query to select the issues that are linked to the returned issues. 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`	TEXT	The link type or link types that the returned issues should have. The list of link types should be a comma-separated list.
`minimumLinked`	NUMBER	A natural number larger than 0.

Output

This function returns an ISSUE LIST

The result is not what you expected? The number of returned issues feels too low?

By default, the maximum number of issues that will be returned by the JQL subquery, and thus can be processed by the logical expression is 1000.

To ensure the performance of your entire Jira instance, we limit the execution of the JQL function in terms of issue count and execution time. Please refer to your admin if you need to change the configuration.

Content

Space Tools