linkedIssues()

This function returns the list of issues linked to the specified issue(s).

Bash
linkedIssues() #Output: Issue list

Examples

Parser expression

Description

Bash
%{linkedIssues()}

This example returns an issue list containing all issues linked to the current issue, e.g:

IT-3412, IT-2412

Output

This function returns an issue list

An issue appears in the output as many times as it is linked to the current issue.


Variant where you additionally can define issue link types.

Bash
linkedIssues(linkTypes) #Output: Issue list

Examples

Parser expression

Description

Bash
%{linkedIssues("blocks, clones")}

This example returns an issue list of all the issues linked with the current issue using issue link types blocks or clones.

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

linkTypes

text

Comma-separated list of issue link type names, or an empty text ("") for representing all issue link types, i.e., linkedIssues("") is equivalent to linkedIssues().

Output

This function returns an issue list


Variant where you additionally define issues.

Bash
linkedIssues(linkTypes, issues) #Output: Issue list

Examples

Parser expression

Description

Bash
%{linkedIssues("", subtasks())}

This example returns an issue list of all issues linked to the current issue's sub-tasks using any issue link type.

To achieve this, the following functions are used:

Bash
%{linkedIssues("clones, duplicates", subtasks())}

This example returns an issue list of all issues linked to the current issue's sub-tasks using the link type "clones" or "duplicates".

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

linkTypes

text

Comma-separated list of issue link type names, or an empty text ("") for representing all issue link types, i.e., linkedIssues("") is equivalent to linkedIssues() .

issues

issue list

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

Duplicated issues are ignored.

Output

This function returns an issue list


Variant where you define issue keys instead of issues.

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

Examples

Parser expression

Description

Bash
%{linkedIssues("", %{parent.key})}

This example returns an issue list of all issues linked to the current issue's parent using any issue link type.


Additional information

Parameters used in this function

Parameter

Input (data type)

Description

linkTypes

text

Comma-separated list of issue link type names, or an empty text ("") for representing all issue link types, i.e., linkedIssues("") is equivalent to linkedIssues() .

issueKeys

text

Comma-separated list of issue keys. Duplicated issue keys are discarded. Optionally you can use Field codes returning issue keys.


Output

This function returns an issue list


(books) Use cases and examples

Short description

Returns a list of issues linked.

Output

issue list