parent()

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:

advanced-roadmaps-hierarchy-levels.png


Bash
parent() #Output: Issue list


Examples

Parser expression

Description

Bash
parent()

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

[JWT-1]

Output

This function returns an issue list


Variant where you additionally define issues.

Duplicated issues are filtered from the output.


Bash
parent(issueList) #Output: Issue list


Examples

Parser expression

Description

Bash
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-2]

To achieve this the following functions are used:

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

issueList

issue list

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

linkedIssues()

or 

issuesUnderEpic()

).

Output

This function returns an issue list


Variant where you define issue keys instead.

Duplicated issues are filtered from the output.


Bash
parent(issueKeys) #Output: Issue list


Examples

Parser expression

Description

Bash
 parent("JWT-7, JWT-13")

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

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

issueKeys

text

A comma separated list of issue keys.

Output

This function returns an issue list

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.


📚 Use cases and examples