Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titletododone

Style guide

Status
colourGreen
titletododone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged



Page properties
hiddentrue


Short description

Returns an issue list of epics under which the specific issue(s) are all epics linked to specified issues.

Output

Status
subtletrue
titleissue list

Available since

Status
subtletrue
colourBlue
title2.3.0




UI Text Box
sizemedium
typeinfo

This function returns the issue list of epics under which the specific issue(s) are 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.


Code Block
languagebash
titleSyntax
linenumberstrue
epic() #Output: Issue list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
epic()


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



UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list
.

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

Status
subtletrue
titleissue list
.




UI Text Box
sizemedium
typeinfo

Variant where you can specify an issue list from which the epics should retrieved from. This function returns the issue list of epic issues under where those issues in argument issues are. If some of those issues are sub-tasks, then the epic of their parent is returned. Duplicated issues in argument issues are discarded.Output can contain duplicated issuesThe output may contain duplicates.


Code Block
languagebash
titleSyntax
linenumberstrue
epic(issue list issuesissueList) #Output: Issue list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
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:



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
xxxissueList

Status
subtletrue
titledata typeissue list

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



UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list




UI Text Box
sizemedium
typeinfo

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

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


Code Block
languagebash
titleSyntax
linenumberstrue
epic(string issue_keysissueKeys) #Output: Issue list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
epic("CRM-15, HD-21")


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



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
xxxissueKeys

Status
subtletrue
titledata typetext

Text containing valid issue keys in a comma-separated listParameter description.



UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list