You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 5 Next »

When a text value of field with code %{nnnnn} has changed satisfying a certain predicate that depends on the values of the field before and after the value change. 

The text value before the change is represented by ^0%, and by ^1% after the change.

The function returns NUMBER LIST representing the timestamps in ascending order.

Syntax
fieldChangeTimes(string field field, boolean expression predicate) #Output: Number list
Examples
Parser expressionDescription
fieldChangeTimes(%{00000}, ^0% !~~ "IMPORTANT" AND ^1% ~~ "IMPORTANT")
The function returns the list of timestamps when the word "IMPORTANT" has been added to the current issue's summary (field code %{00000}) ignoring the case.
fieldChangeTimes(%{00017}, ^0% = null AND ^1% != null)
The function returns the list of timestamps of when the issue's priority (field code %{00017}) of the current issue has been set.
fieldChangeTimes(%{00017}, ^0% not in ["Critical", "High"] AND ^1% in ["Critical", "High"])
The function returns the list of timestamps when current issue's priority (field code %{00017}) has become Critical or High.
Additional information

Parameters used in this function

ParameterInput (data type)Description
<parameter>

DATA TYPE

Parameter description.

<parameter>

DATA TYPE

Parameter description.

Output

The function returns a NUMBER LIST


The function Returns the timestamps of when a numeric / date-time value of field with code {nnnnn} has changed satisfying a certain predicate that depends on the values of the field before and after the value change. The numeric value before the change is represented by ^0, and after the change by ^1.

The function returns the timestamps are returned as a NUMBER LIST sorted in ascending order.

Syntax
fieldChangeTimes(number field field, boolean expression predicate) #Output: Number list
Examples
Parser expression Description
fieldChangeTimes({00012}, ^0 < ^1)
The function returns the timestamps of when the Due date (field code {00012}) has been edited to a higher value.
fieldChangeTimes({10001}, abs(^0 - ^1) / ^0 >= 0.25)
The function returns the timestamps of when a hypothetical numeric field called Passengers (field code {10001}) has been edited with a variation of at least 25% over its previous value.
Additional information

Parameters used in this function

ParameterInput (data type)Description
<parameter>

DATA TYPE

Parameter description.

<parameter>

DATA TYPE

Parameter description.

<parameter>

DATA TYPE

Parameter description.
Output

The function returns a NUMBER LIST


The function returns the timestamps of when a string value of fields with code %{nnnnn} in distinct parameter issues have changed satisfying certain predicate that depends on the values of the fields before and after the value change. The string value before the change is represented by ^0%, and after the change by ^1%.

The timestamps are returned as a NUMBER LIST containing a sequence of sorted numeric values in ascending order for each parameter issue.

Syntax
fieldChangeTimes(string field field, issue list issues, boolean expression predicate) #Output: Number list
Examples
Parser expressionDescription
fieldChangeTimes(%{00000}, subtasks(), ^0% !~~ "IMPORTANT" AND ^1% ~~ "IMPORTANT")
returns the list of timestamps of when the word "IMPORTANT" has been added the the summary (field code %{00000}) of all current issue's sub-tasks, ignoring the case.
fieldChangeTimes(%{00017}, epic(), ^0% = null AND ^1% != null)
returns the list of timestamps of when the issue priority (field code %{00017}) of the current issue's epic has been set.
fieldChangeTimes(%{00017}, linkedIssues("is blocked by"), ^0% not in ["Critical", "High"] AND ^1% in ["Critical", "High"])
returns the list of timestamps of when the priority (field code %{00017}) in all blocking linked issues has become Critical or High.
Output

The function returns a NUMBER LIST containing a sequence of sorted numeric values in ascending order for each parameter issue.


The function returns the timestamps of when a numeric value of fields with code {nnnnn} in distinct parameter issues have changed satisfying a certain predicate that depends on the values of the fields before and after the value change. The numeric value before the change is represented by ^0, and after the change by ^1.

The timestamps are returned as a NUMBER LIST containing a sequence of sorted numeric values in ascending order for each parameter issue.

Syntax
fieldChangeTimes(number field field, issue list issues, boolean expression predicate) #Output: Number list
Examples
Parser expressionDescription
fieldChangeTimes({00012}, subtasks(), ^0 < ^1)
The function returns the timestamps of when the Due Date (field code {00012}) has been edited to a higher value in any of the current issue's sub-tasks.
fieldChangeTimes({10001}, epic(), abs(^0 - ^1) / ^0 >= 0.25)
The function returns the timestamps when a hypothetical numeric field called Passengers (field code {10001}) in the current issue's epic has been edited with a variation of at least 25% over its previous value