Click or drag to resize

UserSecurityServicesCreateRole Method

Create a new security role that may be later assigned to users and user groups.

Namespace:  FactoryLogix.xTend.Configuration
Assembly:  FactoryLogix.xTend.API (in FactoryLogix.xTend.API.dll) Version: 8.242.0.0 (8.242.0.0)
Syntax
Copy
public Role CreateRole(
	Guid sessionId,
	Role newRole
)

Parameters

sessionId
Type: SystemGuid
The session identifier that was returned by the Connect(String, String, String, String, String) method.
newRole
Type: FactoryLogix.xTend.DataObjectsRole
The new Role object to be created. The Name property must supply a unique friendly for the new Role

Return Value

Type: Role
A Role object representing the newly created security role, with a valid Id parameter supplied that may be used for susequent updates and other method calls
Exceptions
ExceptionCondition
InvalidSessionExceptionThrown if the sessionId parameter is invalid.
NotAuthorizedExceptionOccurs if the current user is not authorized to use this feature.
ArgumentExceptionOccurs if any of the parameters are invalid.
AlreadyExistsExceptionThrown if the Name specified in the Role object already exists.
NotAuthorizedExceptionThrown when not authorized to perform the function.
See Also