SDK Release History for V5.0.12

[Applies to: Microsoft Dynamics CRM 2011]

This page contains the list of significant changes made to the SDK version 5.0.12, August 2012 for Microsoft Dynamics CRM 2011 and Microsoft Dynamics CRM Online.

Tip

This is not the current version. To find the release history for the current version, see Release History.

New and updated topics

Description of changes

Microsoft_Dynamics_CRM_2011_SDK_Readme.htm

Updated the readme for this version of the SDK package.

SDK\Bin

Updated the assemblies for Microsoft Dynamics CRM 2011 Update Rollup 10. For on-premises customers, updates and hotfixes can be installed automatically from Microsoft Update. You can also search for updates on the Microsoft Download Center. For online customers, update rollups will be deployed automatically to your organization.

Form Scripting Quick Reference

Added a new topic to provide short, simple explanations and examples of the Xrm.Page object methods on a single page.

SDK\SampleCode\CS\Client\Ribbon\ExportRibbonXml\ExportRibbonXml.cs

Updated the hard-coded list of entities that support the ribbon to include the following entities: goalrollupquery, rollupfield, postfollow, and site.

SDK\SampleCode\CS\Silverlight\CrmODataSilverlight\
CrmODataSilverlight\DataServiceContextExtensions.cs

Updated this class to include a call to entity.ClearChangedProperties(); at the end of the OnWritingEntity event handler.

SDK\SampleCode\CS\Silverlight\RESTRetrieveMultipleSilverlight

Added this sample solution to replace the SDK/SampleCode/CS/Silverlight/RESTEndpointPagingSilverlight solution for Sample: Retrieve Multiple Records Using the REST Endpoint with Silverlight. The sample was updated to meet accessibility standards and the name of the solution was changed to more accurately reflect what the sample does.

SampleCode\CS\WsdlBasedProxies\Readme.docx
SampleCode\VB\WsdlBasedProxies\Readme.docx

Added a note to explain that the Microsoft Dynamics CRM Online version of this sample only supports the Microsoft account identity provider. The Office 365 identity provider is not supported in the Microsoft Dynamics CRM Online sample at this time.

Best Practices for Developing with Microsoft Dynamics CRM

Updated the information on service channel allocation performance.

Choose your Development Style for Managed Code for Microsoft Dynamics CRM

Added a new topic that describes the choices of tools and classes you can use when you write managed code and provides information to help you decide what is best for your needs.

Create Accessible Web Resources

Added a new topic to provide an introduction to creating web resources that can provide equivalent functionality for all users so that people with disabilities will be able to use your web resources.

Build Queries with QueryExpression

Use the FilterExpression Class

Added information about quick find query optimizations and a new property in the FilterExpression class. This property is used by the platform to improve performance of quick find queries.

Customize Entity and Attribute Mappings

Updated the list of requirements for attribute maps in the Using Entity and Attribute Mapping Data section to show that PartyList attributes cannot be mapped.

Design Considerations for Different Form Presentations

Updated the topic with changes to read-optimized forms.

GetGlobalContext Function

Added a note about some global application event handlers that are included in an HTML web resource when you add a reference to the ClientGlobalContext.js.aspx page.

Helper Code: ServerConnection Class

SDK\SampleCode\CS\CrmServiceHelpers.cs
SDK\SampleCode\VB\CrmServiceHelpers.vb
SDK\SampleCode\Readme.docx

Improved the authentication helper code with the following new features:

  • Added automatic refresh of the security token.

  • Added code to save the user’s logon credential by using the Windows Credential Manager.

  • Add a generic service proxy creation method named GetProxy(). This method supports both the Organization and Discovery web services.

Important: All applications that use this helper code must now include a reference to the Windows Identity Foundation (Microsoft.IdentityModel.dll) assembly in the project.

Implement Single Sign-on from an ASPX Webpage or IFRAME

Added information about enabling IFRAME communication across domains.

Open Forms, Views, Dialogs and Reports with a URL

Updated this topic with examples using Xrm.Utility.openEntityForm.

Ribbon XML Reference

Added additional information about elements with an Id attribute that the values used must be globally unique. When an element is applied to multiple entities, the {!EntityLogicalName} token should be used to generate unique ID values for each entity.

