issuesUnderEpic()

Issues under epic

This function returns an issue list containing issues which are linked to the same epic as the current issue

The current issue will be included in the output, except if it is an epic itself. 

Only standard issues (no sub-tasks) will be returned and duplicates are being removed.

Bash
issuesUnderEpic() #Output: Issue list

Examples

Parser expression

Description

Bash
%{issuesUnderEpic()}

This example returns an issue list with all issues linked to the same epic as the current issue, e.g.

[JWT-2, JWT-3, JWT-4]

Output

This function returns an ISSUE list


Issues under epic issue list

Variant where you additionally define an issue list.

Duplicated issues are filtered from the output.

Bash
issuesUnderEpic(issueList) #Output: Issue list

Examples

Parser expression

Description

Bash
%{issuesUnderEpic(linkedIssues("is blocked by"))}

This example returns an issue list of all issues linked to the same Epics as the issues blocking the current issue, e.g.

[JWT-2, JWT-3, JWT-4]

To achieve this the following function is used:

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

issueList

ISSUElist

Any given issue list.

Output

This function returns an ISSUE list


Issues under epic issue key

Variant where you define issue keys instead.

Bash
issuesUnderEpic(issueKeys) #Output: Issue list

Examples

Parser expression

Description

Bash
%{issuesUnderEpic("CRM-15, HD-21")}

This example returns an issue list of issues linked to the same epics as CRN-15 and HD-21, e.g.

[CRM-22, CRM-23, HD-24, HD-26, HD-27]

Bash
%{issuesUnderEpic(%{issue.cf10112})}

This example returns an issue list of issues linked to the same epics as those that are stored in the custom field, e.g.

[JWT-2, JWT-3, JWT-4, HD-24, HD-26, HD-27]

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

issueKeys

TEXT

A text containing issue keys sepparated by commas.

Output

This function returns an issue list

If you want to remove the given issues from the output have a look at siblingIssuesUnderEpic() instead.


(books) Use cases and examples