Page History

Versions Compared

Old Version 3

changes.mady.by.user Decadis AG

Saved on Apr 02, 2019

compared with

New Version Current

changes.mady.by.user Decadis AG

Saved on Apr 02, 2019

Key

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

Excerpt

Overview

The expression parser offers multiple functions that cannot easily be categorized.

A comprehensive list can be found below.

Available functions

Function Input Returned value

projectProperty(string property_name)

Status


colour	Yellow
title	String

Returns a

Status


colour	Yellow
title	String

with the value of project property with name property_name in current issue's project. null is returned if project property doesn't exist.
Example: projectProperty("maxNumberOfReopenings") returns "3" , provided there is a string {maxNumberOfReopenings=3} in the description of current issue's project.

projectProperty(string property_name, string project_key)

Status


colour	Yellow
title	String

Returns a

Status


colour	Yellow
title	String

with the value of project property with name property_name in project with key project_key. null is returned if project property doesn't exist.
Example: projectProperty("maxNumberOfReopenings", "CRM") returns "3" , provided there is a string {maxNumberOfReopenings=3} in the description of project with key CRM.

projectPropertyExists(string property_name)

Status


colour	Yellow
title	String

Returns

Status


colour	Green
title	BOOLEAN

true only if there is a project property with name property_name in current issue's project, i.e., if project's description contains a string like {property_name=value}.

Example: projectPropertyExists("maxNumberOfReopenings") returns true only if there is a string like {maxNumberOfReopenings=x} in the description of current issue's project.

projectPropertyExists(string property_name, string project_key)

Status


colour	Yellow
title	String

Returns

Status


colour	Green
title	BOOLEAN

true only if there is a project property with name property_name in project with key project_key.

Info

title	Example

projectPropertyExists("maxNumberOfReopenings", "CRM") returns true only if there is a string like {maxNumberOfReopenings=x} in the description of project with key CRM.

isAClone()

Returns

Status


colour	Green
title	BOOLEAN

true only if current issue is a clone of another issue. An issue is a clone of another issue if it's being created by Jira "Clone" operation, or has issue links of type "clones". This function if useful for bypassing validations in transition Create Issue when the issue is being created by a clone operation.

allComments()

Returns a

Status

subtle	true
colour	Yellow
title	String []

with all the comments in current issue in ascension order by creation date.

allComments(string issue_keys)

Status


colour	Yellow
title	String

Returns a

Status

subtle	true
colour	Yellow
title	String []

with all the comments in issues with keys in issue_keys, in order of appearance in issue_keys, and by creation date in ascension order. Argument issue_keys is a comma separated list of issue keys.

Info

title	Example

allComments(%{...parentIssuekey}) returns parent issue's comments.

allComments(issue list l)

Status

subtle	true
title	Issue []

Returns a

Status

subtle	true
colour	Yellow
title	String []

with all the comments in issues in l, in order of appearance in l, and by creation date in ascension order.
Example: allComments(subtasks()) returns all the comments in all the sub-tasks of current issue.

allCommenters()

Returns a

Status

subtle	true
colour	Yellow
title	String []

with the user names of comment authors and updaters in current issue, in ascension order by commenter's actuation time. The same user appears in the output as many times as the comments the user created and updated.

allCommentCreators()

Returns a

Status

subtle	true
colour	Yellow
title	String []

with the user names of comment creators in current issue, in ascension order by commenter's actuation time. A same user appears in the output as many times as comments has created. For anonimous comments an empty string ("") is returned.

allCommentCreators(string issue_keys)

Status


colour	Yellow
title	String

Returns a

Status

subtle	true
colour	Yellow
title	String []

with the user names of comment creators in issues with keys in issue_keys, in order of appearance in issue_keys, and in ascension order by commenter's actuation time. A same user appears in the output as many times as comments has created. For anonymous comments an empty string ("") is returned.

allCommentCreators(string list l)

Status

subtle	true
colour	Yellow
title	String []

Returns a

Status

subtle	true
colour	Yellow
title	String []

with the user names of comment creators of issues in l, in order of appearance in l, and in ascension order by commenter's actuation time. A same user appears in the output as many times as comments has created. For anonimous comments an empty string ("") is returned.

allCommenters(string issue_keys)

Status


colour	Yellow
title	String

Returns a

Status

subtle	true
colour	Yellow
title	String []

with the user names of comment authors and updaters of issues with keys in issue_keys, in order of appearance in issue_keys, and in ascension order by commenter's actuation time. Argument issue_keys is a comma separated list of issue keys.

Info

title	Example

allComments(%{...parentIssuekey}) returns a string list with the user names of comment authors of parent issue.

