Last Updated Field

This feature is similar to the Audit Mappings feature. It is a field which can be added to database tables to contain extra information about the modification time of each record for reporting purposes.

The feature is only available for entity classes and it is updated only by certain entity operations

Switching on the last updated field functionality for an entity has the following effects:

A field called lastWritten of type SVR_DATETIME is automatically added to the entity.
The Cúram infrastructure automatically populates this field with the current time whenever the record is written to the database - unless the write was performed by an ns operation.

The following steps must be taken to avail of this feature:

To turn on the feature for an individual entity class the Last_Updated_Field property in the Rational Software Architect Cúram Properties tab must be set to '1 - yes' using the supplied drop-down.
To turn on the feature for all of the entities for a particular application, the following text must be appended to the extra.generator.options property in the Bootstrap.properties file as follows:
Figure 1. extra.generator.options property in Bootstrap.properties
```
extra.generator.options=-defaultoption class_lastupdatedfield=yes
```
extra.generator.options=-defaultoption class_lastupdatedfield=yes
A new domain definition must be specified in the model as follows:
- Domain Definition Name: LAST_UPDATED
- Domain Definition Type: SVR_DATETIME

Invoking operations with the following stereotypes cause the lastWritten field to be set:

insert;
nsinsert;
modify;
nkmodify;
nsmodify.
batchinsert.
batchmodify.

Note: Unlike the version number field utilized for the optimistic locking feature, there is no requirement to add the last written field to structures involved in non-standard insert and modify operations. If the last updated field feature has been enabled for an entity, this field is always updated for the operation stereotypes listed above by the infrastructure data access code regardless of whether the field is present in the structure being used.