Interface RecordsManagementAuditService
- All Superinterfaces:
RecordsManagementAuditServiceDeprecated
- All Known Implementing Classes:
RecordsManagementAuditServiceImpl
- Author:
- Gavin Cornwell
-
Nested Class Summary
Nested Classes -
Method Summary
Modifier and TypeMethodDescriptionvoid
auditEvent
(NodeRef nodeRef, String eventName) Audits an event, assumes no properties where modified and that the event should not be audited immediately.void
auditEvent
(NodeRef nodeRef, String eventName, Map<QName, Serializable> before, Map<QName, Serializable> after) Audits an event, assumes that the event should not be audited immediately and not be removed if no property is changed.void
auditEvent
(NodeRef nodeRef, String eventName, Map<QName, Serializable> before, Map<QName, Serializable> after, boolean immediate) Audit event, assumes not to be removed if no property is changed.void
auditEvent
(NodeRef nodeRef, String eventName, Map<QName, Serializable> before, Map<QName, Serializable> after, boolean immediate, boolean removeIfNoPropertyChanged) Audit event.void
auditOrUpdateEvent
(NodeRef nodeRef, String eventName, Map<QName, Serializable> before, Map<QName, Serializable> after, boolean removeIfNoPropertyChanged) Supply incremental changes as part of an event.void
clearAuditLog
(NodeRef filePlan) Clears the RM audit.fileAuditTrailAsRecord
(RecordsManagementAuditQueryParameters params, NodeRef destination, RecordsManagementAuditService.ReportFormat format) Retrieves a list of audit log entries using the provided parameters represented by the RecordsManagementAuditQueryParameters instance and then files the resulting log as an undeclared record in the record folder represented by the given NodeRef.Retrieves a list of audit events.Retrieves a list of audit log entries using the provided parameters represented by the RecordsManagementAuditQueryParameters instance.getAuditTrailFile
(RecordsManagementAuditQueryParameters params, RecordsManagementAuditService.ReportFormat format) Retrieves a list of audit log entries using the provided parameters represented by the RecordsManagementAuditQueryParameters instance.getDateAuditLogLastStarted
(NodeRef filePlan) Returns the date the RM audit was last started.getDateAuditLogLastStopped
(NodeRef filePlan) Returns the date the RM audit was last stopped.boolean
isAuditLogEnabled
(NodeRef filePlan) Determines whether the RM audit log is currently enabled.void
registerAuditEvent
(String name, String label) Register audit event.void
registerAuditEvent
(AuditEvent auditEvent) Register audit event.void
startAuditLog
(NodeRef filePlan) Start RM auditing.void
stopAuditLog
(NodeRef filePlan) Stop RM auditing.Methods inherited from interface org.alfresco.module.org_alfresco_module_rm.audit.RecordsManagementAuditServiceDeprecated
auditRMAction, clear, getDateLastStarted, getDateLastStopped, isEnabled, stop
-
Method Details
-
getAuditEvents
List<AuditEvent> getAuditEvents()Retrieves a list of audit events.- Returns:
- List of audit events
-
registerAuditEvent
Register audit event.Creates an instance of a simple audit event and registers it with the service.
- Parameters:
name
- name of audit eventlabel
- display label of audit event
-
registerAuditEvent
Register audit event.- Parameters:
auditEvent
- audit event
-
auditEvent
Audits an event, assumes no properties where modified and that the event should not be audited immediately.- Parameters:
nodeRef
- node referenceeventName
- event name
-
auditEvent
void auditEvent(NodeRef nodeRef, String eventName, Map<QName, Serializable> before, Map<QName, Serializable> after) Audits an event, assumes that the event should not be audited immediately and not be removed if no property is changed.- Parameters:
nodeRef
- node referenceeventName
- event namebefore
- property values before event (this must be modifiable and may be changed by the method).after
- property values after event (this must be modifiable and may be changed by the method).
-
auditEvent
void auditEvent(NodeRef nodeRef, String eventName, Map<QName, Serializable> before, Map<QName, Serializable> after, boolean immediate) Audit event, assumes not to be removed if no property is changed.- Parameters:
nodeRef
- node referenceeventName
- event namebefore
- property values before event (this must be modifiable and may be changed by the method).after
- property values after event (this must be modifiable and may be changed by the method).immediate
- true if event is to be audited immediately, false otherwise
-
auditEvent
void auditEvent(NodeRef nodeRef, String eventName, Map<QName, Serializable> before, Map<QName, Serializable> after, boolean immediate, boolean removeIfNoPropertyChanged) Audit event.- Parameters:
nodeRef
- node referenceeventName
- event namebefore
- property values before event (this must be modifiable and may be changed by the method).after
- property values after event (this must be modifiable and may be changed by the method).immediate
- true if event is to be audited immediately, false otherwiseremoveIfNoPropertyChanged
- true if event is not audited when there are no properties changed, false otherwise
-
auditOrUpdateEvent
void auditOrUpdateEvent(NodeRef nodeRef, String eventName, Map<QName, Serializable> before, Map<QName, Serializable> after, boolean removeIfNoPropertyChanged) Supply incremental changes as part of an event. This will either create a new event or update the existing details to put any supplied properties into the map.- Parameters:
nodeRef
- node referenceeventName
- event namebefore
- additional property values before event (this must be modifiable and may be changed by the method).after
- additional property values after event (this must be modifiable and may be changed by the method).removeIfNoPropertyChanged
- true if event is not audited when there are no properties changed, false otherwise
-
isAuditLogEnabled
Determines whether the RM audit log is currently enabled.- Parameters:
filePlan
- file plan- Returns:
- true if RM auditing is active false otherwise
-
startAuditLog
Start RM auditing.- Parameters:
filePlan
- file plan
-
stopAuditLog
Stop RM auditing.- Parameters:
filePlan
- file plan
-
clearAuditLog
Clears the RM audit.- Parameters:
filePlan
- file plan
-
getDateAuditLogLastStarted
Returns the date the RM audit was last started.- Parameters:
filePlan
- file plan- Returns:
- Date the audit was last started
-
getDateAuditLogLastStopped
Returns the date the RM audit was last stopped.- Returns:
- Date the audit was last stopped
-
getAuditTrailFile
File getAuditTrailFile(RecordsManagementAuditQueryParameters params, RecordsManagementAuditService.ReportFormat format) Retrieves a list of audit log entries using the provided parameters represented by the RecordsManagementAuditQueryParameters instance.The parameters are all optional so an empty RecordsManagementAuditQueryParameters object will result in ALL audit log entries for the RM system being returned. Setting the various parameters effectively filters the full audit trail.
- Parameters:
params
- Parameters to use to retrieve audit trail (never null)format
- The format the report should be produced in- Returns:
- File containing JSON representation of audit trail
-
getAuditTrail
Retrieves a list of audit log entries using the provided parameters represented by the RecordsManagementAuditQueryParameters instance.The parameters are all optional so an empty RecordsManagementAuditQueryParameters object will result in ALL audit log entries for the RM system being returned. Setting the various parameters effectively filters the full audit trail.
- Parameters:
params
- Parameters to use to retrieve audit trail (never null)- Returns:
- All entries for the audit trail
-
fileAuditTrailAsRecord
NodeRef fileAuditTrailAsRecord(RecordsManagementAuditQueryParameters params, NodeRef destination, RecordsManagementAuditService.ReportFormat format) Retrieves a list of audit log entries using the provided parameters represented by the RecordsManagementAuditQueryParameters instance and then files the resulting log as an undeclared record in the record folder represented by the given NodeRef.The parameters are all optional so an empty RecordsManagementAuditQueryParameters object will result in ALL audit log entries for the RM system being returned. Setting the various parameters effectively filters the full audit trail.
- Parameters:
params
- Parameters to use to retrieve audit trail (never null)destination
- NodeRef representing a record folder in which to file the audit logformat
- The format the report should be produced in- Returns:
- NodeRef of the undeclared record filed
-