subtasks()

subtasks

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

Bash
subtasks() #Output: Issue list
Examples

Parser expression

Description

Bash
%{subtasks()}

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

IT-321

Output

This function returns an issue list

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


Issue list

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

Bash
subtasks(issueList) #Output: Issue list

Examples

Parser expression

Description

Bash
%{subtasks(linkedIssues())}

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

IT-321, IT-323

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

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


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

Bash
subtasks(issueKeys) #Output: Issue list

Examples

Parser expression

Description

Bash
%{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

Bash
%{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

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

issueKeys

text

A comma separated list of issue keys.

Output

This function returns an issue list

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


(books) Use cases and examples