Versions Compared

Key

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


Page properties
hiddentrue



Status
Tech review

Status
colourGreen
titledone
Status
colourRed
titlestaff pick

Style guide

Status
colourGreen
titledone

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



Page properties
hiddentrue


Short description

Returns the list of sub-tasks of the specified issue(s).

Output

Status
subtletrue
titleissue list




UI Text Box
sizemedium
typeinfo

This function returns the list of sub-tasks of the current issue.


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


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
%{subtasks()}


This example returns a list with the current issue's sub-tasks, e.g:

IT-321



UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list

If there are no sub-tasks, the function returns an empty 

Status
subtletrue
titleissue list




UI Text Box
sizemedium
typeinfo

Variant where you can specify multiple parent issues as an issue list.


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


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
%{subtasks(linkedIssues())}


This example returns the list of the linked issues' sub-tasks, e.g:

IT-321, IT-323




UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
issueList

Status
subtletrue
titleissue list

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



UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list

If there are no sub-tasks, the function returns an empty 

Status
subtletrue
titleissue list




UI Text Box
sizemedium
typeinfo

Variant where you can specify multiple parent issues as a comma separated list of issue keys.


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


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
%{subtasks(%{parent.key})}


This example returns the list of sub-tasks of the parent issue, i.e. sibling sub-tasks including the current sub-task, e.g:

IT-321, IT-323


Code Block
languagebash
linenumberstrue
%{subtasks("TASK-1, TASK-2")}


This example returns the list of sub-tasks of the specified issues, e.g:


TASK-6, TASK-10, TASK-11



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
issueKeys

Status
subtletrue
titletext

A comma separated list of issue keys.



UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list

If there are no sub-tasks, the function returns an empty

Status
subtletrue
titleissue list