ITenantsProviderSaveRecord Method

Guid SaveRecord(
	TenantData tenant
)

Function SaveRecord ( 
	tenant As TenantData
) As Guid

Guid SaveRecord(
	TenantData^ tenant
)

abstract SaveRecord : 
        tenant : TenantData -> Guid 

Parameters

tenant

Type: Dundas.BI.AccountServices.ExtensibilityTenantData
The tenant to be saved.

Return Value

A value of Empty for the Id property of the provided tenant indicates that the object represents a new tenant which has never been saved. Any other value for the Id property indicates that the tenant already exists and needs to be updated in the storage mechanism.

Notes to Implementers

If a new tenant is being saved, implementations of this method must populate the properties containing the special group IDs for the tenant (i.e. AdministratorsGroupId and MembersGroupId). If the special groups don't exist yet, there are two options: 1) Populate the properties with new GUIDs: In this case, DBI will automatically create groups with those IDs. 2) Leave those properties as empty GUIDs: In this case, DBI will automatically create groups with auto-generated IDs, and then call UpdateSpecialGroupIds(Guid, Guid, Guid).

Notes to Implementers
Implementations of this method may, at the developer's option, throw any of the listed exceptions. However, the system does not rely on those exceptions being thrown in order to function properly.

Reference