issuesUnderEpic()

This function returns an issue list containing issues which are linked to 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.

Syntax

issuesUnderEpic() #Output: Issue list

Parser expression	Description
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

This function returns an ISSUE LIST

Variant where you additionally define issues.

Duplicated issues are filtered from the output.

Syntax

issuesUnderEpic(issueList) #Output: Issue list

Parser expression	Description
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 functions are used: linkedIssues()

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

This function returns an ISSUE LIST

Variant where you define issue keys instead.

Syntax

issuesUnderEpic(issueKeys) #Output: Issue list

Parser expression	Description
issuesUnderEpic("CRM-15, HD-21")	This example returns an issue list of issues linked to the same epics as CRN-15 and HD-21.

Parameters used in this function

Parameter	Input (data type)	Description
`issueKeys`	TEXT	A comma separated list of issue keys.

This function returns an ISSUE LIST

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

Use cases and examples

Use case	Workflow function	Field type	Automated action	Parser functions
Close epic when stories are done			Transition issue action	count() filterByStatus() issuesUnderEpic()
Clone epic, tasks and sub-tasks	Create issue			toString() toStringList() issueKeysToIssueList() replaceFirst() first() fieldValue() textOnStringList() findModify() subtasks() issuesUnderEpic()
Total time logged on an epic		Number		sum() fieldValue() issuesUnderEpic()
Total remaining estimate in an epic (no sub-tasks)		Number		sum() fieldValue() issuesUnderEpic()
Total remaining estimate in an epic (all linked issues)		Number		sum() fieldValue() issuesUnderEpic() subtasks()
Total of all story points in an epic		Number		sum() fieldValue() issuesUnderEpic()
Block an Epic's transition until all the issues under that Epic are resolved	Logical validator Logical condition			count() issuesUnderEpic() filterByResolution()