Hosted CDI::DisableOrganization

The DisableOrganization procedure disables a customer organization for the Customer Directory Integration (CDI) Service. CDI settings are also removed from all users in the organization.

This procedure calls the methods of the Managed CDI Namespace to make updates in the Active Directory. These method calls remain unchanged. Calls currently made to Managed Helpers to update the Plans Database are replaced by appropriate calls to Managed Customer Plans Namespace.

Arguments

Input argument Required Description

<path>

Yes

The Lightweight Directory Access Protocol (LDAP) path of the customer organization in the Service Provider domain

<preferredDomainController>

Yes

The name of the preferred domain controller in the Service Provider domain

<remoteFQDNDomainName>

Yes

The fully qualified domain name of the customer's remote domain

Remarks

The procedure DisableOrganization does not call RemovePlanFromCustomer since this will be called by method Unsubscribe. DisableOrganization ensures that the organization has unsubscribed from CDI service before it proceeds to delete the required service pointers.

Updates to Plans Database

The following methods of the Managed Helpers Namespace are currently called to update tables of the Plans Database:

  • RemovePlanFromCustomer_

  • LogEventRecord_

Managed Customer Plans Namespace APIs

The following table lists the Managed Customer Plans APIs that will be called internally by the DisableOrganization procedure.

SN Plans DB Action Managed Customer Plans API

1

Log Event Record

LogEvent

Internal Calls Made By the Procedure

The following graph describes the internal calls made by the procedure.

Insert Image: CMSU_Graphics_CDI_DisableOrganization_Calls_to_APIs_of_Managed_CDI_and_Managed_Customer_Plans.JPEG

EnableOrganization - Calls to APIs of Managed CDI and Managed Customer Plans

Security

No remarks

Sample Code

Example XML Request

The following is an example of an XML request for the DisableOrganization procedure of the Hosted CDI Namespace:

<request> 
        <procedure> 
                <execute namespace="Hosted CDI" procedure="DisableOrganization" impersonate="1"> 
                        <executeData> 
                                <path>LDAP://OU=AlpineSkiHouse,OU=ConsolidatedMessenger,OU=Hosting,DC=Fabrikam,DC=Com</path> 
                                <remoteFQDNDomainName>Alpine.com</remoteFQDNDomainName> 
                                <preferredDomainController>ad0l.fabrikam.com 
                                </preferredDomainController> 
                        </executeData> 
                        <after source="executeData" destination="data" mode="merge"/> 
                </execute> 
        </procedure> 
</request>

Applies To

Hosted Customer Directory Integration Namespace API for:

  • Hosted Messaging and Collaboration version 4.0

  • Hosted Messaging and Collaboration version 3.5

  • Windows-based Hosting version 4.5

  • Windows-based Hosting version 4.0

  • Windows-based Hosting for Applications version 1.0

See also

Tasks

Hosted CDI::EnableOrganization