Optional
realtime: RealtimeAssign role to user group.
Returns promise object that is resolved with the IRoleReference wrapped by IResult.
Example
const userGroupId: number = 1;
const roleResource: string = "[URL to the Role resource]";
(async () => {
const {data, res} = await userGroupService.addRoleToGroup(userGroupId, roleResource);
})();
When role is assigned to user, suitable audit record is created with type 'User' and activity 'User updated'.
User group's id or user group object.
Url to role resource or IRoleReference object.
Assign user to user group.
Returns promise object that is resolved with the IUserReference wrapped by IResult.
Example
const userGroupId: number = 1;
const userResource: string = "[URL to the User resource]";
(async () => {
const {data, res} = await userGroupService.addUserToGroup(userGroupId, userResource);
})();
When user is added to group, suitable audit record is created with type 'User' and activity 'User updated'.
User group's id or user group object.
Url to user resource or IUserReference object.
Creates a new user group.
Returns promise object that is resolved with the details of newly created user group.
Example
const userGroupObject: IUserGroup = {
name: "new user group"
};
(async () => {
const {data, res} = await userGroupService.create(userGroupObject);
})();
User Group object.
Removes user group.
Returns promise object that is resolved with the IResult of null.
Example
const userGroupId: number = 1;
(async () => {
const {data, res} = await userGroupService.delete(userGroupId);
})();
When group is removed, suitable audit records are created with type 'User' and activity 'User updated' with information that user has been removed from group.
Please, note that the ADMINS and DEVICES groups can not be deleted.
User group's id or user group object.
Gets the details of given user group.
Returns promise object that is resolved with the IUserGroup wrapped by IResult.
Example
const groupId: number = 1;
(async () => {
const {data, res} = await userGroupService.detail(roleId);
})();
Group's id or role object.
Gets the list of user groups filtered by parameters.
Returns promise object that is resolved with the IUserGroup wrapped by IResultList.
Example
const filter: object = {
severity: Severity.MAJOR,
pageSize: 100,
withTotalPages: true
};
(async () => {
const {data, res, paging} = await userGroupService.list(filter);
})();
Object containing filters for querying User Groups.
Unassign role from user
Returns promise object that is resolved with the IResult of null.
Example
const userGroupId: number = 1;
const userResource: string = "[URL to the Role resource]";
(async () => {
const {data, res} = await userGroupService.removeRoleFromGroup(userGroupId, userResource);
})();
User group's id or user group object.
Url to user resource or IRoleReference object.
Remove user from a group
Returns promise object that is resolved with the IResult of null.
Example
const userGroupId: number = 1;
const userResource: string = "[URL to the User resource]";
(async () => {
const {data, res} = await userGroupService.removeUserFromGroup(userGroupId, userResource);
})();
When user is removed from group, suitable audit record is created with type 'User' and activity 'User updated'.
User group's id or user group object.
Url to user resource or IUserReference object.
Updates user group data.
Returns promise object that is resolved with the saved user group object.
Example
const partialUpdateObject: Partial<IUserGroup> = {
"id" : 1,
"self" : "[URL to this resource]",
"name" : "PlatformAdministrators",
...
}
(async () => {
const {data, res} = await userGroupService.update(partialUpdateObject);
})();
User group is partially updatable.
Description
This service allows for managing user groups.