Looking for the documentation on the newest versions of SIL Engine and the Simple Issue Language for Jira 8? Click here and leave these dusty old pages behind!
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