IRoleService.AddRole Method (Role)

IRoleService AddRole Method (Role)

CelloSaaS API Documentation

Adds a new role to the system.

Namespace: CelloSaaS.ServiceContracts.AccessControlManagement
Assembly: CelloSaaS.ServiceContracts (in CelloSaaS.ServiceContracts.dll) Version: 4.3.1.0 (4.3.1.0)

Syntax

C++

Copy to Clipboard Print

string AddRole(
	Role roleDetails
)

string AddRole(
	Role roleDetails
)

Function AddRole ( 
	roleDetails As Role
) As String

Function AddRole ( 
	roleDetails As Role
) As String

abstract AddRole : 
        roleDetails : Role -> string

abstract AddRole : 
        roleDetails : Role -> string

Parameters

roleDetails: Type: CelloSaaS.Model.AccessControlManagement Role
Role Details(Mandatory - Role Name)

Return Value

Type: String
Inserted Role Id

Exceptions

Exception	Condition
System.Data DataException	If the role name is duplicate
CelloSaaS.ServiceContracts.AccessControlManagement RoleException	If pre or post processor was not inserted.
System ArgumentNullException	If role name or description is null or empty.
System ArgumentException	If role details is null

Examples

Copy to Clipboard Print

public void AddRole()
{  
   Role roleDetails = new Role();
   roleDetails.TenantId = "B590CD25-3093-DF11-8DEB-001EC9DAB123";
   roleDetails.RoleName = "Tenant_Admin";        
   roleDetails.Description = "Tenant Admin Role";  
   IRoleService roleService = ServiceLocator.Resolve>IRoleService<();
   string roleId = roleService.AddRole(roleDetails);
}

public void AddRole()
{  
   Role roleDetails = new Role();
   roleDetails.TenantId = "B590CD25-3093-DF11-8DEB-001EC9DAB123";
   roleDetails.RoleName = "Tenant_Admin";        
   roleDetails.Description = "Tenant Admin Role";  
   IRoleService roleService = ServiceLocator.Resolve>IRoleService<();
   string roleId = roleService.AddRole(roleDetails);
}