This function returns a list of issues that are directly or transitively linked to the current issue.

Transitively linked issues are issues which are indirectly linked to the current issue (e.g. which are linked to an issue which itself is linked to the current issue).

Syntax
transitivelyLinkedIssues(linkTypes) #Output: Issue list
Examples
Parser expressionDescription
transitivelyLinkedIssues("relates to")

This example returns an issue list with all issues that are directly or transitively linked to the current issue using the link type "relates to".


Consider the following example:

ISSUE-1 [relates to] ISSUE-2

ISSUE-2 [relates to] ISSUE-3

In this case ISSUE-3 is transitively linked to ISSUE-1.

The example would return [ISSUE-2, ISSUE-3].

transitivelyLinkedIssues("")
This example returns an issue list with all issues that are directly or transitively linked to the current issue using any link type.
Additional information

Parameters used in this function

ParameterInput (data type)Description
linkTypes

TEXT

A comma separated list with link types. 

When passing an empty text ("") all link types will be used to search for directly or transitively linked issues.

Output

This function returns an ISSUE LIST.

If there are no directly or transitively linked issues, the function returns NULL.


Variant where you additionally can define an issue list.

Syntax
transitivelyLinkedIssues(linkTypes, issueList) #Output: Issue list
Examples
Parser expressionDescription
transitivelyLinkedIssues("relates to", epic())

This example returns an issue list with all issues that are directly or transitively linked to the current issue's epic using the link type "relates to".

transitivelyLinkedIssues("", subtasks())
This example returns an issue list with all issues that are directly or transitively linked to the current issue's sub-tasks using any link type.
Additional information

Parameters used in this function

ParameterInput (data type)Description
linkTypes

TEXT

A comma separated list with link types. 

When passing an empty text ("") all link types will be used to search for directly or transitively linked issues.

issueList

ISSUE LIST

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or subtasks()).
Output

This function returns an ISSUE LIST


Variant where you define issue keys instead of an issue list.

Syntax
transitivelyLinkedIssues(linkTypes, issueKeys) #Output: Issue list
Examples
Parser expressionDescription
transitivelyLinkedIssues("", %{parent.key})

This example returns an issue list with all issues that are directly or transitively linked to the current issue's parent using any link type.

Additional information

Parameters used in this function

ParameterInput (data type)Description
linkTypes

TEXT

A comma separated list with link types. 

When passing an empty text ("") all link types will be used to search for directly or transitively linked issues.

issueKeys

TEXT

A comma separated list with issue keys.
Output

This function returns an ISSUE LIST


Use cases and examples