Breadcrumbs

transitivelyLinkedIssues()

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).

Bash
transitivelyLinkedIssues(linkTypes) #Output: Issue list

Examples

Parser expression

Description
Bash
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].
Bash
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

Parameter

Input (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 .

Issue list

Variant where you additionally can define an issue list.

Bash
transitivelyLinkedIssues(linkTypes, issueList) #Output: Issue list

Examples

Parser expression

Description
Bash
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".
Bash
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

Parameter

Input (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

Issue keys

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

Bash
transitivelyLinkedIssues(linkTypes, issueKeys) #Output: Issue list

Examples

Parser expression

Description
Bash
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

Parameter

Input (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

Use case Workflow function Field type Automated action Parser functions