View Source

Class AuditService

Inheritance

System.Object

RepositoryService

Namespace: Umbraco.Cms.Core.Services.Implement

Assembly: Umbraco.Core.dll

Syntax

public sealed class AuditService : RepositoryService, IAuditService, IService

Constructors

AuditService(ICoreScopeProvider, ILoggerFactory, IEventMessagesFactory, IAuditRepository, IAuditEntryRepository, IUserService, IEntityRepository)

Declaration

public AuditService(ICoreScopeProvider provider, ILoggerFactory loggerFactory, IEventMessagesFactory eventMessagesFactory, IAuditRepository auditRepository, IAuditEntryRepository auditEntryRepository, IUserService userService, IEntityRepository entityRepository)

Parameters

Type	Name	Description
ICoreScopeProvider	provider
ILoggerFactory	loggerFactory
IEventMessagesFactory	eventMessagesFactory
IAuditRepository	auditRepository
IAuditEntryRepository	auditEntryRepository
IUserService	userService
IEntityRepository	entityRepository

AuditService(ICoreScopeProvider, ILoggerFactory, IEventMessagesFactory, IAuditRepository, IAuditEntryRepository, IUserService, IEntityRepository, IEntityService)

Declaration

public AuditService(ICoreScopeProvider provider, ILoggerFactory loggerFactory, IEventMessagesFactory eventMessagesFactory, IAuditRepository auditRepository, IAuditEntryRepository auditEntryRepository, IUserService userService, IEntityRepository entityRepository, IEntityService entityService)

Parameters

Type	Name	Description
ICoreScopeProvider	provider
ILoggerFactory	loggerFactory
IEventMessagesFactory	eventMessagesFactory
IAuditRepository	auditRepository
IAuditEntryRepository	auditEntryRepository
IUserService	userService
IEntityRepository	entityRepository
IEntityService	entityService

AuditService(ICoreScopeProvider, ILoggerFactory, IEventMessagesFactory, IAuditRepository, IAuditEntryRepository, IUserService, IEntityService)

Declaration

public AuditService(ICoreScopeProvider provider, ILoggerFactory loggerFactory, IEventMessagesFactory eventMessagesFactory, IAuditRepository auditRepository, IAuditEntryRepository auditEntryRepository, IUserService userService, IEntityService entityService)

Parameters

Type	Name	Description
ICoreScopeProvider	provider
ILoggerFactory	loggerFactory
IEventMessagesFactory	eventMessagesFactory
IAuditRepository	auditRepository
IAuditEntryRepository	auditEntryRepository
IUserService	userService
IEntityService	entityService

Methods

Add(AuditType, Int32, Int32, String, String, String)

Declaration

public void Add(AuditType type, int userId, int objectId, string entityType, string comment, string parameters = null)

Parameters

Type	Name	Description
AuditType	type
System.Int32	userId
System.Int32	objectId
System.String	entityType
System.String	comment
System.String	parameters

CleanLogs(Int32)

Declaration

public void CleanLogs(int maximumAgeOfLogsInMinutes)

Parameters

Type	Name	Description
System.Int32	maximumAgeOfLogsInMinutes

GetItemsByKeyAsync(Guid, UmbracoObjectTypes, Int32, Int32, Direction, Nullable<DateTimeOffset>, AuditType[])

Declaration

public async Task<PagedModel<IAuditItem>> GetItemsByKeyAsync(Guid entityKey, UmbracoObjectTypes entityType, int skip, int take, Direction orderDirection = Direction.Descending, DateTimeOffset? sinceDate = null, AuditType[] auditTypeFilter = null)

Parameters

Type	Name	Description
Guid	entityKey
UmbracoObjectTypes	entityType
System.Int32	skip
System.Int32	take
Direction	orderDirection
System.Nullable<DateTimeOffset>	sinceDate
AuditType[]	auditTypeFilter

Returns

Type	Description
Task<PagedModel<IAuditItem>>

GetLogs(Int32)

Declaration

public IEnumerable<IAuditItem> GetLogs(int objectId)

Parameters

Type	Name	Description
System.Int32	objectId

Returns

Type	Description
IEnumerable<IAuditItem>

GetLogs(AuditType, Nullable<DateTime>)

Declaration

public IEnumerable<IAuditItem> GetLogs(AuditType type, DateTime? sinceDate = null)

