Breadcrumbs

siblingIssues()

This function returns an issue list containing all issues which are directly under a given issue's parent according to Advanced Roadmaps hierarchy excluding the given issue itself. In the case that the given issue is a sub-task an issue list with its sibling sub-tasks is returned, even outside of the advanced roadmap hierachy.

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
siblingIssues() #Output: Issue list


Examples

Parser expression

Description
Bash
siblingIssues()

Considering that current issue is JWT-6, this expression returns the sibling issues of this issue:

[JWT-4, JWT-12]

Bash
siblingIssues()

Considering that current issue is JWT-7, this expression returns the sibling issues of this issue:

[JWT-10]

Output

This function returns an issue list


Variant where you additionally define issues.

Duplicated issues are filtered from the output.


Bash
siblingIssues(issueList) #Output: Issue list


Examples

Parser expression

Description
Bash
siblingIssues(linkedIssues("is blocked by"))


Considering that expression linkedIssues("is blocked by") returns [JWT-2, JWT-9], this example returns the sibling issues of these issues:

[JWT-11, JWT-16]

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
siblingIssues(issueKeys) #Output: Issue list


Examples

Parser expression

Description
Bash
 siblingIssues("JWT-3, JWT-7")

This example returns the sibling issues of JWT-3 and JWT-7:
[JWT-4, JWT-12, JWT-8]

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

Use case
No content found.