system.mes.role.saveRole

Description

Creates or updates a Role record in the system based on the provided parameters.

Syntax

system.mes.role.saveRole(**roleData)

Parameters

Parameter	Type	Nullable	Description
id	String (ULID)	True	The ULID of the role (optional, used for updating an existing role).
enabled	Boolean	True	Indicates if the role is active and enabled.
notes	String	True	Notes related to the role.
spare1	String	True	Additional field for user-defined context.
spare2	String	True	Additional field for user-defined context.
spare3	String	True	Additional field for user-defined context.
securityLevels	List<String>	False	List of Ignition security levels required for this role.
permissions	List<String>	False	List of MES permissions granted by this role.
roleRequirementType	Enum	False	Specifies if all or any security levels are required to grant permissions. See RoleRequirementType enum.

Returns

Returns a JSON representation of the saved role.

Code Examples

# Generate the object structure for a new role object, set the initial arguments and save it
role = system.mes.role.newRole()
role['securityLevels'] = ['Authenticated/Roles/Administrator']
role['permissions'] = ['MATERIALS.WRITE', 'INVENTORY.READ']
role['roleRequirementType'] = 'ALL_OF'
savedRole = system.mes.role.saveRole(**role)

# Output the JSON representation of the saved role
print(savedRole)