system.user.editRole

This feature is new in Ignition version 7.9.5
Click here to check out the other new features

This function is used in Python Scripting.

Description

Renames a role in 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.editRole(userSource, oldName, newName)

Parameters

String userSource - The user source in which the role is found. Blank will use the default user source.

String oldName - The role to edit. Role must not be blank and must exist.

String newName - The new name for the role. Must not be blank.

Returns

UIResponse - an object with lists of warnings, errors, and info about the success or failure of the edit.

Scope

All

Code Examples

Code Snippet

# This example edits the role "Operator" in the user source "MyUserSource" and edits it to the role "User".
system.user.editRole("MyUserSource", "Operator", "User")

Contents

Strategic Partner Links

Resources

All Manual Versions