Interface IUsersClient

Client for fetching user entities and user related actions.

Namespace: Stylelabs.M.Sdk.Clients

Assembly: Stylelabs.M.Sdk.dll

Syntax

public interface IUsersClient

Methods

GetUserAsync(Int64, IEntityLoadConfiguration)

Gets the specified user entity.

Declaration

Task<IEntity> GetUserAsync(long id, IEntityLoadConfiguration loadConfiguration = null)

Parameters

Type	Name	Description
System.Int64	id	The id of the user.
IEntityLoadConfiguration	loadConfiguration	The load configuration.

Returns

Type	Description
Task<IEntity>	The user entity or null when it was not found.

GetUserAsync(String, IEntityLoadConfiguration)

Gets the specified user entity.

Declaration

Task<IEntity> GetUserAsync(string username, IEntityLoadConfiguration loadConfiguration = null)

Parameters

Type	Name	Description
System.String	username	Username of the user.
IEntityLoadConfiguration	loadConfiguration	The load configuration.

Returns

Type	Description
Task<IEntity>	The user or null when it was not found.

GetUserGroupAsync(Int64, IEntityLoadConfiguration)

Gets the specified user group entity.

Declaration

Task<IEntity> GetUserGroupAsync(long id, IEntityLoadConfiguration loadConfiguration = null)

Parameters

Type	Name	Description
System.Int64	id	Id of the user.
IEntityLoadConfiguration	loadConfiguration	The load configuration.

Returns

Type	Description
Task<IEntity>	The user or null when it was not found.

GetUserGroupAsync(String, IEntityLoadConfiguration)

Gets the user group by the specified name.

Declaration

Task<IEntity> GetUserGroupAsync(string groupName, IEntityLoadConfiguration loadConfiguration = null)

Parameters

Type	Name	Description
System.String	groupName	Name of the group.
IEntityLoadConfiguration	loadConfiguration	The loading configuration.

Returns

Type	Description
Task<IEntity>	The user group entity or null when it was not found.

GetUserGroupIdAsync(String)

Gets the ids of the specified user groups by name.

Declaration

Task<long?> GetUserGroupIdAsync(string groupName)

Parameters

Type	Name	Description
System.String	groupName	The groupName name.

Returns

Type	Description
Task<System.Nullable<System.Int64>>	The group's id or null when it was not found.

GetUserGroupIdsAsync(IEnumerable<String>)

Gets the ids of the specified user groups by name.

Declaration

Task<IDictionary<string, long>> GetUserGroupIdsAsync(IEnumerable<string> groupNames)

Parameters

Type	Name	Description
IEnumerable<System.String>	groupNames	A list of group names.

Returns

Type	Description
Task<IDictionary<System.String, System.Int64>>	Non null, case-insensitive dictionary that maps the user group names to ids. Users that don't exist, will not be in the result.

GetUserGroupNameAsync(Int64)

Gets the name of the specified user group.

Declaration

Task<string> GetUserGroupNameAsync(long id)

Parameters

Type	Name	Description
System.Int64	id	The id of the user group.

Returns

Type	Description
Task<System.String>	The group name or null when it was not found.

GetUserGroupNamesAsync(IEnumerable<Int64>)

Gets the name of the specified user groups.

Declaration

Task<IDictionary<long, string>> GetUserGroupNamesAsync(IEnumerable<long> ids)

Parameters

Type	Name	Description
IEnumerable<System.Int64>	ids	The ids of user groups.

Returns

Type	Description
Task<IDictionary<System.Int64, System.String>>	Non null dictionary that maps the user group ids to user group names. Users that don't exist, will not be in the result.

GetUserGroupsAsync(IEnumerable<Int64>, IEntityLoadConfiguration)

Gets the specified user group entities.

Declaration

Task<IList<IEntity>> GetUserGroupsAsync(IEnumerable<long> ids, IEntityLoadConfiguration loadConfiguration = null)

Parameters

Type	Name	Description
IEnumerable<System.Int64>	ids	The ids of the user groups.
IEntityLoadConfiguration	loadConfiguration	The load configuration.

Returns

