IRoleService.AddRole Method (String, String, String, String)

IRoleService AddRole Method (String, String, String, String)

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(
	string tenantCode,
	string roleName,
	string description,
	string roleQualifierQuery
)

string AddRole(
	string tenantCode,
	string roleName,
	string description,
	string roleQualifierQuery
)

Function AddRole ( 
	tenantCode As String,
	roleName As String,
	description As String,
	roleQualifierQuery As String
) As String

Function AddRole ( 
	tenantCode As String,
	roleName As String,
	description As String,
	roleQualifierQuery As String
) As String

abstract AddRole : 
        tenantCode : string * 
        roleName : string * 
        description : string * 
        roleQualifierQuery : string -> string

abstract AddRole : 
        tenantCode : string * 
        roleName : string * 
        description : string * 
        roleQualifierQuery : string -> string

Parameters

tenantCode: Type: System String
Tenant Code

roleName: Type: System String
Role Name(Mandatory)

description: Type: System String
Role Description

roleQualifierQuery: Type: System String
Qualifier Query (Obsolete)

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()
{   
   string tenantCode = "B590CD25-3093-DF11-8DEB-001EC9DAB123";
   string roleName = "Tenant_Admin";        
   string description = "Tenant Admin Role"; 
   string roleQualifierQuery = string.Empty;
   IRoleService roleService = ServiceLocator.Resolve>IRoleService<();
   string roleId = roleService.AddRole(tenantCode, roleName, description, roleQualifierQuery);
}

public void AddRole()
{   
   string tenantCode = "B590CD25-3093-DF11-8DEB-001EC9DAB123";
   string roleName = "Tenant_Admin";        
   string description = "Tenant Admin Role"; 
   string roleQualifierQuery = string.Empty;
   IRoleService roleService = ServiceLocator.Resolve>IRoleService<();
   string roleId = roleService.AddRole(tenantCode, roleName, description, roleQualifierQuery);
}