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 sub-task, its parent issue will be returned.

Advanced Roadmaps hierarchy includes:

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

Example:

Image RemovedImage Added


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

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



UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list




UI Text Box
sizemedium
typeinfo

Variant where you define issue keys instead.

Duplicated issues are filtered from the output.


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

To return the issues just under an issue within the Advanced Roadmaps hierarchy, you might want to have a look into the issuesUnder() function.

To return all issues under an issue within the Advanced Roadmaps hierarchy, you might want to have a look into the allIssuesUnder() function.

To return all issues having the same parent within the Advanced Roadmaps hierarchy, you might want to have a look into the siblingIssues() function.

To return the parent of an issue within the Advanced Roadmaps hierarchy, you might want to have a look into the parent()  function.

To return all issues above an issue within the Advanced Roadmaps hierarchy, you might want to have a look into the issuesAbove() function.



Image AddedUse cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Field type, Automated action, Parser functions
cqllabel = "parser_func_parent" and space = currentSpace()


Page properties
hiddentrue
id1


Parser function cloud
Map(question)
Notes

Workaround

Code Block
languagebash
issue.customfield_10018

Where 10018 is the Parent link's custom field ID in the corresponding instance.




Page properties
hiddentrue



Status
Tech review

Status
colourYellow
titletodoReady for review

Style guide

Status
colourGreen
titletododone

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 the direct parent(s) of the given issue(s) according to Advanced Roadmaps hierarchy.

Output

Status
subtletrue
titleissue list

Available since

Status
subtletrue
colourBlue
title3.1.0

Label

Status
colourRed
titlestaff pick