Text field
This function returns the timestamps of when a text field was changed satisfying a certain condition.
fieldChangeTimes(textField, condition) #Output: Number list
Examples
|
Parser expression |
Description |
|---|---|
|
Bash
|
This example returns the list of timestamps of when the word "IMPORTANT" has been added to the current issue's summary ignoring the case. |
|
Bash
|
This example returns the list of timestamps of when the current issue's priority has been changed to Critical or High. |
Additional information
Parameters used in this function
|
Parameter |
Input (data type) |
Description |
|---|---|---|
|
|
text |
Any field code representing a text field or a selectable field. |
|
|
boolean |
The condition is used to check the field value before and after the field change. The text value before the change is represented by |
Output
This function returns a Number list containing the timestamps in ascending order
Number field
Variant for numeric / date-time fields.
fieldChangeTimes(numberField, condition) #Output: Number list
Examples
|
Parser expression |
Description |
|---|---|
|
Bash
|
This example returns the list of timestamps of when the Due date has been increased (updated to a higher value). |
|
Bash
|
This example returns the list of timestamps of when a number field called Passengers (with the custom field ID 10001) has been edited with a variation of at least 25% over its previous value. |
Additional information
Parameters used in this function
|
Parameter |
Input (data type) |
Description |
|---|---|---|
|
|
number |
Any field code representing a number field (including dates). |
|
|
boolean |
The condition is used to check the field value before and after the field change. The number value before the change is represented by |
Output
This function returns a Number list containing the timestamps in ascending order
Text field issue list
Variant for text fields in multiple issues from a given issue list.
fieldChangeTimes(textField, issueList, condition) #Output: Number list
Examples
|
Parser expression |
Description |
|---|---|
|
Bash
|
This example returns the list of timestamps of when the word "IMPORTANT" has been added the the summary of all current sub-tasks, ignoring the case. |
|
Bash
|
This example returns the list of timestamps of when the issue priority of the current issue's epic has been set. |
|
Bash
|
This example returns the list of timestamps of when the priority in all blocking linked issues has become Critical or High. |
Additional information
Parameters used in this function
|
Parameter |
Input (data type) |
Description |
|---|---|---|
|
|
text |
Any field code representing a text field or a selectable field. |
|
|
issue list |
A list of issues that will be checked. Learn more about Lists. |
|
|
boolean |
The condition is used to check the field value before and after the field change. The text value before the change is represented by |
Output
This function returns a text list containing the timestamps in ascending order
Number field issue list
Variant for numeric / date-time fields in multiple issues from a given issue list.
fieldChangeTimes(numberField, issueList, condition) #Output: Number list
Examples
|
Parser expression |
Description |
|---|---|
|
Bash
|
This example returns the list of timestamps of when the Due Date has been edited to a higher value in any of the current sub-tasks. |
|
Bash
|
This example returns the list of timestamps when a number 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 |
Additional information
Parameters used in this function
|
Parameter |
Input (data type) |
Description |
|---|---|---|
|
|
number |
Any field code representing a number field (including dates). |
|
|
issue list |
A list of issues that will be checked. Learn more about Lists. |
|
|
boolean |
The condition is used to check the field value before and after the field change. The number value before the change is represented by |
Output
This function returns a Number list containing the timestamps in the order of issue appearance
(books) Use cases and examples
| Use case | JWT feature | Workflow function | Field type | Automated action | Parser functions |
|---|---|---|---|---|---|
| Number of times a custom field has been changed |
|
Number |