Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from this space and version 2.6.1


Section


Column
width600px


Panel
borderColor#333f48
bgColor#FFFFFF
titleColor#eeeeee
borderWidth1
titleBGColor#333f48
borderStylesolid
titleOn this page

Table of Contents
maxLevel1



Column




Status
colourYellow
titlesince version 2.6.0

Since version 2.6.0 it is now possible to temporarily store values . Having this capability makes it possible to reference these values later on in the through functions. Stored values can easily be retrieved or referenced later in the same expression.

Example

Before value storageAfter value storage
toNumber(
count(
issuesFromJQL("issue in linkedIssues('" + %{Issue key} + "','blocks','is blocked by')")
)
) > 5 ?
"<font color=\"red\">" + toNumber(
count(
issuesFromJQL("issue in linkedIssues('" + %{Issue key} + "','blocks','is blocked by')")
)
) + "</font>"
: "<font color=\"green\">" + toNumber(
count(
issuesFromJQL("issue in linkedIssues('" + %{Issue key} + "','blocks','is blocked by')")
)
) + "</font>"

setNumber("x",

toNumber(

count(

issuesFromJQL("issue in linkedIssues('" + %{Issue key} + "','blocks','is blocked by')")

)

)

) > 5 ? "

<font color=\"red\">" + getNumber("x") + "</font>"

: "<font color=\"green\">" + getNumber("x") + "</font>"

Expressions

FunctionReturned valuesetNumber(string variable_name, number value) : numberReturns value and stores it into an internal numerical variable called variable_name.
Info

Functions used to retrieve (get) values previously stored (set) can directly be used in the same expression.

The values can only be used for the current expression and cannot be reused in another expression.

Expressions

getNumber(string 
Excerpt


FunctionReturned value
setBoolean(string variable_name, boolean value) : boolean

Creates a variable named variable_name for storing a boolean value, and assigns it a value, which is also returned in order to be used within an expression.

Example: setBoolean("myBoolean",true)

getBoolean(string variable_name) : boolean

Returns the value stored in a boolean variable named variable_name, which was previously created using the setBoolean() function.

Example: getBoolean("myBoolean")

setNumber(string variable_name, number value) : number

Creates a variable named variable_name for storing a number, and assigns it a value, which is also returned in order to be used within an expression.

Example: setNumber("myNumber",100)

getNumber(string 
variable_name) : number

Returns the

numeric

value stored

into internal variable called 

in a numeric variable named variable_name, which was previously created using the setNumber() function.

Example: getNumber("myNumber")

setString(
string 
string variable_name,
string getString(string 
string value) : string
Returns value and stores it into an internal string variable called variable_name.

Creates a variable named variable_name for storing a string, and assigns it a value, which is also returned in order to be used within an expression.

Example: setString("myString","Hello World!")

getString(string 
variable_name) : string

Returns the

string

value stored

into internal variable called 

in string variable named variable_name, which was previously created using the setString() function.

Example: getString("myString")

setNumberList(
string 
string variable_name, number
list getNumberList(string 
list value) : number list
Returns value and stores it into an internal numerical list variable called variable_name.

Creates a variable named variable_name for storing a number list, and assigns it a value, which is also returned in order to be used within an expression.

Example: setNumberList("myNumberList",[1,2,3])

getNumberList(string 
variable_name) : number list

Returns the value stored in number list

 value stored into an internal variable called 

variable named variable_name, which was previously created using the setNumberList() function.

Example: getNumberList("myNumberList")

setStringList(
string 
string variable_name, string
list getStringList(string 
list value) : string list
Returns value and stores it into an internal string list variable called variable_name.

Creates a variable named variable_name for storing a string list, and assigns it a value, which is also returned in order to be used within an expression.

Example: setStringList("myStringList",["Hello","World"])

getStringList(string 
variable_name) : string list

Returns the value stored in string list

 value stored into an internal variable called 

variable named variable_name, which was previously created using the setStringList() function.

Example: getStringList("myStringList")

setIssueList(
string 
string variable_name, issue
list getIssueList(string 
list value) : issue list
Returns value and stores it into an internal issue list variable called variable_name.

Creates a variable named variable_name for storing an issue list, and assigns it a value, which is also returned in order to be used within an expression.

Example: setIssueList("myIssueList",["KEY-1","KEY-2"])

getIssueList(string 
variable_name) : issue list

Returns the value stored in issue list

 value stored into an internal variable called variable_name.setBoolean(string variable_name, boolean value) : booleanReturns value and stores it into an internal variable variable called variable_name.getBoolean(string variable_name) : booleanReturns boolean value stored into an internal variable called variable_name. Info

Note that every setter method always returns the stored value so that it can be immediately used for saving and calling the value in the expression (as seen in the example above).

variable named variable_name, which was previously created using setIssueList() function.

Example: getIssueList("myIssueList")



Example

Tip
titleEXAMPLE

You want to emphasize the importance of blocking issues by returning AND coloring the number of linked blocking issues.

If more than 3 issues are linked as blocking issues the exact number will be returned in red otherwise in green.

The number will directly be saved (set) and later referenced as x via the set/get method/function. 


Before value storageAfter value storage
count(linkedIssues("is blocked by")) > 3
"<font color=\"red\">" + count(linkedIssues("is blocked by"))  + "</font>"
: "<font color=\"green\">" + count(linkedIssues("is blocked by"))  + "</font>"

setNumber("x", count(linkedIssues("is blocked by")) > 3

? "<font color=\"red\">" + getNumber("x") + "</font>"

: "<font color=\"green\">" + getNumber("x") + "</font>"

The values are only going to be saved for the current expression and cannot be reused in another expression.