getMatchingValue() | Decadis App Help Center

Text key number list

This function returns the numeric reference value of a given text.

If this textKey does not exist in the textList, the function returns the last value of the referenceNumberList, if the referenceNumberList has one value more than the textList, otherwise null

Bash

getMatchingValue(textKey, textList, referenceNumberList) #Output: Number

Examples

Parser expression	Description
Bash `%{getMatchingValue(%{issue.priority}, ["High", "Medium", "Low"], [3, 2, 1])}`	This example returns the correct number depending on the current priority. This example could be used e.g. in the Update fields post function to set a specific field depending on the current priority.
Bash `%{getMatchingValue("Critical", ["Normal", "High", "Critical"], [1, 5, 20])}`	This example returns: 20
Bash `%{getMatchingValue("None", ["Normal", "High", "Critical"], [1, 5, 20, 0])}`	This example returns 0 The textKey "None" is not available in the textList, so the last value of the referenceNumberList is returned (it has one more value than the textList).
Bash `%{getMatchingValue("Three", ["One", "Two", "Three", "Four", "Five"], [1, 1+1, 3*1, 4, 4+1])}`	This example returns: 3

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`textKey`	text	A text that exists in the textList.
`textList`	text list	Any given text list.
`referenceNumberList`	number list	Any given number list.

Output

This function returns a number

Number key number list

Variant with a numberKey and two number lists.

Bash

getMatchingValue(numberKey, numberList, referenceNumberList) #Output: Number

Examples

Parser expression	Description
Bash `%{getMatchingValue(5, [1, 3, 5, 7, 9], [1, 1+1, 3*1, 4, 4+1])}`	This example returns: 3
Bash `%{getMatchingValue(3, [1, 5, 7, 9], [1, 2, 3, 4, 99])}`	This example returns: 99 The numberKey 3 is not available in the numberList, so the last value of the referenceNumberList is returned (it has one more value than the numberList).

Parser expression

Description

Bash

%{getMatchingValue(5, [1, 3, 5, 7, 9], [1, 1+1, 3*1, 4, 4+1])}

This example returns:

Bash

%{getMatchingValue(3, [1, 5, 7, 9], [1, 2, 3, 4, 99])}

This example returns:

The numberKey 3 is not available in the numberList, so the last value of the referenceNumberList is returned (it has one more value than the numberList).

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`numberKey`	number	A number that exists in the numberList.
`numberList`	number list	Any given number list.
`referenceNumberList`	number list	Any given number list.

Output

This function returns a number

Text key text list

This function returns the text reference value of a given text.

If this textKey does not exist in the textList, the function returns the last value of the referenceTextList, if the referenceTextList has one value more than the textList, otherwise an empty text.

Bash

getMatchingValue(textKey, textList, referenceTextList) #Output: Text

Examples

Parser expression	Description
Bash `%{getMatchingValue("Spain", ["USA", "UK", "France", "Spain", "Germany"], ["Washington", "London", "Paris", "Madrid", "Berlin"])}`	This example returns: "Madrid"
Bash `%{getMatchingValue(%{issue.issueType}, ["Task", "Sub-Task", "Story"], ["This is the description for a Task.", "Description for a Sub-Task", "Here comes the Story."])}`	This example returns the correct description depending on the current issue type. This could be used e.g. in the Create issue or Update fields post function to set the description depending on the selected issue type.

Parser expression

Description

Bash

%{getMatchingValue("Spain", ["USA", "UK", "France", "Spain", "Germany"], ["Washington", "London", "Paris", "Madrid", "Berlin"])}

This example returns:

"Madrid"

Bash

%{getMatchingValue(%{issue.issueType}, ["Task", "Sub-Task", "Story"], ["This is the description for a Task.", "Description for a Sub-Task", "Here comes the Story."])}

This example returns the correct description depending on the current issue type.

This could be used e.g. in the Create issue or Update fields post function to set the description depending on the selected issue type.

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`textKey`	text	A text that exists in the textList.
`textList`	text list	Any given text list.
`referenceTextList`	text list	Any given text list.

Output

This function returns a text

Number key text list

Variant with a number list.

Bash

getMatchingValue(numberKey, numberList, referenceTextList) #Output: Text

Examples

Parser expression	Description
Bash `%{getMatchingValue(8, [2, 4, 6, 8, 10], ["Washington", "London", "Paris", "Madrid", "Berlin"])}`	This example returns: "Madrid"

Parser expression

Description

Bash

%{getMatchingValue(8, [2, 4, 6, 8, 10], ["Washington", "London", "Paris", "Madrid", "Berlin"])}

This example returns:

"Madrid"

Additional information

Parameters used in this function

Parameter	Input (data type)	Description
`numberKey`	number	A number that exists in the numberList.
`numberList`	number list	Any given number list.
`referenceTextList`	text list	Any given text list.

Output

This function returns a text

(books) Use cases and examples

Use case	Workflow function	Parser functions
Set the due date based on the priority	Update fields	getMatchingValue()
Set the Assignee based on the Issue type	Update fields	getMatchingValue()
Create a sub-task for each component	Create issue	toStringList() getMatchingValue()