Child pages
  • Development-Audit Trails

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Code Block
override saveChanges()
  foreach obj (self.changedObjects)
  foreach obj (self.insertedObjects)
  foreach obj (self.deletedObjects)

Ken Anderson

(scooped from the mailinglist)

I use a hybrid approach...

I use the database to copy every row modified or deleted to an audit table. Every object has a trans_id field, which is a foreign key relationship to a transaction table. The primary key of that table increases like regular unique integer primary keys.

In EOF, I have sub-entities of all my EOs that have a prefix (like Aud...). These EOs are also subclasses of their main counterparts, then have an imported text file that represents the code I want all audit EOs to share (here's a good case for multiple inheritance!).

The Aud.. EOs have an additional real column called resp_trans_id (the transaction RESPonsible for causing the row to move to the audit table), plus an additional 'fictitious' attribute called 'asof_trans_id'. This is the trans_id that you want the entire object structure to be 'as of'.

The primary key of the audit EOs is the oid AND asof_trans_id so you can have multiple historical audit EOs in the EC.

The Aud EOs then have store procedures for fetching single objects (faulting), that respects the asof_trans_id. The stored procedure finds the right object for that asof_trans_id. For instance, if I have a fault:

AudOrder oid = 72, asof_trans_id = 155

the stored proc first checks to see if the trans_id of the primary Order table is less than 155. If it is, then this object hasn't changed since trans_id 155, and the primary row is returned (but an AudOrder object is still the object created). If not, we find the audit row who's trans_id is less than or equal to 155. If none exists, the fault fails.

In the AudOrder entity, you can decide whether to override existing relationships (like items) to be from audits, or for reference data, you could just keep the original relationship. For to-many audit relationships, you need another stored proc that will build the unique set, and the asof_trans_id value has to travel along (part of the relationship keys). So, the items relationship would be replaced with an items relationship to AudItem. The stored procedure would build a result set that includes all the items ASOF trans_id 155 (a union between the primary table and the audit table).

Primary entities have a method called 'auditObjects' that goes out and gets all the historical versions of an object.


OK - NOW, you have the ability to say:

I have this order EO. Give me the top 10 historical versions...

You'll get an array of 10 AudOrder objects, which you can present to the user.

You can display the date/time of the transaction record that the audit is related to, so the user can pick the version of history they want.

Now that the user has selected an AudOrder object, when you fire the items to-many fault, it runs the stored proc that builds the union of unique objects that existed asof trans_id 155.

You can keep going and going, faulting more historical objects over time.

Cool, huh?


One important bit that I left out....

Depending on the database you're using, it might be difficult for the delete triggers to easily know the current transaction to update the responsible transaction ID (since on deletes, we're obviously not sending data). In Oracle, I use a trigger on the transaction table to update a temporary table that has a lifetime of just the current transaction. The insert trigger on the transaction table inserts a row into the temporary table with the OID of the new transaction, and the delete triggers read from that table to know the responsible trans ID.