Use the SOAP Endpoint for Web Resources

[Applies to: Microsoft Dynamics CRM 2011]

Unlike the REST endpoint for web resources, the SOAP endpoint uses the Organization service. This is the same service used when writing applications that exist outside of the Microsoft Dynamics CRM 2011 application. The differences are:

  • Requests are sent to a different URL: <organization URL>/XRMServices/2011/Organization.svc/web.

  • Authentication is provided by the application.

Because authentication is provided by the application, you must create web resources in the application before the code that uses the service can operate.

Comparison of Programming Methods

You can use the SOAP endpoint for Web Resources with JScript libraries or by using Microsoft Silverlight. The process for using this endpoint is very different, depending on the technology used.

Using the SOAP Endpoint with Silverlight

With Silverlight, you create a Silverlight 4 application project in Visual Studio. After the project is created, you must:

  • Add a service reference to the Organization service.

  • Add some additional files to your solution and manually modify the Reference.cs file generated when you add the service reference.

  • Write code using asynchronous methods. The proxy created by Silverlight when you add the services reference only supports asynchronous methods.

  • Use the late binding syntax because strong types are not available.

For more information, see Walkthrough: Use the SOAP Endpoint for Web Resources with Silverlight.

Using the SOAP Endpoint with JScript

With JScript, you will be using XmlHttpRequest to POST requests to the service. The body of the request must contain the XML appropriate for the message you are using. You must also parse the XML returned in a response. With XmlHttpRequest, it is possible to make synchronous requests. However it is highly recommended to always use asynchronous requests. Because manually configuring each request is very time consuming, it is expected that you will reuse existing libraries or create your own. Microsoft Dynamics CRM 2011 does not provide a comprehensive set of JScript libraries. The specific syntax used when calling JScript libraries depends on how they are designed. Several sample JScript libraries are provided with the Microsoft Dynamics CRM SDK, but these are not intended to represent the only or best library design. The content in the Microsoft Dynamics CRM SDK focuses on helping you create your own libraries.

For more information, see Walkthrough: Use the SOAP Endpoint for Web Resources with JavaScript. For a sample library that retrieves entity metadata, see Sample: Retrieve Entity Metadata Using JavaScript.

See Also

Microsoft Dynamics CRM 2011
Send comments about this topic to Microsoft.
© 2013 Microsoft Corporation. All rights reserved.

Community Additions