View Source

Class UserStartNodeEntitiesService

Inheritance

System.Object

Namespace: Umbraco.Cms.Api.Management.Services.Entities

Assembly: Umbraco.Cms.Api.Management.dll

Syntax

public class UserStartNodeEntitiesService : IUserStartNodeEntitiesService

Constructors

UserStartNodeEntitiesService(IEntityService)

Declaration

public UserStartNodeEntitiesService(IEntityService entityService)

Parameters

Type	Name	Description
IEntityService	entityService

UserStartNodeEntitiesService(IEntityService, ICoreScopeProvider, IIdKeyMap)

Declaration

public UserStartNodeEntitiesService(IEntityService entityService, ICoreScopeProvider scopeProvider, IIdKeyMap idKeyMap)

Parameters

Type	Name	Description
IEntityService	entityService
ICoreScopeProvider	scopeProvider
IIdKeyMap	idKeyMap

Methods

ChildUserAccessEntities(IEnumerable<IEntitySlim>, String[])

Calculates the applicable child entities from a list of candidate child entities for users without root access.

Declaration

public IEnumerable<UserAccessEntity> ChildUserAccessEntities(IEnumerable<IEntitySlim> candidateChildren, string[] userStartNodePaths)

Parameters

Type	Name	Description
IEnumerable<IEntitySlim>	candidateChildren	The candidate child entities to filter (i.e. entities fetched with ).
System.String[]	userStartNodePaths	The calculated start node paths for the user.

Returns

Type	Description
IEnumerable<UserAccessEntity>	A list of child entities applicable entities for the user.

Remarks

The returned entities may include entities that outside of the user start node scope, but are needed to for browsing to the actual user start nodes. These entities will be marked as "no access" entities. Some candidate entities may be filtered out if they are not applicable for the user scope.

ChildUserAccessEntities(UmbracoObjectTypes, String[], Guid, Int32, Int32, Ordering, out Int64)

Declaration

public IEnumerable<UserAccessEntity> ChildUserAccessEntities(UmbracoObjectTypes umbracoObjectType, string[] userStartNodePaths, Guid parentKey, int skip, int take, Ordering ordering, out long totalItems)

Parameters

Type	Name	Description
UmbracoObjectTypes	umbracoObjectType
System.String[]	userStartNodePaths
Guid	parentKey
System.Int32	skip
System.Int32	take
Ordering	ordering
System.Int64	totalItems

Returns

Type	Description
IEnumerable<UserAccessEntity>

RootUserAccessEntities(UmbracoObjectTypes, Int32[])

Calculates the applicable root entities for a given object type for users without root access.

Declaration

public IEnumerable<UserAccessEntity> RootUserAccessEntities(UmbracoObjectTypes umbracoObjectType, int[] userStartNodeIds)

Parameters

Type	Name	Description
UmbracoObjectTypes	umbracoObjectType	The object type.
System.Int32[]	userStartNodeIds	The calculated start node IDs for the user.

Returns

Type	Description
IEnumerable<UserAccessEntity>	A list of root entities for the user.

Remarks

The returned entities may include entities that outside of the user start node scope, but are needed to for browsing to the actual user start nodes. These entities will be marked as "no access" entities.

This method does not support pagination, because it must load all entities explicitly in order to calculate the correct result, given that user start nodes can be descendants of root nodes. Consumers need to apply pagination to the result if applicable.

UserAccessEntities(IEnumerable<IEntitySlim>, String[])

Calculates the access level of a collection of entities for users without root access.

Declaration

public IEnumerable<UserAccessEntity> UserAccessEntities(IEnumerable<IEntitySlim> entities, string[] userStartNodePaths)

Parameters

Type	Name	Description
IEnumerable<IEntitySlim>	entities	The entities.
System.String[]	userStartNodePaths	The calculated start node paths for the user.

Returns

Type	Description
IEnumerable<UserAccessEntity>	The access level for each entity.