Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
UI Text Box
sizemedium
typeinfo

This function returns the parent issue of a given issue according to Advanced Roadmaps hierarchy, i.e., the issue which is immediately above in the hierarchy. In the case that the given issue is a subtask, its parent issue will be returned.

Advanced Roadmaps hierarchy includes:

  • Issues linked by Parent Link custom field.
  • Issues linked by Epic-Story link.
  • Subtasks in the lowest level of the hierarchy. Subtasks under issues in intermediate levels of the hierarchy are not considered to belong to Advanced Roadmaps hierarchy.

Example:

Code Block
languagebash
titleSyntax
linenumberstrue
parent() #Output: Issue list
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
parent()

Considering that current issue is JWT-3, this expression returns the parent of this issue:

JWT-1

UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list


UI Text Box
sizemedium
typeinfo

Variant where you additionally define issues.

Duplicated issues are filtered from the output.

Code Block
languagebash
titleSyntax
linenumberstrue
parent(issueList) #Output: Issue list
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
parent(linkedIssues("is blocked by")) 

Considering that expression linkedIssues("is blocked by") returns [JWT-4, JWT-8], this example returns the parent of these issues:

JWT-1, JWT-8

To achieve this the following functions are used:

UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
issueList

Status
subtletrue
titleissue list

Any given issue list. Usually this value is retrieved from a function (e.g. linkedIssues() or 29525908).
UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list


UI Text Box
sizemedium
typeinfo

Variant where you define issue keys instead.

Code Block
languagebash
titleSyntax
linenumberstrue
parent(issueKeys) #Output: Issue list
UI Expand
titleExamples
Parser expressionDescription
Code Block
languagebash
linenumberstrue
 parent("JWT-7, JWT-13")

This example returns parent issues of JWT-7 and JWT-13:
JWT-2, JWT-12

UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
issueKeys

Status
subtletrue
titletext

A comma separated list of issue keys.
UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list

UI Text Box
typetip
UI Text Box
typetip

Function issuesUnder() returns the children issues in level just under an issue.

Function allIssuesUnder() returns all children issues in any level below an issue.

Function siblingIssues() returns issues sharing the same parent as a given issue, excluding the given issue.

Function issuesAbove() returns all the related issues in levels above an issue.

Page properties
hiddentrue

Status
Tech review

Status
colourGreen
titledone

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 located in the level just under a given parent issue according to Advanced Roadmaps hierarchy.

Output

Status
subtletrue
titleissue list

Available since

Status
subtletrue
colourBlue
title3.1.0

Label

Status
colourRed
titlestaff pick