Audit logging is often not appropriate at the very start of a project, but as the project matures and controlled evolution becomes appropriate, audit logging should be enabled.
The Clear Audit Logs command clears all change notations from the audit log for the specified elements. This command can be applied at many different levels enabling fine-grained control of audit logs. You will be prompted to confirm before the logs are cleared.
When the audit log for an element is cleared, a notation is made in the audit log capturing the current timestamp and the user who cleared the audit log.
As with versioning, audit logging is enabled or disabled at the project level. If disabled at the project level, the commands to clear audit logs will be disabled. Once enabled, audit logging maintains a basic textual log of all changes made along with the timestamp and the responsible user. These are stored in a read-only auditLog attribute on the secondary tab of the property sheet. Combined with the highly detailed attribute versioning and the project comparison reports, audit logs provide insight into the evolution of an element.
| |
Audit logging is often not appropriate at the very start of a project, but as the project matures and controlled evolution becomes appropriate, audit logging should be enabled. |
| |
Audit logs are limited to 30KB per attribute. When an audit log exceeds this size, it is automatically trimmed to 16KB. This maintains visibility into the change history of the element while balancing database growth for those project teams using automated scripts that frequently revise / rebuild database content. |
To clear the audit log for one or more elements, select the desired elements from the element list in the project explorer. Right-click to access the pop-up menu and select the Clear Audit Logs command from the Manage submenu. You must have administrator privileges for the selected elements in order to clear the audit logs.
To clear the audit logs for all elements in a folder, select the desired folder from the project pane in the project explorer. Right-click to access the pop-up menu and select the Clear Audit Logs command from the Manage submenu. You must have administrator privileges for all elements within the folder.
Clearing audit logs at the folder level will clear audit logs for all elements included in the folder and all subfolders.
To clear the audit logs for all elements in a package, select the desired package from the project pane in the project explorer. Right-click to access the pop-up menu and select the Clear Audit Logs command from the Manage submenu. You must have administrator privileges for all elements within the package.
Clearing audit logs at the package level will clear audit logs for all elements included in the package and all subpackages.
To clear the audit logs for all elements in a project, you may use the project explorer or the administrative tools. From the project explorer, select the Clear Audit Logs command from the Manage submenu on the Project menu. From the administrative tools, select the project in the projects pane and select the Clear Audit Logs command from the Project menu. You must have administrator privileges for the project.