epic()

Current issue

This function returns the issue list of epics that are linked to a given set of issues. 

If the specified issue is a sub-task, then the epic of its parent issue is returned. If specified issue is an epic itself, then current issue is returned.

Bash
epic() #Output: Issue list

Examples

Parser expression

Description

Bash
%{epic()}

This example returns an issue list containing the current/ parent issue's epic.

Output

This function returns an issue list .

If the current issue or its parent does not have an epic, the function returns an empty issue list .


Issue list

Variant where you can specify an issue list from which the epics should retrieved from. The output may contain duplicates.

Bash
epic(issueList) #Output: Issue list

Parser expression

Description

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

This example returns the issue list of all epics of those issues which are blocking the current issue.

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 subtasks()).

Output

This function returns an issue list


Issue keys

Variant where you define issue keys instead of an issue list.

Multiple issue keys are provided as a comma-separated list of issue keys. Duplicated issue keys are discarded. Output can contain duplicated issues.

Bash
epic(issueKeys) #Output: Issue list

Examples

Parser expression

Description

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

This example returns the issue list of all epics linked to issues with keys CRM-15 and HD-21.

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

issueKeys

text

Text containing valid issue keys in a comma-separated list.

Output

This function returns an issue list


(books) Use cases and examples