allCommenters(issue list l)

Returns a

Status

subtle	true
colour	Yellow
title	String []

with the user names of comment authors and updaters of issues in l in ascension order by actuation time, in order of appearance in l, and in ascension order by commenter's actuation time.
Example: allCommenters(linkedIssues("is blocked by")) returns a list with all the commenters and comment updaters for linked issues blocking current issue.

usersWhoTransitioned(string origin_status, string destination_status)

Status


colour	Yellow
title	String

Returns a

Status

subtle	true
colour	Yellow
title	String []

with the names of the users who transitioned current issue from origin_status to destination_status, order ascending by time. An empty string as argument is interpreted as any status.

Info

title	Example

last(usersWhoTransitioned("Open", "In Progress")) returns the name of the user who executed transition "Start Progress" more recently.

usersWhoTransitioned(string origin_status, string destination_status, string issue_key)

Status


colour	Yellow
title	String

Returns a

Status

subtle	true
colour	Yellow
title	String []

with the names of the users who transitioned current issue from origin_status to destination_status, order ascending by time. An empty string as argument is interpreted as any status.

Info

title	Example

count(usersWhoTransitioned("Open", "In Progress", %{...parentIssuekey})) returns the number of times transition "Start Progress" has been executed in parent issue.

timesOfTransition(string origin_status, string destination_status)

Status


colour	Yellow
title	String

Returns a

Status

subtle	true
colour	Blue
title	number []

with the times when current issue was transitioned from origin_status to destination_status, order ascending by time. An empty string as argument is interpreted as any status.

Info

title	Example

last(timesOfTransition("", "Resolved")) returns the most recent time when the issue was resolved.

timesOfTransition(string origin_status, string destination_status, string issue_key)

Status


colour	Yellow
title	String

Returns a

Status

subtle	true
colour	Blue
title	number []

with the times when issue with key issue_key was transitioned from origin_status to destination_status, order ascending by time. An empty string as argument is interpreted as any status.

Info

title	Example

first(usersWhoTransitioned("Closed", "", %{...parentIssuekey})) returns the first time when parent issue was reopened.

componentLeader(string component_name)

Status


colour	Yellow
title	String

Returns the user name of the component lead with name component_name in current issue's project as

Status


colour	Yellow
title	String

. This function also admits a comma separated list of components, and returns a comma separated list of user names. Output will contain repeated user names if a same user is leader of more than one component.

Info

title	Example

componentLeader(%{...components}) returns a comma separated list with the user names of the leaders of current issue's components.

componentLeader(string component_name, string project_key)

Status


colour	Yellow
title	String

Returns a the user name of the component lead with name component_name in project with key project_key as

Status


colour	Yellow
title	String

Info

title	Example

componentLeader("Web Portal", "CRM") returns the user name of the leader of the component with name Web Portal in project with key CRM.

issueIDFromKey(string issue_key)

Status


colour	Yellow
title	String

Returns a

Status


colour	Yellow
title	String

of the internal ID of issue with key issue_key. This function also admits a comma separated list of issue keys, and returns a comma separated list of internal IDs.

Info

title	Example

issueIDFromKey("CRM-1") returns "10001" .

issueKeyFromID(string issue_ID)

Status


colour	Yellow
title	String

Returns a

Status


colour	Yellow
title	String

of the issue key of issue with internal ID issue_ID. This function also admits a comma separated list of issue IDs, and returns a comma separated list of issue keys.

Info

title	Example

issueIDFromKey("10001") returns "CRM-1" .

projectKeys()

Returns a

Status

subtle	true
colour	Yellow
title	String []

with all the project keys in the JIRA instance.

projectKeys(string category)

Status


colour	Yellow
title	String

Returns a

Status

subtle	true
colour	Yellow
title	String []

with the project keys of those projects that belong to project category with name category.

projectName(string project_key)

Status


colour	Yellow
title	String

Returns a

Status


colour	Yellow
title	String

with the name of the project with key project_key.

projectCategory(string project_key)

Status


colour	Yellow
title	String

Returns a

Status


colour	Yellow
title	String

with the category of the project with key project_key.

Div

style	line-height: 150%;
id	tocContainer
class	tocContainer

Panel

borderColor	#333f48
bgColor	#FFFFFF
titleColor	#eeeeee
borderWidth	1
titleBGColor	#333f48
borderStyle	solid
title	On this page

Table of Contents

maxLevel	3
minLevel	2
indent	20px
class	p

Content

Space Tools

Page History

Versions Compared

Old Version 3

New Version Current

Key

Overview

Available functions