This documentation is archived and is not being maintained.

Web Services: CrmDiscoveryService

Dynamics
banner art

[Applies to: Microsoft Dynamics CRM 4.0]

Find the latest SDK documentation: CRM 2015 SDK

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

How to: Add the CrmDiscoveryService Web Reference

Explains how to access the CrmDiscoveryService Web service namespace in your Visual Studio project.

How to: Add the CrmDiscoveryService Web Reference: CRM Online

Explains how to access the CrmDiscoveryService Web service namespace in your Visual Studio project when using Microsoft Dynamics CRM Online.

Using the CrmDiscoveryService Web Service: On-Premise

Contains instructions about using the CrmDiscoveryService Web service with an Active Directory installation of Microsoft Dynamics CRM.

Using the CrmDiscoveryService Web Service: CRM Online

Shows how to use the CrmDiscoveryService Web service with Microsoft Dynamics CRM Online.

Using the CrmDiscoveryService Web Service: IFD

Illustrates use of the CrmDiscoveryService Web service with an Internet Facing Deployment of Microsoft Dynamics CRM.

CrmDiscoveryService Messages

Lists the messages supported by the CrmDiscoveryService Web service.

Related Sections

About the Web Services

Provides an overview of the available Web services.


© 2010 Microsoft Corporation. All rights reserved.


Show: