Versions Compared

Key

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


Page properties
hiddentrue



Status
Tech review

Status
colourYellow
titletodoReady for review

Style guide

Status
colourYellow
titletodoReady for review

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



Page properties
hiddentrue


Short description

Returns the issue list of issues resulting of the execution of a JQL query represented by string argument jql_query. Visibility permissions applied are those of current userreturned by the specified JQL.

Output

Status
subtletrue
titleissue list

Available since

Status
subtletrue
colourBlue
title2.1.33




UI Text Box
sizemedium
typeinfo

This function returns the issue list of issues resulting of the execution of a JQL query represented by string argument jql_query. Visibility 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.


UI Text Box
typetip

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).


Code Block
languagebash
titleSyntax
linenumberstrue
issuesFromJQL(string jql_queryjqlQuery) #Output: Issue list


UI Expand
titleExamples


Parser expressionDescription


Code Block
languagebash
linenumberstrue
issuesFromJQL("status in (Open, Done)")


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



UI Expand
titleAdditional information

Parameters used in this function

ParameterInput (data type)Description
xxx
jqlQuery

Status
subtletrue
title

data typeParameter description.

text

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




UI Expand
titleOutput

This function returns an

Status
subtletrue
titleissue list
.

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

Status
subtletrue
titleissue list
.