To keep track of who made a particular change, and why.
To keep track of who made a particular change, and why. This is useful when looking at the history of changes. It will get attached to the current diff, and exposed as opmUpdatedBy and opmUpdateReason. Example usage:
obj.set(_.name).to("My Name").by("00000000-0000-0000-0000-000000000000", "updated from service x")
or
obj. set(_.name).to("My Name"). set(_.description).to("My desc"). set(_.time).to(new DateTime()). prune. by("00000000-0000-0000-0000-000000000000", "updated from service x")
A guid-type identifier of the person/application responsible for the change.
A readable reason why/how the change occurred.
Use this method to check if a field is pending, without resorting to a try.
Use this method to check if a field is pending, without resorting to a try...catch