Breadcrumbs

issuesFromJQL()

This function returns an issue list of issues returned by the specified JQL query. Visibility restrictions (permissions and issue security) might apply. This query will be run as the configured run as user.

Bash
issuesFromJQL(jqlQuery) #Output: Issue list

Examples

Parser expression

Description
Bash
%{issuesFromJQL("status in (Open, Done)")}

This example returns an issue list with all issues that are in status "Open" or "Done", e.g:

IT-2232, IT-21233
Bash
%{issuesFromJQL("'Story point estimate' is not empty")}

This example returns an issue list with all issues that do have a story point estimation, e.g:

IT-2321, IT-2124, IT-342
Bash
%{issuesFromJQL("fixVersion = '"+%{issue.fixVersions}+"' AND project = '"+%{issue.project.key}+"' ")}

This example returns an issue list with all issues that share the same fix version and project as the current issue. e.g.:

IT-2321, IT-2124, IT-342

When referencing a field code in a JQL query it has to have the following format:

'"+%{issue.fixVersions}+"'

Example: project = '"+%{issue.project}+"'

Additional information

Parameters used in this function

Parameter

Input (data type)

Description

jqlQuery

text

Any valid JQL query.

warning  Double quotation marks in JQL have to be replaced with single quotation marks, e.g.:

Usually JQL would look like

"Epic Link" is not empty

Using it within issuesFromJQL()

'Epic Link' is not empty

Output

This function returns an issue list

If the JQL query does not return a result, the function returns an empty issue list


(books) Use cases and examples

Use case
No content found.