...
| Page Properties | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
Everything within this section is only visible while editing. Use status for "stub" (red) "progress" (yellow) "review" (blue) and "refactor" (grey). Everything contained within the table is displayed in the (INTERNAL) Reports page.
Resources
Cleanup of the Audit Trail It is possible to delete old audit trail entries by means of the | ||||||||||||||||
| Parameter | Description | |||||||||||||||
defaultCleanupAfterDays | An Integer default value for the cleanupAfterDays parameter. It is valid for any action that is not listed in actions. | actions |
Needs to be moved to the Document Lifecycle page as subpage - if the DLM page is ready to get published| Parameter | Description |
|---|---|
comment | An optional String parameter for the purpose of help. The value is arbitrary and is not evaluated in the Commander service. |
action | The Integer Core API code specifying the audit trail entry type. Only existing values are considered. Not existing values lead to ignoring of the mapping element. |
cleanupAfterDays | The Integer minimum age of audit trail entries with the history code Only values >= 0 are valid. If a negative value is set, audit trail entries of the corresponding type will be never deleted. |
In the example configuration below, the defaultCleanupAfterDays parameter implies that all audit trail entries can be deleted after 10 days, if not further specified in actions. However, two mappings are listed in actions overwriting the defaultCleanupAfterDays value for two audit trail entry types. The entries of Core API type 100 have do stay forever and will be never deleted. The entries of Core API type 400 can be deleted already after 1 day. The parameter comment, in this example, contains the indication constant of the audit trail entry type.
| Code Block | ||||
|---|---|---|---|---|
| ||||
{
"audit": {
"defaultCleanupAfterDays": 10,
"actions": [
{
"comment": "OBJECT_CREATED",
"action": 100,
"cleanupAfterDays": -1
},
{
"comment": "DOCUMENT_ACCESSED",
"action": 400,
"cleanupAfterDays": 1
}
]
}
} |
When the lifetime of the audit trail entries is exceeded, they are not automatically deleted. The deletion of entries takes place only as a result of the execution of the audit cleanup command in the Commander service AND if the specified lifetime is exceeded. When executed, the command reads the cleanupConfiguration.json file. If the file does not exist, the defaultCleanupAfterDays value is set to -1 and thus no entry will be deleted from the audit trail.
To the audit cleanup command, two parameters can be given:
audit cleanup -haudit cleanup -t default
(with the example tenant default)- Antje: Cleanup Section moved to Commander tooling page
For a cleanup the audit trail, the commander service can be used as a tool to remove audit trail entries.
>>> Cleanup of the Audit Trail
| Excerpt | ||
|---|---|---|
| ||
The audit trail is the history protocol of an object, serving to document its total lifecycle. There are many different actions that trigger the creation of a new entry in the respective object's audit trail. |
...