jiraExpression()

This function returns the result of a given Jira expression.

Syntax

jiraExpression(text) #Output: Text

Examples

Parser expression

Description

%{sort(distinct(toStringList(jiraExpression("issue.subtasks.map(s=>s.components.map(c=>c.name))"))),ASC)}

This example returns an ordered list of the unique component names of all sub-tasks of an issue, e.g.

Backend, Frotend, UI

%{Hi [~accountid:%{issue.project.lead}],
the user %{system.currentUser.displayName} has written 
%{jiraExpression("issue.comments.filter(c=>c.author.accountId==user.accountId).length")} comments to this issue and created %{jiraExpression("issue.subtasks.filter(s=>s.reporter.accountId==user.accountId).length")} sub-tasks.}

This example returns:

Hi [~accountid:557058:145e0473-5707-439c-80e4-1160dd57f114],

the user John Doe has written 3 comments to this issue and created 2 sub-tasks.

Additional information

Parameters used in this function

Parameter Input (data type) Description

text

TEXT

Any given text which can be evaluated as Jira expression.

The text is not checked for syntactical correctness when defining it in the parser expression editor.

Output

This function returns a TEXT

Variant where you can additionally define a list of issues which can be used within the Jira expression given as the first parameter. You can access these issues using issues as context.

Syntax

jiraExpression(text, issueList) #Output: Text list

Examples

Parser expression	Description
%{sort( distinct( jiraExpression("issues.map(i=>i.subtasks).flatten().map(s=>s.components.map(c=>c.name)).flatten()", linkedIssues())), ASC)}	This example returns an ordered list of the unique component names of all sub-tasks of the linked issues, e.g. Backend, Frotend, UI To achieve this the following function is used: linkedIssues() You have to use flatten because sub-tasks of a list of issues are returned as a multi list in a Jira expression.

Additional information

Parameters used in this function

Parameter Input (data type) Description

text

TEXT

Any given text which can be evaluated as Jira expression.

The text is not checked for syntactical correctness when defining it in the parser expression editor.

issueList

ISSUE LIST

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

Output

This function returns a TEXT LIST

Variant where you can additionally define a string of Issue keys which can be used within the Jira expression given as the first parameter. You can access these issues using issues as context.

Syntax

jiraExpression(text, issueKeys) #Output: Text list

Examples

Parser expression	Description
%{sort( distinct( jiraExpression("issues.map(i=>i.subtasks).flatten().map(s=>s.components.map(c=>c.name)).flatten()", "PU-2, PU-7, PU-120")), ASC)}	This example returns an ordered list of the unique component names of all sub-tasks of the issues listed in the second parameter, e.g. Backend, Frotend, UI You have to use flatten because sub-tasks of a list of issues are returned as a multi list in a Jira expression.

Additional information

Parameters used in this function

Parameter Input (data type) Description

text

TEXT

Any given text which can be evaluated as Jira expression.

The text is not checked for syntactical correctness when defining it in the parser expression editor.

issueKeys

TEXT

A text with a comma-separated list of issue keys.

Output

This function returns a TEXT LIST

Content

Space Tools