Considerations for Partner Solutions to Work with Dynamics CRM Online Provisioned Through Microsoft Online Services Platform

Applies To: Microsoft Dynamics CRM Online

Mahesh Hariharan, Peter Hecke
Microsoft Corporation

November, 2012


This article contains information about changes that you must make to your solutions, client applications, and application extensions for Microsoft Dynamics CRM 2011 and Microsoft Dynamics CRM Online so that they continue to work when your organization moves to the Microsoft online services platform.

Applies To

Microsoft Dynamics CRM 2011 and Microsoft Dynamics CRM Online


The following describes the changes that are needed for each situation.

Required Changes

The changes required depend on the deployment and the type of extensions you have made to Microsoft Dynamics CRM.

You have a Microsoft Dynamics CRM Solution

If you have a solution that is fully contained within Microsoft Dynamics CRM, then no changes are necessary for this solution to work with the new platform. This assumes that the solution contains no external components that call into the web service endpoints.

You have an Application that uses Microsoft Dynamics CRM Web Services

If you have an application that interacts with the Microsoft Dynamics CRM web service endpoints, for example calling web methods, you need to make the following changes. This includes applications such as mobile clients, portals, data load, and integration solutions.

You have a Windows Azure Listener Application that uses Message Buffers

Coming in Microsoft Dynamics CRM 2011 Update Rollup 12 and Microsoft Dynamics CRM December 2012 Service Update, the use of message buffers in Windows Azure listener applications is no longer supported. If you have implemented a Windows Azure listener application that makes use of message buffers, you must update your listener application to instead use persistent queues or topics.

The following procedure lists the generic steps to follow to update a listener application that retrieves messages from a message buffer to one that receives messages from a persistent queue.

How to Update a Message Buffer Listener to Use Persistent Queues

  1. On the Windows Azure portal and in the same solution, create a queue in the same path as was used for the message buffer.

  2. Install the Windows Azure SDK v1.6 or later on your development box.

  3. Update the listener code by removing the message buffer related classes and methods, and then replace them with QueueClient and Receive. Be sure to use the desired read mode: RetrieveAndDelete or PeekLock. For more information about reading messages from a queue, see Queues, Topics, and Subscriptions.

  4. Build the listener application.

No Microsoft Dynamics CRM configuration changes are necessary as long as the queue endpoint uses the same solution path as the message buffer had used.

For more information about developing with Microsoft Dynamics CRM, see Microsoft Dynamics CRM 2011 SDK.

Send comments about this article to Microsoft.