Entity Log

Entity Log is a mechanism for tracking changes in your JPA entities. It records changes in entity attributes and provides a user interface for searching and displaying information about the changes:

  • What entity instance was changed.

  • Old and new values of changed attributes.

  • When the entity was changed.

  • Which user changed the entity.

Installation

To include Entity Log functionality in your application, add the following lines to the dependencies section of your build.gradle file:

implementation 'io.jmix.audit:jmix-audit-starter'
implementation 'io.jmix.audit:jmix-audit-ui-starter'

Usage

Entity Log automatically tracks changes of JPA entities when they are saved using DataManager. It doesn’t work if you use EntityManager or native SQL.

You can also use the EntityLog bean to register changed entities from your application code. In this case, invoke registerCreate(), registerModify() and registerDelete() methods with auto parameter set to false. When the entity log is called automatically by the framework, this parameter is set to true.