Availability
This routine is available starting with SIL Engine™ 4.0.4.
Syntax
getFieldChanges(key, history_field_name)
Description
Returns a list of tuples containing user|field|oldVal|newVal for the selected field from the selected issue's history.Parameters
Parameter name | Type | Required | Description |
|---|---|---|---|
key | String | Yes | The key of the selected issue. |
history_field_name | String | Yes | The name of the selected field. |
Return type
The return value is an array of JFieldChange. The strings come in pairs:
- A date representing the time when the value was modified
- The content of the requested field at that date.
Example
JFieldChange[] changes = getFieldChanges("TEST-10", "My Text Field");
return changes;
Result:
admin|2017-05-23 13:28:05|My Text Field||test|admin|2017-05-23 13:28:09|My Text Field|test|lalaa
Example 2
Let's say we want to get the latest change for the given field:
JFieldChange[] changes = getFieldChanges("TEST-10", "customfield_10200");
JFieldChange latestChange = changes[0];
date newest = latestChange.changeDate;
for (JFieldChange change in changes) {
if (change.changeDate > newest) {
latestChange = change;
}
}
return latestChange;
Result:
Done. Program returned: admin|2017-05-23 13:28:09|Text Field|aaaaa|nnnnn
Notes
- Besides the labels/ids of the custom fields, the name of the standard Jira fields (summary, assignee etc.) can be used as parameters.
- If it returns an empty array, you must get the last value of the field from the issue.
- The second parameter is the field name as it appears in history.
See also