Release | New and updated topics | Description of changes |
Version 4.0.13 November 2010 | SDK\SDKReadme.htm | Updated the SDK readme. |
| SDK\Bin\*.* | Updated on-premises binaries to Update Rollup 13. Updated online binaries to latest service release. |
| SDK\Microsoft.xRM\Bin\*.* SDK\Microsoft.xRM\Tools\*.* SDK\Microsoft.xRM\Samples\Plugin\*.* | Updated all binaries for Advanced Developer Extensions. Added a new plug-in sample using Advanced Developer Extensions. Updated Advanced_Developer_Extensions_-_Developers_Guide.docx. Added Advanced_Developer_Extensions_-_Walkthrough_Plugin.docx. |
| SDK\Server\FullSample\ServertoServerNoCertsImpersonate | Added a new sample for server-to-server authentication with impersonation where no certificates are required. |
| SDK\Server\Helpers\CS\CrmOnlineAuth\WLIDTicket.cs | Updated the helper code to correct an issue where secure information was being saved to a publicly readable XML file. |
| Connect to the Microsoft Dynamics CRM Server | Added documentation for additional parameters needed for the CrmSvcUtil tool. |
| CrmService Operations Using a Data Context (UsingService)ServiceOperationsUsingaDataContext | Added documentation to show how to call the CrmService using a data context. |
| Context Configurability | Added information about configuring the context for advanced developer extensions. |
| Use LINQ to Retrieve Data from Microsoft Dynamics CRM | Added sample code to show how to work with date/time attribute values in the users time zone. |
| Using the Generated Classes in Your Project | Added information about accessing the Web service and context from a plug-in. |
| Event Execution Pipeline | Added a security note about plug-ins registered in the Pre-Event stage. |
| Metadata Messages | Corrected description of the InsertStatusValueRequest. |
| Using the Paging Cookie (PageInfo) | Added missing helper methods to the Fetch paging cookie sample. |
| Productpricelevel.amount | Added information about using this property with the pricing engine. |
Version 4.0.12 May 2010 | SDK\SDKReadme.htm | Updated the SDK readme. |
| SDK\Bin | Updated binaries to Microsoft Dynamics CRM Update Rollup 10 and Microsoft Dynamic CRM Online May Service Update. Note that the WSDL contracts for these releases are unchanged so there is no need to change or recompile source code. |
| SDK\Client\Images | Updated images provided for use in customizations and applications. |
| SDK\WSDL\CrmDiscoveryService.wsdl | Added the Discovery Service WSDL file. This is unchanged, but was missing in the previous SDK package. |
| Accelerators for Microsoft Dynamics CRM 4.0 | Added information about the accelerator add-on solutions available for Microsoft Dynamics CRM 4.0. |
| Advanced Developer Extensions for Microsoft Dynamics CRM 4.0 (Microsoft xRM) SDK\Microsoft.xRM\ | Added a new set of tools that simplifies and accelerates the development of Internet-enabled applications. The conceptual documentation is in this Help file. All other resources can be found in the SDK\Microsoft.xRM folder. |
| AccessRights DisplayMasks DisplayMasks EntityItems EntityItems MetadataItems MetadataItems OwnershipTypes OwnershipTypes SecurityTypes SecurityTypes | Added a note describing the differences between enumeration values using the WSDL compared to the values using the assemblies. |
| AssignUserRolesRole | Added a reference to a KB article describing an issue using this message. |
| Comparison between Data Import and Data Migration | Updated the table to include comparison information about Data Import (on-premises), Data Import (online) and Data Migration (on-premises and online). The topic's title in previous releases was "Differences between Data Migration and Data Import". |
| Creating a Dynamic IFRAME | Removed a note that said that Scripts in Microsoft Dynamics CRM cannot interact with DHTML elements in the source document of an IFRAME. Added code sample about how to do this. |
| CrmService Sample Code | Added a note about fixing the namespace when you add the helper code file to your project. |
| Custom Workflow Activity: Date Checker | Added sample code that shows how to compare dates within a workflow, and then send an e-mail. |
| Customization Best Practices | Added to the Customization Best Practices: How Can I Tell What Customizations Have Been Made to a System? |
| Data Migration and Import | Updated information about where to find information about Data Migration Manager and Import Data Wizard. |
| Filtered Views Use Filtered Views Finding the ID Using Filtered Views | Added a note clarifying that filtered views are not accessible for Microsoft Dynamics CRM Online. |
| Recurrence Pattern in Asynchronous Job Execution | Corrected information about job execution frequency. Removed "MONTHLY" interval and added "YEARLY" interval. |
| Registering Plug-ins Programmatically | Added information about registering custom workflow activities. |
| Related Documentation | Added links to relevant white papers. |
| Server-to-Server Authentication Server-to-Server Authentication with Impersonation Walkthrough: Server to Server Authentication with CRM Online LiveIdTicketManager Classes SDK\Walkthroughs\Authentication\CS\ServerToServerNoCerts SDK\Server\Helpers\CS\CrmOnlineAuth\WLIDTicket.cs | Added new authentication documentation and sample code for Microsoft Dynamics CRM Online that does not require using certificates. The use of certificates is deprecated. |
| Server-to-Server Authentication using Certificates Server-to-Server Authentication using Certificates with Impersonation | Updated topics to indicate that the Windows Live ID team is phasing out the use of certificates. |
| Supported Messages for Plug-ins Performance Best Practices | Added information about messages that are used by the Web application to retrieve entity data and populate a grid view. |
| Unsupported Customizations | Added a note about unsupported customizations to the IIS Website. |
| Upgrade Issues for Workflow and Callouts | Added new information about possible upgrade issues and workarounds for assemblies upgraded from Microsoft Dynamics CRM 3.0. |
| Using the Web Services within a Custom Workflow Activity | Added a note explaining why it is recommended to use dynamic entity within custom workflow activity code. |
| Workflow Life Cycle | Added information about avoiding infinite loops in workflows. |
Version 4.0.11 November 2009 | SDK\SDKReadme.htm | Updated the SDK readme. |
| Download an Attachment SDK\Server\HowTo\CS\Entities\DownloadAttachment.cs | Updated the sample code for downloading an attachment. This new method works with the security enhancements added to Microsoft Dynamics CRM 4.0 Update Rollup 7. |
Version 4.0.10 October 2009 | SDK\SDKReadme.htm | Updated the SDK readme. |
| SDK\WSDL | Removed the SDK\WSDL folder containing the discovery service WSDL. The WSDL is available through Microsoft Dynamics CRM Online. |
| SDK\Tools\PluginRegistration | Updated the sample code with bug fixes. The version of the tool is unchanged. |
| SDK\Server\FullSample\customworkflowactivity | Updated the project and readme to add several new custom workflow activities that you can call from a workflow. For a description of each custom workflow activity, see List of Samples in the SDK Download. |
| Server\HowTo\CS\BulkOperation\CreateQuickCampaign.cs Server\HowTo\VB\BulkOperation\CreateQuickCampaign.vb | Removed these samples. |
| SDK\Walkthroughs\Authentication\VB\Passport\ PassportAuthentication_Metadata.vb | Added a Visual Basic .NET version of the authentication sample for the metadata service. |
| appointment.actualdurationminutes serviceappointment.actualdurationminutes | Added remarks that explain that actual duration minutes is set when the state of the activity is changed to Completed. This applies to all activities. |
| BulkOperationEntities Bulk Operation Entity Capabilities | Clarified that the bulk operation entity is only used for campaign and quick campaign and it is not used for bulk delete, bulk e-mail, or bulk import operations. |
| Choosing Between the WSDL and Assemblies | Added a new page that describes when you should use the WSDL versus the assemblies for your development. |
| CorrelationToken.CorrelationId | Added additional documentation for this property. |
| Create a Campaign | Added a How-to topic that shows how to create a campaign. |
| CrmDiscoveryService Messages | Added a page that lists the messages supported by the CrmDiscoveryService Web service. |
| CrmHelpers Classes SDK\Server\FullSample\UsingHelpers\CS\VB SDK\Server\Helpers\CS|VB\CrmHelpers | Updated the helper code programming reference for Microsoft Dynamics CRM 4.0 Update Rollup 7 and Microsoft Dynamics CRM Online. |
| Customizations using the Microsoft Dynamics CRM SDK | Clarified information regarding the fact that using scripts to hide form elements is not supported and not upgradable. |
| Import/Export (Customization File) Schema SiteMap Schema SDK\Server\Schemas | Updated the customization schema for new features in Microsoft Dynamics CRM Online. |
| importfile.datadelimitercode Property | Clarified information about how to use this property. |
| importfile.filetypecode Property importmap.mapcustomizations Property ImportFileType Class (CrmHelpers) | Documented a new filetype property that specifies the type of the uploaded source file that is used for import and data migration. This property is available in Microsoft Dynamics CRM Online only The new mapcustomizations property is for internal use only. Documented a new enumeration that contains the values for the importfile.filetype property. |
| Microsoft Dynamics CRM Online Authentication SDK\Server\Reference\cs\discoveryservice\*.cs SDK\Server\Reference\vb\discoveryservice\*.vb | Updated the source code samples in the documentation and in the SDK download to obtain the organization-specific CrmService Web service URL from the discovery service instead of using a hardcoded string. Updated the RetrieveCrmTicket, and RetrieveOrganizations samples. Added a sample for RetrieveOrganizations for Microsoft Dynamics CRM Online. |
| organization.getstartedpanecontentenabled Property organization.sampledataimportid Property SubArea Element usersettings.getstartedpanecontentenabled usersettings.homepagelayout | Added new properties to control the Getting Started pane content and the sample data for an organization, and the getting started pane and home page layout for a user. Added new attributes to the SubArea element of the SiteMap to control the Getting Started pane. The Getting Started Pane is available in Microsoft Dynamics CRM Online only. |
| RetrieveMembersBulkOperationRequest.Query | Added a new query property to this request, which can be used to limit the data returned when working with very large data sets. This property is available in Microsoft Dynamics CRM 4.0 Update Rollup 7. |
| RetrieveOrganization | Added a new discovery service message that retrieves an organization. This message is available in Microsoft Dynamics CRM Online only. |
| Support for .NET Framework Versions | Updated supported .NET versions to include .NET 3.5, which is needed for visualizations (charts). |
| Unsupported Customizations | Updated the list of supported DLLs. |
| User Interface Style Guide SDK\StyleSheet\sample.htm SDK\StyleSheet\template.css SDK\StyleSheet\images\form_back.gif SDK\StyleSheet\images\form_toolbar_back.gif SDK\StyleSheet\images\statusbar_back.gif | Added HTML, CSS, and image files that provide a starting point for creating Web pages that look similar to Microsoft Dynamics CRM. Updated the User Interface Style Guide to introduce them. |
| Using Filters in a Report | Updated information about enabling data pre-filtering on reports. |
| Using Pre-generated XmlSerializers to Increase Performance About the Assemblies SDK\Bin\64bit\Online\Microsoft.Crm.SdkTypeProxy.XmlSerializers.dll SDK\Bin\64bit\Microsoft.Crm.SdkTypeProxy.XmlSerializers.dll SDK\Bin\Online\Microsoft.Crm.SdkTypeProxy.XmlSerializers.dll SDK\Bin\Microsoft.Crm.SdkTypeProxy.XmlSerializers.dll | Added information about how to improve performance and minimize memory usage when creating XmlSerializer objects or instantiating Web service proxy classes. Added the Microsoft.Crm.SdkTypeProxy.XmlSerializers.dll assembly to the list of supported assemblies. Added the Microsoft.Crm.SdkTypeProxy.XmlSerializers.dll assemblies. |
| Using the ColumnSet Class | Added a warning about the possible adverse effects of using AllColumns in a query expression. |
| Using the Paging Cookie Server\HowTo\CS\Paging\FetchPagingWithCookie.cs Server\HowTo\VB\Paging\QueryExpressionPagingWithCookie.vb Server\HowTo\CS\Paging\FetchPagingWithCookie.cs Server\HowTo\VB\Paging\QueryExpressionPagingWithCookie.vb | Added sample code that shows how to use the paging cookie from using Fetch and using Query Expression. |
| Visualizations (Charts) Visualization (Chart) Sample Code Visualization (Chart) Data Description Schema savedqueryvisualization Server\FullSample\CreateVisualization\CS|VB SDK\Server\Schemas | Added documentation for the new Visualizations (Charts) feature, available for the R4 release of Microsoft Dynamics CRM Online only. |
| Walkthrough: Client to Server Authentication with CRM Online Walkthrough: Server to Server Authentication with CRM Online SDK\Walkthroughs\authentication\cs|vb SDK\Server\FullSample\ServerToServerImpersonate | Updated the source code samples in these walkthroughs to obtain the organization-specific CrmService Web service URL from the discovery service instead of using a hardcoded string. |
| Walkthrough: Client to Server Authentication with CRM Online SDK\Walkthroughs\authentication\cs|vb | Updated the procedure to download the discovery service WSDL from Microsoft Dynamics CRM Online. |
| Walkthrough: Creating and Registering a Custom Workflow Activity | Added a walkthrough to demonstrate the steps needed to create a custom workflow activity, register it, and use it from the workflow designer. |
Version 4.0.9 June 2009 | SDK\SDKReadme.htm | Updated the SDK readme with new information about the availability of the Windows Live ID software download needed for server-to-server authentication with Microsoft Dynamics CRM Online. |
| SDK\VisualStudioTemplates | Added three new Microsoft Visual Studio template projects for you to use to start your projects: CRM Web page, plug-in, and custom workflow activity. For more information, see List of Samples in the SDK Download. |
| SDK\Client\FullSample\DependentPicklist | Added a new Jscript sample that shows how to make the options available in a picklist field dependent on the selected option of another picklist. This technique supports chaining several picklist fields together. This sample also illustrates best practices for defining functions in the OnLoad event and reusing them in other form events. |
| SDK\Server\FullSample\ ServerToServerImpersonate | Added a new sample that shows how to authenticate and impersonate the logged-on user in a server-to-server scenario with Microsoft Dynamics CRM Online. |
| SDK\Server\HowTo\CS|VB\BulkDelete\ DeleteCompletedAsyncOperationRecords SDK\Server\HowTo\CS|VB\Entities\ UploadAttachment SDK\Server\Reference\CS|VB\MA\ RemoveItemCampaign RemoveItemCampaignActivity RemoveMemberList SDK\Server\Reference\CS|VB\Organization\ RemoveMembersTeam RetrieveAllChildUsersSystemUser SDK\Server\Reference\CS|VB\Scheduling\ RetrieveByGroupResource.cs RetrieveParentGroupsResourceGroup.cs RetrieveSubGroupsResourceGroup.cs SDK\Server\Reference\CS|VB\Security\ RetrieveDeploymentLicenseType.cs RetrieveSharedPrincipalsAndAccess.cs | Added new samples to the sample code in the download package. |
| SDK\Server\FullSample\DataMigration SDK\Server\FullSample\PluginInstaller SDK\Server\FullSample\UsingHelpers SDK\Server\HowTo\VB\DataMigration\StartImportJob SDK\Server\Reference\VB\QOI\LoseOpportunity SDK\Walkthroughs\Metadata\VB\Retrieve\ SDK\Walkthroughs\Plugin\VB\ SDK\Walkthroughs\Workflow\VB\CreateLead | Added Visual Basic .NET samples to sample code in the download package. |
| AutoMapEntity Message (CrmService) SearchByBodyKbArticle Message (CrmService) | Added new samples in Visual C# and Visual Basic .NET to the documentation. |
| AssignUserRolesRole Message (CrmService) AssociateEntities Message (CrmService) BulkDelete Message (CrmService) BulkDetectDuplicates Message (CrmService) CancelContract Message (CrmService) CopyCampaign Message (CrmService) CopyMembersList Message (CrmService) CreateWorkflowFromTemplate Message (CrmService) DownloadReportDefinition Message (CrmService) ExecuteWorkflow Message (CrmService) ExportCompressedAllXml Message (CrmService) ExportCompressedTranslationsXml Message (CrmService) ExportCompressedXml Message (CrmService) ExportTranslationsXml Message (CrmService) LoseOpportunity Message (CrmService) RetrieveParentGroupsResourceGroup Message (CrmService) Search Message (CrmService) SearchByKeywordsKbArticle Message SendEmail Message (CrmService) SendEmailFromTemplate Message (CrmService) SetLocLabels Message (CrmService) SetReportRelated Message (CrmService) | Added Visual Basic .NET sample code to the documentation. |
| Build Query Expressions RemoveItemCampaign Message (CrmService) RemoveItemCampaignActivity Message (CrmService) RemoveMemberList Message (CrmService) RemoveMembersTeam Message (CrmService) RetrieveAllChildUsersSystemUser Message (CrmService) RetrieveByGroupResource Message (CrmService) RetrieveByResourceResourceGroup Message (CrmService) RetrieveByResourcesService Message (CrmService) RetrieveDeploymentLicenseType Message (CrmService) RetrieveSharedPrincipalsAndAccess Message (CrmService) RetrieveSubGroupsResourceGroup Message (CrmService) | Updated the sample code. |
| Create a Picklist with Labels in Multiple Languages | Added a new sample that shows how to create a picklist with labels in multiple languages. |
| CrmService Entities | Added new createdonbehalfby and modifiedonbehalfby attributes to the reference documentation for each entity. These attributes are available only in the WSDL for Microsoft Dynamics CRM Online. |
| Customization Best Practices | Added new information to the following topic: When do I use plug-ins vs. workflow? |
| Deletion Service | Added a new topic that describes how entities are marked for deletion by the platform and deleted later by an asynchronous job. |
| Entity Model | Added an attribute page for each entity that shows the metadata. This is the information that is available in the metadata browser, which only works for on-premise installations. |
| Entity Sample Code Data Management Sample Code Plug-in Sample Code Metadata Sample Code Workflow Sample Code Client Extension Sample Code | Added information to refer readers to the full samples that are available in the SDK download package. |
| Execution of Microsoft Dynamics CRM 3.0 Callouts Microsoft Dynamics CRM 3.0 Workflow Backward Compatibility | Updated the statement about support for workflows and plug-ins created for Microsoft Dynamics CRM 3.0. If you have to change assemblies from an earlier version, we recommend that you upgrade the code to avoid issues. |
| Finding the ID from ASP.NET Code | Changed use of object type code to entity name. |
| How to Delete Asynchronous Operation Records | Added a new sample that shows how to use the BulkDelete messages to delete asynchronous operation records that are in a completed state. |
| States of a Knowledge Base Article Creating, Publishing, and Deleting a Knowledge Base Article Searching for a Knowledge Base Article | Added new conceptual topics that describe knowledge base article states, how to create, publish and remove the articles, and how to search for published knowledge base articles in Microsoft Dynamics CRM. |
| RetrieveCrmUserIdByExternalId | Added a new DiscoveryService Web service message that retrieves the logged-on user's ID in Microsoft Dynamics CRM Online. |
| Server-to-Server Authentication with Impersonation | Added a new topic that describes how to authenticate with Microsoft Dynamics CRM Online in a server-to-server scenario. |
| Supported Messages for Plug-ins | Added the messages that are supported by custom entities and added support for the Create message for the customeropportunityrole entity. |
| Testing and Troubleshooting | Added information about how to make reports generated by the Report Wizard visible in Visual Studio Report Viewer if drillthrough is not working. |
| Using Count Aggregation in FetchXML | Added a new topic that describes the updated aggregation behavior using count. |
| Working With Bit Flag Values | Added sample code that shows how to test bit flag values. |
Version 4.0.8 March 2009 | SDK\SDKReadme.htm | Updated the SDK readme with new information. |
| SDK\Server\Helpers\CS\CrmOnlineAuth SDK\Server\Helpers\VB\CrmOnlineAuth | Added helper code for use with Microsoft Dynamics CRM Online server-to-server authentication scenarios. |
| SDK\Server\Helpers\CS\IdCrlWrapper SDK\Server\Helpers\VB\IdCrlWrapper | Class now throws a custom exception that includes the error code. Also added a Visual Basic .NET version of the helper code. |
| SDK\Server\Helpers\VB\CrmHelpers | Added a Visual Basic .NET version of the helper code. |
| SDK\Tools\PluginRegistration | Updated the tool to version 2.2. Refer to the included Readme file for more information about software updates and new features. |
| SDK\Server\FullSample\DataBinding\CS\WebFormSample SDK\Server\FullSample\DataBinding\VB\WebFormSample | Added a new project that demonstrates data binding an ASPX DataGrid control with Microsoft Dynamics CRM data. |
| SDK\bin\64bit\Live | Added 64-bit assemblies for use with Microsoft Dynamics CRM Online. |
| Promote an E-mail Message to Microsoft Dynamics CRM CrmService Messages MetadataService Messages | Added sample code in Visual Basic .NET. |
| DeliverPromoteEmail Message RetrieveByTopIncidentProductKbArticle Message RetrieveByTopIncidentSubjectKbArticle Message RetrieveMembersBulkOperation Message SearchByBodyKbArticle Message SetStateWorkflow Message UtcTimeFromLocalTime Message | Added sample code in Visual C# and Visual Basic .NET. |
| About the Assemblies | Added information about the execution sequence of plug-ins and workflows in relation to one another and how a pre-event plug-in can prevent a workflow from executing. |
| BulkDeleteRequest.QuerySet BulkDelete Message | Added information about how to use of the BulkDeleteRequest.QuerySet property. |
| Calendar Rule Entity Capabilities | Fixed bug. Calendar rule entity instances cannot be retrieved directly. They can only be accessed by retrieving the parent calendar. |
| Default Privileges Required | Updated this topic with a column of additional information for each privilege. |
| Event Execution Pipeline | Added information about when plug-ins and workflows are executed in the pipeline. |
| How To Convert a Fax to a Task | Updated sample code to use correct date manipulation methods. |
| ISV Extensibility Best Practices | Updated information about where you should put custom code. This requires Microsoft Dynamics CRM 4.0 Update Rollup 2, which can be found at go.microsoft.com/fwlink/?LinkId=144295. |
| Microsoft.Crm.Sdk.IsvReadiness Classes | Added IsvReadiness helper classes, which give you a programmatic means to change parts of the Microsoft Dynamics CRM customization XML files. |
| organization.trackingprefix | Updated topic about updates to the e-mail tracking token prefix. |
| Microsoft Dynamics CRM Online Authentication | Added topics to address client-to-server and server-to-server authentication scenarios for Microsoft Dynamics CRM Online. |
| Parent and Child Pipelines | Clarified the information about child pipelines. Added a list of messages that a child pipeline can process. |
| RetrieveLocLabels Message SetLocLabels Message | Clarified use of the messages to retrieve and set localized labels. These messages are used for the localized display names for attributes, not the labels on a form. |
| Support for the .NET Framework Versions | Added explicit statement of support for ASP.NET AJAX. |
| Unsupported Customizations | Updated support statement about modification of the database. Adding or updating indexes is supported. |
| Upgrade Issues for Workflow and Callouts | Added table of state changes that are handled differently for plug-ins that were upgraded from Microsoft Dynamics CRM 3.0 callouts. |
| Upgrading Your Existing Code | Added a topic that shows the differences between Microsoft Dynamics CRM 3.0 code and Microsoft Dynamics CRM 4.0 code. |
| Upload an Attachment | Added sample code to show how to upload an attachment to an annotation (note). |
| Using the Metadata Browser | Added a note that indicates that the metadata browser works only for on-premise deployments. |
| Walkthrough: Server-to-Server Authentication with CRM Online | Added a new walkthrough. |
| WindowsLiveIdTicketAcquirer | Added documentation for the helper code to support Windows Live authentication. |
Version 4.0.7 September 2008 | SDKReadme.htm | Added documentation for bug 35907. |
| importjob Class | Added new reference topics that describe importjob class and the class properties. |
| Import Job Entity Capabilities | Added a new topic that describes the capabilities of import job entity. |
| Using the Import Job Entity to Track Import Progress | Added new topics that describe how to start, monitor the progress, retrieve and interpret the results of the import operation that imports entity customizations and translations. |
| Default Privileges Required | Added a new topic that lists the default privileges you must add to a custom security role. Also added this note to Role Entity Capabilities. |
| Microsoft.Crm.Tools.Email.Providers Namespace | Added documentation for the classes and enumerations in the Microsoft.Crm.Tools.Email.Providers namespace. |
| Exception Handling Behavior Error Handling in Plug-ins Logging and Tracing | Added text that indicates which server the event log entry is written to. |
| Dependency and Execution Order | Fixed a bug in regarding the sequence that asynchronous operations are executed. |
| pluginassembly.version Property | Added text on how to obtain the version number according to standard .NET practices. |
| Execution of Microsoft Dynamics CRM 3.0 Callouts | Added a note to indicate that the onerror subscription attribute in the v3.0 callout configuration file is not supported under v4.0. |
| Programming Reference: Microsoft.Crm.Sdk.dll | Added reference documentation. |
Version 4.0.6 August 2008 | SDK\Server\Reference\CS SDK\Server\Reference\VB | Added new sample code. |
| Sdk\Walkthroughs\Authentication\CS\Passport | Added sample code to access the metadata service from Microsoft Dynamics CRM Online. |
| SDK\Tools\PluginRegistration | Updated to version 2.1. See the Readme for more information. |
| SDK\Server\Fullsample\DataBinding | Fixed a bug where certain data types were not displayed in the grid. |
| SDK\Walkthroughs\Authentication\CS\Passport SDK\Walkthroughs\Authentication\VB\Passport | Fixed exception handling code to not consume all exceptions. Exception messages are now written to the console. |
| SDK\Server\FullSample\UsingHelpers\CS | Replaced the hardcoded TCP port (2525) with code that accesses the Outlook service to determine whether the client is offline. |
| SDKReadme.htm | Added Send Us Your Feedback link. |
| Creating a Simple Plug-in Creating a Plug-in for Microsoft Dynamics CRM for Outlook that Works Offline Writing a Plug-in SDK\Walkthroughs\Plugin\CS\AccountCreate | Updated the plug-in sample code to use DynamicEntity instead of strong types. |
| Customization File Reference | Completed reference documentation for the supported elements in the customization file. |
| E-mail Providers | Added new topic about how to develop custom providers for the E-mail Router service. |
| ExportCompressedXml Message ExportXml Message ImportCompressedXmlWithProgress Message ImportXml Message ImportXmlWithProgress Message PublishXmlMessage Message Other Nodes Available for Import and Export | Updated all import, export and publish sample code and documentation where it refers to the request.ParameterXml property. In some cases, sample code showing the value of that property was missing required XML nodes. |
| Global Functions | Added detailed reference documentation for scripting functions. |
| How to Add a CrmService Web Reference How to Add a MetadataService Web Reference | Added information about how to add a Web reference using Microsoft Visual Studio 2008. |
| LoseOpportunity SendEmailFromTemplate SearchByKeywordsKbArticle | Added sample code for each message. |
| Microsoft.Crm.SdkTypeProxy Classes | Added a note to clarify that you should use the request and response classes along with the DynamicEntity class found in this assembly for creating plug-ins and custom workflow activities. |
| Passing Parameters to a URL using ISV.Config | Added information about how to escape the ampersand character for query string parameters from a client extension control defined using ISV.Config. |
| PrependOrgName Function | Added a new function that is used to add the organization name to a URL. |
| Support | Clarified support for modification to the customization file. |
| Using Dynamic Entity in Plug-ins | Added a topic that describes why you should use the DynamicEntity class in plug-ins. |
| Using Microsoft Dynamics CRM URLs | Added documentation about constructing URLs for different deployment types. |
| Using the Paging Cookie Using FetchXML | Added information to topics about using the paging cookie in Fetch. |
| Web Service Authentication | Added a known issue to the SDK Readme about server-to-server authentication with Microsoft Dynamics CRM Online. |
Version 4.0.5 May 2008 | SDK\Readme.htm | Updated readme file with late-breaking information. Also, changed the product name throughout the documentation to Microsoft Dynamics CRM Online. |
| SDK\Bin\ | Added 64-bit versions of assemblies. For more information, see About the Assemblies. |
| SDK\Server\FullSample SDK\Server\HowTo SDK\Server\Reference | Added Visual Basic .NET versions of all samples. |
| SDK\Server\FullSample\DataBinding | Moved the using statements for the Web references into the namespace code block so that the Visual C# code would compile in Visual Studio. Updated the Readme.doc file. |
| SDK\Server\HowTo\CS\Misc\AutoMapEntity.cs SDK\Server\Reference\CS\ BulkOperation\RetrieveMembersBulkOperation.cs SDK\Server\Reference\CS\ MetadataService\CanBeReferencing.cs SDK\Server\Reference\CS\ MetadataService\CanManyToMany.cs SDK\Server\Reference\CS\ MetadataService\GetValidReferencedEntities.cs SDK\Server\Reference\CS\ MetadataService\GetValidReferencingEntities.cs SDK\Server\Reference\CS\ Misc\RetrieveByTopIncidentProductKBArticle.cs \Server\Reference\CS\ Misc\RetrieveByTopIncidentSubjectKBArticle.cs \Server\Reference\CS\ Misc\SearchByBodyKbArticle.cs | Added new sample code. |
| SDK\Server\HowTo\CS\Outlook\CrmOutlookService.cs SDK\Server\Reference\CS\Misc\BulkDelete.cs | Updated sample code. |
| Accessing Microsoft Dynamics CRM Web Services | Updated information about the GenerateAuthenticationHeader function. |
| Add a Web page to Navigation | Added a sample that adds an external Web page to the Navigation pane of the application. |
| Avoiding Denial of Service | Replaced the sample code with a fuller sample that can be compiled. |
| Categorizing and Displaying Reports in Different Languages | Added a new topic that describes how to categorize and display reports in different languages. |
| Entity and Attribute Mapping | Added information about how to use the AutoMapEntity message. |
| Entity Model | Added SetStateDynamicEntity as a valid message on all entities that support the SetState message. Added a note that you should register your plug-in to fire on both messages for complete coverage of set state operations. |
| GetDistinctValuesImportFile GetHeaderColumnsImportFile RetrieveParsedDataImportFile | Added sample code for these messages. |
| ImportCompressedTranslationsXmlWithProgress ImportCompressedXmlWithProgress ImportTranslationsXmlWithProgress ImportXmlWithProgress | Corrected message information to show that the progress is logged in the import job entity. Documentation and sample code for working with the import progress log will be added in a future update. |
| Formatting Content | Updated information about how to format values for time, date, number, and base/transaction currency. |
| Linking the Reports | Added a new topic that describes how to link related reports. |
| Managing a Report in the Offline Mode | Added a new topic that describes how to manage the reports in the offline mode. |
| Organization UI Entity Capabilities | Added a note stating that this entity will change significantly in the next release. |
| Parent and Child Pipelines | Added information and sample code showing how to instantiate the Web services in code executing within a child pipeline. |
| RetrieveCrmTicket | Updated sample code. |
| RetrieveOrganizationResources | Added a new message that retrieves data about the resources used by an organization in Microsoft Dynamics CRM Online |
| Retrieving Data from Related Records | Added sample code that shows how to reference data from related records using XMLHttp requests to the Microsoft Dynamics Web service using the RetrieveMultiple message in client-side code. |
| Sample Custom Workflow Activity: Return a Calculated Value Sample Custom Workflow Activity: Create a Task Sample Custom Workflow Activity: Get the Next Birthday Sample Custom Workflow Activity: Calculate the Credit Score | Added custom workflow activity sample code. |
| SDK Message Entity Capabilities | Added a mapping of message names to categories. |
| Support for Multiple Languages | Added a topic regarding translating customized entity and attribute text. |
| Supported Entities for Asynchronous Operations | Added a topic that lists the entity types that are supported for an asynchronous operation. |
| Upgrade Issues for Workflow and Callouts | Updated upgrade information for Microsoft Dynamics CRM 3.0 callouts. |
| Walkthrough: Capturing Sample HTTP Requests | Added new topic that shows how you can use a Web Debugging proxy to capture SOAP packets for Microsoft Dynamics CRM Web service calls from a console application. These SOAP packets are provided in the necessary format for you to use in your JScript code from form events or from ISV.Config client extension controls. |
| Workflow | Removed the "Signing the Workflow Assembly" topic. Custom workflow activity assemblies do not have to be signed. Added information to the Adding Metadata to the Custom Workflow Activity topic about using the PersistOnCloseAttribute to enable a workflow to retry after an error has occurred. |
| Writing Custom Code for Microsoft Dynamics CRM 4.0 for Outlook Use the Methods in the Outlook SDK Assembly | Added new topic that contains information about using the Microsoft Dynamics CRM for Outlook SDK. |
| CrmService.Create method using JScript CrmService.Delete method using JScript CrmService.Execute method using JScript CrmService.Fetch method using JScript CrmService.Retrieve method using JScript CrmService.RetrieveMultiple method using JScript CrmService.Update method using JScript | Added JScript samples to demonstrate using the CrmService methods. These samples correspond to the Visual C# and Visual Basic .NET examples for the common CrmService methods found in CrmService Class. |
Version 4.0.4 April 2008 | SDK\Readme.htm | Updated readme file with late-breaking information. |
| SDK\FullSample\OnlineOfflinePlugin | Added a new sample that shows how to write an online plug-in and an offline plug-in which work together to perform the same operation only one time. |
| BackgroundSendEmail Message | Added sample code. |
| Creating a Plug-in for Microsoft Dynamics CRM for Outlook that Works Offline | Added a step to the walkthrough that demonstrates offline plug-in security. |
| How to: Add the CrmDiscoveryService Web Reference: CRMOnline | Added a topic to show how to get the Web reference for Microsoft Dynamics CRM Online. |
| How to Change Label text in the Navigation Pane | Added step-by-step instructions for how to change the label text in the navigation pane. |
| How to Control Update Access for a Field | Added a new scripting sample that allows you to control which users can update data in a field. |
| Linking Reports | Added a new topic about linking reports. |
| Managing a Report in Offline Mode | Added a new topic about managing reports when offline. |
| Microsoft.Crm.Outlook.Sdk Namespace | Completed reference documentation for this namespace. |
| Offline Plug-in Security | Added information about the additional security restriction for an offline plug-in, which requires that a registry key named after the public key token of the plug-in assembly be added to the system registry. |
| Outlook Sample Code | Added sample code that interacts with Microsoft Dynamics CRM for Microsoft Office Outlook. |
| Privileges by Message | Added detailed privilege information for most messages. |
| Programming Reference | Added information to incomplete topics and fixed broken links. |
| Promote an E-mail Message to Microsoft Dynamics CRM | Added sample code that shows how to create an e-mail activity instance from an e-mail message in an inbox. |
| Publishing a Report | Updated the "Privileges" section and the new "Ownership and sharing" section. |
| Publishing a Report | Added information about publishing a report using the Microsoft Dynamics CRM Web services. |
| QualifyMemberList Message | Added sample code. |
| Send a Bulk E-mail and Monitor the Job | Added sample code that shows how to send a bulk e-mail and monitor its progress. |
| Start an Asynchronous Bulk Delete Job and Review Results | Added sample code that shows how to start a bulk delete job and then review the results. |
| TransformImport Message | Added remarks indicating that this message requires the Data Migration Manager to be installed. |
| What's New in Reporting | Added a topic that describes the changes in reporting in Microsoft Dynamics CRM 4.0. |
| Writing the Plug-in Constructor | Added a topic explaining how to write a constructor for a plug-in that accepts parameters. These strings can be used to pass information to the plug-in at run time. |
Version 4.0.3 March 2008 | SDK\Readme.htm | Updated readme file with late-breaking information. |
| SDK\Server\FullSample\CustomWorkflowActivity | Added a new full sample that demonstrates the use of a custom workflow activity. For a description of this sample, see Sample Code in the SDK Download. |
| SDK\Client\FullSample | Fixed bugs in client sample code. |
| SDK\Server\FullSample\DataMigration SDK\Server\Reference\MA\DistributeCampaignActivity | Fixed bugs in server sample code. |
| Tools\PluginDeveloper | Removed code for working with secure strings because of instability issues. |
| Tools\PluginRegistration | Major upgrade to this tool to support more features of the plug-in registration APIs. New features include: Improved graphical user interface that includes a server connections pane, tabbed tree view of registered assemblies/steps/images for each connection, and the first phase of online help assigned to the F1 key. More online help will be available in future releases. Multiple separate GUI forms have been condensed into a single main window for an improved user experience. Support for multiple connections to Microsoft Dynamics CRM 4.0 servers. Connection information is saved to the disk for reuse in the next session. Support for secure and non-secure information passed to a plug-in's constructor and filtering attributes. Support for ordering the execution of a plug-in step within a stage of the execution pipeline. Ability to disable/enable a step. Support for exporting and importing registration configuration information using the same (register.xml) file format supported by PluginDeveloper. Support for custom entities and attributes. |
| Walkthroughs\Authentication\CS\Passport | Added code to handle an expired ticket. If the ticket expires, the sample attempts to obtain a new ticket. If, after several attempts, a new ticket cannot be obtained, the sample will throw an exception and exit. |
| Attributes and Microsoft Dynamics CRM Types | Updated the list of attribute types for workflow. |
| Customization File | Added a new topic about how to export the customization file using the Web application. |
| MetadataService Web Service | Removed erroneous references to OrderStatus and UpdateStatusValue. These classes are not found in the MetadataService Web service. |
| Other Nodes Available for Import and Export | Added sample code showing how to export the site map and ISV configuration using an API. |
| Programming Reference | Added information to incomplete topics and fixed broken links. |
| Recurrence Pattern in Asynchronous Job Execution | Updated information about specifying frequency for recurring asynchronous operations (system jobs). |
| Report Writers Guide | Added the first installment of the report writers' guide. |
| Utility Sample Code | Added a new topic that describes the utility code used in the SDK samples. |
| How to Retrieve a List of Messages and Entities that Support Plug-ins | Added a new sample that shows how to obtain a list of those messages and entities that support plug-ins. |
Version 4.0.2 February 2008 | SDK\Readme.htm | Updated readme file with late-breaking information. |
| SDK\Server\FullSample\DataBinding | Added missing DataBinding sample code. |
| Removed from SDK: SDK\Walkthroughs\Workflow\NoCode SDK\ProjectTemplates SDK\Tools\DeployWorkflowTool SDK\Tools\WorkflowConfigurationTool | Removed workflow tools and walkthroughs to reduce confusion. The workflow tools previously included in the SDK are not needed for custom workflow activities. |
| ISV Extensibility Best Practices | Updated information about where to deploy custom code. |
| Activity Party (activityparty) Entity Capabilities | Added information about the use of the activityparty.addressused property to control which e-mail address is used. |
| Recurrence Pattern in Asynchronous Job Execution | Added information about how to set the recurrence pattern for an asynchronous job. |
| Workflow: Attributes and Microsoft Dynamics CRM Types | Updated information about the supported types for custom workflow activities. |
| Enabling Duplicate Detection | Updated the information about the use of the organization.isduplicatedetectionenabledforonlinecreateupdate property. |
| Import File Entity Capabilities | Updated information about the correct ordering of messages for the import entity. |
| Programming Reference | Added information to incomplete topics and fixed broken links. |
| What's New in Microsoft Dynamics CRM 4.0 | Added data management features to What's New topic. |
Version 4.0.1 January 2008 | | Removed erroneous files from SDK\Tools folder. Updated Readme file in SDK\ProjectTemplates folder. Fixed broken links in documentation. |
| Walkthroughs: Plug-ins | Fixed plug-in walkthrough. |
| Scripting Sample Code | Added scripting sample code. |
| URL Addressable Forms and Views | Added additional content about passing parameters to forms. |
Version 4.0.0 December 2007 | | Initial version. |