linkedIssues() | Decadis App Help Center

This function returns the list of issues linked to the specified issue(s), including Epic-Task links.

Bash

linkedIssues() #Output: Issue list

Examples

Parser expression	Description
Bash `linkedIssues()`	This example returns an issue list with all issue linked to the current issue.
Bash `distinct(linkedIssues() EXCEPT linkedIssues("has Epic, is Epic of"))`	This example returns an issue list of all the issues linked to current issue, excluding Epic issue links. To achieve this, the following functions are used: distinct() EXCEPT

Parser expression

Description

Bash

linkedIssues()

This example returns an issue list with all issue linked to the current issue.

Bash

distinct(linkedIssues() EXCEPT linkedIssues("has Epic, is Epic of"))

This example returns an issue list of all the issues linked to current issue, excluding Epic issue links.

To achieve this, the following functions are used:

Output

This function returns an issue list

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

Function distinct() can be used to remove duplicated issues.

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, issueList) #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: subtasks()
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".

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:

subtasks()

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

issueList

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

📚 Use cases and examples

Use case	JWT feature	Workflow function	Field type	Parser functions
Highest ranked custom field value among all linked issues	(input latin letters)		Text	first() sort() fieldValue() linkedIssues()
Number of unresolved blocking issues			Number	count() filterByResolution() linkedIssues()
Creation date of the linked epic			Date-time	first() fieldValue() linkedIssues()
Ensure that all issues linked with a certain issue link type have "Due Date" field set		Logical validator Logical condition		count() linkedIssues() fieldValue()
Block an Epic's transition depending on linked issues status and due date		Logical validator Logical condition		count() filterByPredicate() linkedIssues()