Page History

Versions Compared

Key

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

UI Text Box

size	medium
type	info

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

UI Text Box

type	tip

We suggest using this function for performance reasons when the number of issues to be retrieved or filtered is very high (e.g. all issues in a project or in status) instead of functions like:

Code Block

language	bash
title	Syntax
linenumbers	true

issuesFromJQL(jqlQuery) #Output: Issue list

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

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

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

Code Block

language	bash
linenumbers	true

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

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

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

jqlQuery

Status


subtle	true
title	text

Any valid JQL Query.

UI Text Box

type	note

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

UI Expand

title	Output

This function returns an

Status


subtle	true
title	issue list

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

Status


subtle	true
title	issue list

UI Text Box

size	medium
type	info

Variant where you additionally can specify a user which will execute the JQL query.

Code Block

language	bash
title	Syntax
linenumbers	true

issuesFromJQL(jqlQuery, userName) #Output: Issue list

UI Expand

title	Examples

Parser expression

Description

Code Block

language	bash
linenumbers	true

issuesFromJQL("status in (Open, Done)",%{issue.reporter))

This example returns an issue list with all issues that are in status "Open" or "Done" that are visible for the reporter of the given issue.

UI Expand

title	Additional information

Parameters used in this function

Parameter Input (data type) Description

jqlQuery

Status


subtle	true
title	text

Any valid JQL Query.

UI Text Box

type	note

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

userName

Status


subtle	true
title	text

Text containing a valid user name.

UI Expand

title	Output

This function returns an

Status


subtle	true
title	issue list

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

Status


subtle	true
title	issue list

Image AddedUse cases and examples

Page properties report

firstcolumn	Use case
headings	JWT feature, Workflow function, Parser functions
cql	label = "parser_func_issuesfromjql" and space = currentSpace()

Page properties

hidden	true

Status

Tech review

Status

colour	Green
title	done

Style guide

Status

colour	Green
title	done

Status

title	todo

Status

colour	Yellow
title	Ready for review

Status

colour	Green
title	done

Status

colour	Red
title	flagged

Page properties

hidden	true

Short description

Returns a list of issues returned by a specified JQL query.

Output

Status


subtle	true
title	issue list

Available since

Status

subtle	true
colour	Blue
title	2.1.33

Label

Status


colour	Red
title	staff pick

Content

Space Tools

Versions Compared

Old Version 22

New Version 23

Key

Image AddedUse cases and examples