Page History

Versions Compared

Old Version 23

changes.mady.by.user Christian Czaia

Saved on Sept 22, 2021

compared with

New Version Current

changes.mady.by.user Iheb Kharab

Saved on Dec 06, 2021

Key

This line was added.
This line was removed.
Formatting was changed.

UI Text Box

size	medium
type	info

This JQL function returns issues that are linked to issues satisfying a JQL subquery.any issue that is returned by a JQL subquery.

Additionally you can further refine your query by specifying distinct link types and even a minimum number of linked issues.

Code Block

language	bash
title	Syntax
linenumbers	true

linkedIssuesOflinkedTo(subquery) #Output: Issue list

UI Expand

title	Examples

Parser expression

Description

Code Block

linenumbers	true

issue in linkedIssuesOflinkedTo('project = "Asset Management" and type = "Employee"')

This example returns all issues linked to the Employees tracked in the Asset Management project.

Code Block

language	bash
linenumbers	true

issue in linkedIssuesOflinkedTo('issuetype = Task and priority = "Blocker"')

This example returns all issues that are linked to a Task with priority set to Blocker.

UI Expand

title	Additional information

Parameters used in this function

Pro tip

Enclose

Parameter Input (data type) Description

subquery

Status

subtle	true
title	text

A JQL query to select the issues that are linked to the those issues you want to be returned.

UI Text Box

type	tip

Include Page

	DECADIS:_snip_proTip_JQL
	DECADIS:_snip_proTip_JQL

the subquery with single quotes '' instead of double quotes"". Otherwise every time a double-quotation is used in the subquery, they must be jumped with a slash /.

UI Expand

title	Output

This function returns an

Status


subtle	true
title	issue list

UI Text Box

size	medium
type	info

Variant where you can additionally limit the results by specifying certain link types.

Code Block

language	bash
title	Syntax
linenumbers	true

linkedIssuesOflinkedTo(subquery, linkTypes) #Output: Issue list

UI Expand

title	Examples

Parser expression

Description

Code Block

linenumbers	true

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

This example returns all issue linked to the Employees tracked in the Asset Management project via the "has asset" link type.

Code Block

language	bash
linenumbers	true

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

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

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

subquery

Status

subtle	true
title	text

A JQL query to select the issues that are linked to the those issues you want to be returned.

UI Text Box

type	tip

Pro tip

Enclose the subquery with single quotes '' instead of double quotes"". Otherwise every time a double-quotation is used in the subquery, they must be jumped with a slash /.

Include Page

	DECADIS:_snip_proTip_JQL
	DECADIS:_snip_proTip_JQL

linkTypes

Status

subtle	true
title	text

The link type or link types that must have been used to link to the desired target issues. The list of link types should be a comma-separated list.

UI Expand

title	Output

This function returns an

Status


subtle	true
title	issue list

UI Text Box

size	medium
type	info

Variant where you can additionally specify a minimum number of linked issues.

Code Block

language	bash
title	Syntax
linenumbers	true

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

UI Expand

title	Examples

Parser expression

Description

Code Block

linenumbers	true

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

This example returns all issue linked to the Employees tracked in the Asset Management project via the "has asset" link type.

In order to be returned by the query each Employee must have at least two of those linked issues.

Code Block

linenumbers	true

issue in linkedIssuesOflinkedTo('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

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

subquery

Status

subtle	true
title	text

A JQL query to select the issues that are linked to the those issues you want to be returned.

UI Text Box

type	tip

Pro tip

Enclose the subquery with single quotes '' instead of double quotes"". Otherwise every time a double-quotation is used in the subquery, they must be jumped with a slash /.

Include Page

	DECADIS:_snip_proTip_JQL
	DECADIS:_snip_proTip_JQL

linkTypes

Status

subtle	true
title	text

The link type or link types that must have been used to link to the desired target issues. The list of link types should be a comma-separated list.

minimumLinked

Status


subtle	true
title	Number

A natural number larger than 0.

UI Expand

title	Output

This function returns an

Status


subtle	true
title	issue list

Include Page

	DECADIS:_snip_limit_JQL_functions
	DECADIS:_snip_limit_JQL_functions

Image AddedUse cases and examples

Page properties report

firstcolumn	Use case
headings	JQL function
cql	label = "jql_func_linkedto" and space = currentSpace()

Page properties

hidden	true

Short description

Returns issues linked to other issues specified by satisfying a JQL subquery.

Output

Status


subtle	true
title	ISSUE LIST

Label

Status

colour	Red
title	staff pick

Page properties

hidden	true

Status

Tech review

Status

colour	Yellow
title	Ready for review

Style guide

Status

colour	Green
title	done

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

Status

colour	Red
title	flagged

Content

Space Tools

Versions Compared

Old Version 23

New Version Current

Key

Image AddedUse cases and examples