Versions Compared

Key

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


UI Text Box
sizemedium
typeinfo

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


Code Block
languagebash
titleSyntax
linenumberstrue
transitivelyLinkedIssues(linkTypes) #Output: Issue list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
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".


UI Text Box
typeinfo

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



Code Block
languagebash
linenumberstrue
transitivelyLinkedIssues("")


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



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
linkTypes

Status
subtletrue
titletext

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.



UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list
.

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

Status
subtletrue
titlenull
.




UI Text Box
sizemedium
typeinfo

Variant where you additionally can define an issue list.


Code Block
languagebash
titleSyntax
linenumberstrue
transitivelyLinkedIssues(linkTypes, issueList) #Output: Issue list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
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".


Code Block
languagebash
linenumberstrue
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.



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
linkTypes

Status
subtletrue
titletext

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

Status
subtletrue
titleissue list

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



.

UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list
.If there are no directly or transitively linked issues, the function returns 
Status
subtletrue
titlenull




UI Text Box
sizemedium
typeinfo

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


Code Block
languagebash
titleSyntax
linenumberstrue
transitivelyLinkedIssues(linkTypes, issueKeys) #Output: Issue list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
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.



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
linkTypes

Status
subtletrue
titletext

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

Status
subtletrue
titletext

A comma separated list with issue keys.



UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list
.If there are no directly or transitively linked issues, the function returns status
subtletrue
titlenull
.



Page properties
hiddentrue



Status
Tech review

Status
colourYellowGreen
titleReady for reviewdone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged



Page properties
hiddentrue


Short description

Returns issues that are directly or transitively linked to the current issue.

Output

Status
subtletrue
titleissue list

Available since

Status
subtletrue
colourBlue
title2.1.22

Label