Web Services: CrmDiscoveryService
[Applies to: Microsoft Dynamics CRM 4.0]
The CrmDiscoveryService Web service is a global installation-level service that allows the caller to determine the correct organization and URL for their needs. Because Microsoft Dynamics CRM 4.0 is a multi-tenant environment, a single Microsoft Dynamics CRM server can be hosting multiple business organizations. Because each Microsoft Dynamics CRM server may be handling a Web Service Method call for a different organization every time, the Web services must be notified of the target organization that a user is intending to reach.
For a Microsoft Dynamics CRM Online installation, the Microsoft Dynamics CRM server cluster typically includes several servers; each may be dedicated to multiple organizations. Ideally, and from a performance perspective, each server has a dedicated Web service URL so that it can be accessed directly through the Internet. However, the Microsoft Dynamics CRM server and organization allocation may change as part of datacenter management and load balancing. Therefore, there is an automated way to discover which Microsoft Dynamics CRM server is serving your organization at a given time. For an on-premise installation, a Web service caller may have access to multiple organizations that may be hosted in different Microsoft Dynamics CRM servers inside the datacenter.
For both the Microsoft Dynamics CRM Online and Microsoft Dynamics CRM 4.0 installations, the CrmDiscoveryService Web service enables you to discover the CrmService and MetadataService Web service endpoint URLs and other information about your target organization.
The CrmDiscoveryService Web service supports a Web service request to return a list of organizations that the specified user belongs to and the URL endpoint addresses of each organization that hosts Microsoft Dynamics CRM server. This Web service is also used to obtain a ticket that is required for Internet-facing deployment (IFD) and Windows Live authentication.
To access the CrmDiscoveryService Web service, you simply add a Web reference to your Visual Studio project.
In this Section
Explains how to access the CrmDiscoveryService Web service namespace in your Visual Studio project.
Explains how to access the CrmDiscoveryService Web service namespace in your Visual Studio project when using Microsoft Dynamics CRM Online.
Contains instructions about using the CrmDiscoveryService Web service with an Active Directory installation of Microsoft Dynamics CRM.
Shows how to use the CrmDiscoveryService Web service with Microsoft Dynamics CRM Online.
Illustrates use of the CrmDiscoveryService Web service with an Internet Facing Deployment of Microsoft Dynamics CRM.
Lists the messages supported by the CrmDiscoveryService Web service.
Provides an overview of the available Web services.
© 2010 Microsoft Corporation. All rights reserved.