This function returns an issue list containing all the ancestor issues of a given issue according to Advanced Roadmaps hierarchy, i.e., all related issues in levels above a given issue, or in other words: the parent issue, the grandparent issue, the great grandparent issue, etc. The output list is ordered in ascending levels, being the parent issue the first element of the list.

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:


issuesAbove() #Output: Issue list



Parser expressionDescription


issuesAbove()


Considering that current issue is JWT-13, this expression returns:

[JWT-12, JWT-2, JWT-3, JWT-1]



This function returns an




Variant where you additionally define issues.

Duplicated issues are filtered from the output.


issuesAbove(issueList) #Output: Issue list



Parser expressionDescription


issuesAbove(linkedIssues("is blocked by"))


Assuming that expression linkedIssues("is blocked by") returns [JWT-2, JWT-9], this example returns all the issues in the level just under issues JWT-2 and JWT-9:

[JWT-3, JWT-1, JWT-8]

To achieve this the following functions are used:



Parameters used in this function

ParameterInput (data type)Description
issueList

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



This function returns an




Variant where you define issue keys instead.

Duplicated issues are filtered from the output.


issuesAbove(issueKeys) #Output: Issue list



Parser expressionDescription


 issuesAbove("JWT-7, JWT-9")


This example returns all issues in the level just under issues JWT-7 and JWT-9:
[JWT-2, JWT-3, JWT-1, JWT-8]



Parameters used in this function

ParameterInput (data type)Description
issueKeys

A comma separated list of issue keys.



This function returns an


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.



Use cases and examples



Parser function cloud
Map(error)
NotesNot possible to access the Advanced roadmaps' Parent link nor the Advanced roadmaps' children, so it's not possible to replicate any of the AR functions behaviour yet.






Status
Tech review

Style guide




Short description

Returns all issues located in any level above a given parent issue according to Advanced Roadmaps hierarchy.

Output

Available since

Label