Type	Description
Task<IList<IEntity>>	The user group entities. Can contain null when a user group was not found.

GetUserGroupsAsync(IEnumerable<String>, IEntityLoadConfiguration)

Gets the specified user group entities.

Declaration

Task<IList<IEntity>> GetUserGroupsAsync(IEnumerable<string> groupNames, IEntityLoadConfiguration loadConfiguration = null)

Parameters

Type	Name	Description
IEnumerable<System.String>	groupNames	The names of the user groups.
IEntityLoadConfiguration	loadConfiguration	The load configuration.

Returns

Type	Description
Task<IList<IEntity>>	The user group entities. Can contain null when a user group was not found.

GetUserIdAsync(String)

Gets the id of the specified user by username.

Declaration

Task<long?> GetUserIdAsync(string username)

Parameters

Type	Name	Description
System.String	username	The user name.

Returns

Type	Description
Task<System.Nullable<System.Int64>>	The user's id or null when it was not found.

GetUserIdsAsync(IEnumerable<String>)

Gets the ids of the specified users by username.

Declaration

Task<IDictionary<string, long>> GetUserIdsAsync(IEnumerable<string> usernames)

Parameters

Type	Name	Description
IEnumerable<System.String>	usernames	A list of user names.

Returns

Type	Description
Task<IDictionary<System.String, System.Int64>>	Non null, case-insensitive dictionary that maps the user names to ids. Users that don't exist, will not be in the result.

GetUsernameAsync(Int64)

Gets the username of the specified user.

Declaration

Task<string> GetUsernameAsync(long id)

Parameters

Type	Name	Description
System.Int64	id	The id of the user.

Returns

Type	Description
Task<System.String>	The username or null when it was not found.

GetUsernamesAsync(IEnumerable<Int64>)

Gets the usernames of the specified users.

Declaration

Task<IDictionary<long, string>> GetUsernamesAsync(IEnumerable<long> ids)

Parameters

Type	Name	Description
IEnumerable<System.Int64>	ids	The ids of the entities to get.

Returns

Type	Description
Task<IDictionary<System.Int64, System.String>>	Non null dictionary that maps the user ids to usernames. Users that don't exist, will not be in the result.

GetUsersAsync(IEnumerable<Int64>, IEntityLoadConfiguration)

Gets the specified user entities.

Declaration

Task<IList<IEntity>> GetUsersAsync(IEnumerable<long> ids, IEntityLoadConfiguration loadConfiguration = null)

Parameters

Type	Name	Description
IEnumerable<System.Int64>	ids
IEntityLoadConfiguration	loadConfiguration	The load configuration.

Returns

Type	Description
Task<IList<IEntity>>	The user entities. Can contain null when a user was not found.

GetUsersAsync(IEnumerable<String>, IEntityLoadConfiguration)

Gets the specified user entities.

Declaration

Task<IList<IEntity>> GetUsersAsync(IEnumerable<string> usernames, IEntityLoadConfiguration loadConfiguration = null)

Parameters

Type	Name	Description
IEnumerable<System.String>	usernames	A list of user names.
IEntityLoadConfiguration	loadConfiguration	The load configuration.

Returns

Type	Description
Task<IList<IEntity>>	The user entities. Can contain null when a user was not found.

ResetPasswordAsync(Int64)

Resets the password of the specified user. This sends an e-mail to the specified user with a link to choose a new password.

Declaration

Task ResetPasswordAsync(long id)

Parameters

Type	Name	Description
System.Int64	id	Id of the user

Returns

Type	Description
Task	A representing the asynchronous operation.

Exceptions

Type	Condition
ForbiddenException	When the current user is not a superuser.

SetPasswordAsync(Int64, String)

Changes the password of the specified user.

Declaration

Task SetPasswordAsync(long id, string password)

Parameters

Type	Name	Description
System.Int64	id	The user id to change the password on.
System.String	password	The password to reset.

Returns

Type	Description
Task	A representing the asynchronous operation.

Exceptions

Type	Condition
ForbiddenException	When the current user is not a superuser.

Can we improve this article ? Provide feedback