system.user.removeRole
This function is used in Python Scripting.
Description​
Removes a role from the specified user source. When altering the Gateway System User Source, the Allow User Admin setting must be enabled.
Client Permission Restrictions​
Permission Type: User Management
Client access to this scripting function is blocked to users that do not meet the role/zone requirements for the above permission type. This function is unaffected when run in the Gateway scope.
Syntax​
system.user.removeRole(userSource, role)
Parameters​
| Type | Parameter | Description |
|---|---|---|
| String | userSource | The user source in which the role is found. Blank will use the default user source. |
| String | role | The role to remove. The role must exist. |
Returns​
UIResponse - A list of UIResponse objects with lists of warnings, errors, and info about the success or failure of the deletion. The contents of the lists are accessible from the getter methods.
getWarns()- Returns a list of warning messages that were encountered during the deletion.getErrors()- Returns a list of error messages that were encountered during the deletion.getInfos()- Returns a list of "info" messages that were encountered during the deletion.
These messages represent normal logging events that occurred during the deletion, and can be useful when trying to visualize the events that lead up to a failure.
Scope​
Gateway, Vision Client, Perspective Session
Code Examples​
# Removes the role "User" in the user source "MyUserSource".
system.user.removeRole("MyUserSource", "User")