Status
Tech review

Style guide




Short description

Returns the issue list of issues returned by the specified JQL.

Output

Available since




This function returns the issue list of issues returned by the specified JQL. Visibility permissions applied are those of current user.

Typically you will want to use this function for replacing any current expression using getIssuesFromProjects() function.


We advice to use this function for performance reasons when the number of issues to be retrieved or filtered is very high (all issues in a project or various projects).


issuesFromJQL(jqlQuery) #Output: Issue list



Parser expressionDescription


issuesFromJQL("status in (Open, Done)")


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


issuesFromJQL("'Story points' is not empty")


This example returns an issue list with all issues that do have Story points.



Parameters used in this function

ParameterInput (data type)Description
jqlQuery

Any valid JQL Query.

(warning) Double quotation marks in the 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




This function returns an .

If the jqlQuery does not return a result, the function returns an empty .