Parameters

Type	Name	Description
AuditType	type
System.Nullable<DateTime>	sinceDate

Returns

Type	Description
IEnumerable<IAuditItem>

GetPagedItemsByEntity(Int32, Int64, Int32, out Int64, Direction, AuditType[], IQuery<IAuditItem>)

Returns paged items in the audit trail for a given entity

Declaration

public IEnumerable<IAuditItem> GetPagedItemsByEntity(int entityId, long pageIndex, int pageSize, out long totalRecords, Direction orderDirection = Direction.Descending, AuditType[] auditTypeFilter = null, IQuery<IAuditItem> customFilter = null)

Parameters

Type	Name	Description
System.Int32	entityId
System.Int64	pageIndex
System.Int32	pageSize
System.Int64	totalRecords
Direction	orderDirection	By default this will always be ordered descending (newest first)
AuditType[]	auditTypeFilter	Since we currently do not have enum support with our expression parser, we cannot query on AuditType in the query or the custom filter so we need to do that here
IQuery<IAuditItem>	customFilter	Optional filter to be applied

Returns

Type	Description
IEnumerable<IAuditItem>

GetPagedItemsByUser(Int32, Int64, Int32, out Int64, Direction, AuditType[], IQuery<IAuditItem>)

Returns paged items in the audit trail for a given user

Declaration

public IEnumerable<IAuditItem> GetPagedItemsByUser(int userId, long pageIndex, int pageSize, out long totalRecords, Direction orderDirection = Direction.Descending, AuditType[] auditTypeFilter = null, IQuery<IAuditItem> customFilter = null)

Parameters

Type	Name	Description
System.Int32	userId
System.Int64	pageIndex
System.Int32	pageSize
System.Int64	totalRecords
Direction	orderDirection	By default this will always be ordered descending (newest first)
AuditType[]	auditTypeFilter	Since we currently do not have enum support with our expression parser, we cannot query on AuditType in the query or the custom filter so we need to do that here
IQuery<IAuditItem>	customFilter	Optional filter to be applied

Returns

Type	Description
IEnumerable<IAuditItem>

GetPagedItemsByUserAsync(Guid, Int32, Int32, Direction, AuditType[], Nullable<DateTime>)

Declaration

public async Task<PagedModel<IAuditItem>> GetPagedItemsByUserAsync(Guid userKey, int skip, int take, Direction orderDirection = Direction.Descending, AuditType[] auditTypeFilter = null, DateTime? sinceDate = null)

Parameters

Type	Name	Description
Guid	userKey
System.Int32	skip
System.Int32	take
Direction	orderDirection
AuditType[]	auditTypeFilter
System.Nullable<DateTime>	sinceDate

Returns

Type	Description
Task<PagedModel<IAuditItem>>

GetUserLogs(Int32, AuditType, Nullable<DateTime>)

Declaration

public IEnumerable<IAuditItem> GetUserLogs(int userId, AuditType type, DateTime? sinceDate = null)

Parameters

Type	Name	Description
System.Int32	userId
AuditType	type
System.Nullable<DateTime>	sinceDate

Returns

Type	Description
IEnumerable<IAuditItem>

Write(Int32, String, String, DateTime, Int32, String, String, String)

Writes an audit entry for an audited event.

Declaration

public IAuditEntry Write(int performingUserId, string perfomingDetails, string performingIp, DateTime eventDateUtc, int affectedUserId, string affectedDetails, string eventType, string eventDetails)

Parameters

Type	Name	Description
System.Int32	performingUserId	The identifier of the user triggering the audited event.
System.String	perfomingDetails	Free-form details about the user triggering the audited event.
System.String	performingIp	The IP address or the request triggering the audited event.
DateTime	eventDateUtc	The date and time of the audited event.
System.Int32	affectedUserId	The identifier of the user affected by the audited event.
System.String	affectedDetails	Free-form details about the entity affected by the audited event.
System.String	eventType	The type of the audited event - must contain only alphanumeric chars and hyphens with forward slashes separating categories. The eventType will generally be formatted like: {application}/{entity-type}/{category}/{sub-category} Example: umbraco/user/sign-in/failed
System.String	eventDetails	Free-form details about the audited event.

Returns

Type	Description
IAuditEntry