Sample: Associate and Disassociate Records Using the REST Endpoint with JavaScript Sample: Associate and Disassociate Records Using the REST Endpoint with JavaScript
Sample: Create Dependent OptionSets (Picklists)
Sample: Create, Retrieve, Update and Delete Using the REST Endpoint with JavaScript
Sample: Create, Retrieve, Update and Delete Using the REST Endpoint with JavaScript and jQuery
Sample: Import Files as Web Resources
Sample: Pass Multiple Values to a Web Resource Through the Data Parameter
Sample: REST Endpoint jQuery Contact Editor
Sample: Retrieve Entity Metadata Using JavaScript
Sample: Retrieve Multiple Records Using the REST Endpoint with JavaScript
Walkthrough: Use the SOAP Endpoint for Web Resources with JavaScript
Xrm.Page Sample Libraries:
Sample: SDK.AttributeSamples.js
Sample: SDK.AttributesCollectionSamples.js
Sample: SDK.ContextSamples.js
Sample: SDK.ControlSamples.js
Sample: SDK.EntitySamples.js
Sample: SDK.FormItemSamples.js
Sample: SDK.FormSelectorSamples.js
Sample: SDK.NavItemSamples.js
Sample: SDK.NavItemSamples.js
Sample: SDK.NavItemsCollectionSamples.js
Sample: SDK.SectionSamples.js
Sample: SDK.TabCollectionSamples.js
Sample: SDK.TabSamples.js
Sample: SDK.UISamples.js

Updated samples to work correctly for browsers to be supported in a later release.

Sample: Associate and Disassociate Records Using the REST Endpoint with JavaScript
Sample: Associate and Disassociate Records Using the REST Endpoint with JavaScript
Sample: Create Dependent OptionSets (Picklists)
Sample: Create, Retrieve, Update and Delete Using the REST Endpoint with JavaScript
Sample: Create, Retrieve, Update and Delete Using the REST Endpoint with JavaScript and jQuery
Sample: Create, Retrieve, Update and Delete Using the REST Endpoint with Silverlight
Sample: Import Files as Web Resources
Sample: Pass Multiple Values to a Web Resource Through the Data Parameter
Sample: REST Endpoint jQuery Contact Editor
Sample: REST Endpoint Silverlight Contact Editor
Sample: Retrieve Entity Metadata Using JavaScript
Sample: Retrieve Multiple Records Using the REST Endpoint with JavaScript
Sample: Retrieve Multiple Records Using the REST Endpoint with Silverlight
Sample: SDK.AttributeSamples.js
Sample: SDK.AttributesCollectionSamples.js
Sample: SDK.ControlSamples.js
Sample: SDK.FormItemSamples.js
Sample: SDK.NavItemSamples.js
Sample: SDK.SectionSamples.js
Sample: SDK.TabSamples.js
Sample: SDK.UISamples.js
Walkthrough: Use the SOAP Endpoint for Web Resources with Silverlight
Walkthrough: Use the SOAP Endpoint for Web Resources with JavaScript

Reviewed and updated all samples with user interface elements to meet standards for accessibility to ensure that people with disabilities can run the samples. This also demonstrates good practices for developing accessible code.

Sample: Retrieve Multiple Records Using the REST Endpoint with JavaScript

Sample: Associate and Disassociate Records Using the REST Endpoint with JavaScript

Changed the implementation of these samples so that they use the SDK.REST.js library.

Simplified Connection to Microsoft Dynamics CRM

Sample: Simplified Connection Quick Start using Microsoft Dynamics CRM

SampleCode\CS\QuickStart\SimplifiedConnection.cs
SampleCode\VB\QuickStart\SimplifiedConnection.vb

Added a new sample that demonstrates how to connect to the web services without using helper code. Added a security note regarding the use of the app.config and web.config files.

Sample: Set the State of a Workflow

SampleCode\CS\Process\Workflows\SetStateWorkflow.cs
SampleCode\VB\Process\Workflows\SetStateWorkflow.vb

Added a new sample that shows how to change the state of a workflow.

Set Field Values Using Parameters Passed to a Form

Updated this topic to refer to the Xrm.Utility.openEntityForm function to show an easier way to set form values for Microsoft Dynamics CRM Online organizations and for Microsoft Dynamics CRM 2011 organizations that have Microsoft Dynamics CRM 2011 Update Rollup 8 installed.

Solution Tools for Team Development

SDK\Bin\SolutionPackager.exe

Added information about how to manage solution files in source code control using the new SolutionPackager tool.

See Also

Other Resources

Release History
Software Development Kit for Microsoft Dynamics CRM

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