lastFieldHistory
Looking for the documentation on the newest versions of SIL Engine and the Simple Issue Language for Jira 8 for Server/Data Center? Click here !
The availability of the users personal data may be impacted by the recent changes by Atlassian in order to meet GDPR compliance. See the following for more information:
Availability
This routine is available starting with katl-commons 2.5.13 / 2.6.5. Updated in 4.8.0.8 - added two new fields oldValueString and newValueString in the result.
This routine is available for Jira server and cloud deployment options.
Syntax
lastFieldHistory(issueKey)
Description
Returns the last change details (user | date | field | oldValue | newValue | oldValueString | newValueString) from the selected issue's history.Parameters
Parameter name | Type | Required | Description |
|---|---|---|---|
issue key | String | Yes | Key of the selected issue. |
Return type
string []
The return value is an array of strings, containing the following values in the specified order: the user who made the change, the date, the name of the field that has been modified, the old field value and the new field value.
Example
string[] lastChange = lastFieldHistory(key); string ret = "Issue " + key + " was last changed on " + lastChange[1] + " by " + userFullName(lastChange[0]); ret += ": Field " + lastChange[2] + " from >>" + lastChange[3] + "<< to >>" + lastChange[4] + "<<"; return ret;
Result: Issue DEMO-5 was last changed on 2013-08-20 16:47:57 by Admin User: Field assignee from >>Admin User<< to >>Test User<<
Example (4.0.0)
At version 4.0.0 a structure has been introduced to represent the field history: JFieldChange. Backward compatibility is preserved:
JFieldChange last = lastFieldHistory("TEST-10");
runnerLog("LFH:" + last.user + " Field:" + last.field + " Val:" + last.oldVal + " -> " + last.newVal);
See also