Page History

Versions Compared

Old Version 3

changes.mady.by.user Iheb Kharab

Saved on Mar 27, 2020

compared with

New Version Current

changes.mady.by.user Iheb Kharab

Saved on Jan 05, 2022

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`

Page properties

hidden	true

Status

Tech review

Status

title	todo

Style guide

Status

title	todo

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 the

Status

subtle	true
title	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 user.

Output

Status

title

subtle	true

	text

Any valid JQL Query.

issue list

UI Text Box

size	medium
type	info

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 The function returns the

Status


subtle	true
title	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 user.Typically you will want to use this function for replacing any current expression using getIssuesFromProjects() function.

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	tip	info

Variant where you additionally can specify a user which will execute the JQL queryWe 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

language	bash
title	Syntax
linenumbers	true

issuesFromJQL(text jql_queryjqlQuery, 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

<parameter>jqlQuery

Status


subtle	true
title	data type	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 nameParameter description.

UI Expand

title	Output

This function returns an

Status


subtle	true
title	issue list

If the JQL query does not return a result, the 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, Field type, Automated action, Parser functions
cql	label = "parser_func_issuesfromjql" and space = currentSpace()

Page properties

hidden	true
id	1

Parser function cloud	issuesFromJQL()
Map
Notes

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 3

New Version Current

Key

Image AddedUse cases and examples