What's New in Web Services
[Applies to: Microsoft Dynamics CRM 4.0]
The Microsoft Dynamics CRM 4.0 Web services have been extended to support the new Microsoft Dynamics CRM Online hosted service. This enables your business to subscribe to hosted services directly from Microsoft. Microsoft Dynamics CRM Online supports a pluggable authentication interface that, by default, handles user authentication through Windows Live ID.
The familiar server installation of Microsoft Dynamics CRM continues to be supported but is now called Microsoft Dynamics CRM 4.0 to distinguish it from the online offering. Microsoft Dynamics CRM 4.0 supports a pluggable authentication interface that handles user authentication through Active Directory.
The Microsoft Dynamics CRM offline capability lets the end-user work with business data while disconnected from a Microsoft Dynamics CRM server or service. When a network connection to a server or service has been established, the offline business data can be synchronized with Microsoft Dynamics CRM. The SDK now supports many APIs that work both online and offline.
Multiple Organizations (Multitenancy)
Microsoft Dynamics CRM 3.0 provided the WSDL and Web service URL (endpoint) for a single business organization. In Microsoft Dynamics CRM 4.0 and Microsoft Dynamics CRM Online, the Web application and Web services support the storage and retrieval of data across multiple business organizations. Each organization is assigned its own WSDL and Web service endpoint. This restricts user and extension component access to those customizations and messages that are unique to a specific organization. Organization-specific data is provided by a single stateless Microsoft Dynamics CRM server that can host multiple organizations.
To locate the needed WSDL and Web service endpoint for a given organization in a multitenant environment, a discovery service has been added. This SDK provides new classes that let you query the discovery service for the WSDL and Web service endpoint that is associated with your organization.
For more information, see Multiple Organizations.
Unified Event Model
This version includes a unified event model: both workflow and plug-ins use the same event framework. Both workflow and plug-ins can be triggered off a much wider range of events, expanding the range of solutions that can be offered by partners, ISVs, and in-house developers. For more information, see Event Framework.
The improved event and plug-in infrastructure lets you take advantage of development investments across online and offline solutions. The CrmService methods now function online and offline. To see whether a message is supported offline, see CrmService Messages. Each message contains a header that shows whether it is support for offline use. For more information, see Using the CrmService Offline.
Multiple Language Support
The metadata Web service can be used to retrieve the metadata for an organization. This uses an improved object model that includes the information for multiple languages for each entity, attribute, and so on. For more information, see Web Services: MetadataService.
This version also contains support for working with language packs that have been installed on your system. For more information, see Support for Multiple Languages.
Metadata Web Service Write Capabilities
In addition to read capabilities, the metadata Web service now contains methods for writing to the metadata, making it easier to write installation programs for customization and add-on features. For more information, see Web Services: MetadataService.
Multiple Authentication Methods
Microsoft Dynamics CRM 4.0 contains the following authentication methods:
Microsoft Dynamics CRM Online - authentication is handled through Windows Live, which was previously known as Passport.
Microsoft Dynamics CRM 4.0, on-premise - authentication is handled through Active Directory, which is also known as Windows Integrated Authentication.
Microsoft Dynamics CRM 4.0, IFD - authentication is handled through Active Directory.
For more information, see Web Service Authentication and Impersonation.
There are many new features in the programming reference. The following list provides links to the new areas:
- The CrmDiscoveryService Web Service provides a mechanism to discover the correct URL for your organization.
- The MetadataService Web service provides methods to read and update the metadata for your organization.
- The Microsoft.Crm.Sdk assembly is used in plug-ins and custom workflows.
- The Microsoft.Crm.SdkTypeProxy assembly is used in plug-ins and custom workflows.
The following list provides links to the new types found in the CrmService Web service.
© 2010 Microsoft Corporation. All rights reserved.