Performing Specialised Dynamics CRM SDK Operations using UpdateRequest

Roshan Mehta, 09 April 2015

The latest version of Microsoft Dynamics CRM 2015 (pre-release) introduces some improvements to the SDK to simplify common operations. In this post, we will look at how the UpdateRequest has been changed to allow us to perform specialised operations in a simple manner.

In previous versions of Microsoft Dynamics CRM, it was not possible to change the state of a record using the UpdateRequest. Instead, developers have to rely on the specific SetStateRequest to achieve this simple task.

The following code snippet is an example of how we would create a new Account, and then use the UpdateRequest to change the state of the Account to Inactive.

Note: The crmService variable is of type IOrganizationService.

Entity account = new Entity("account");
account["name"] = "Magnetism";

Console.WriteLine("creating account");
Guid id = crmService.Create(account);
Console.WriteLine("account created");

account["accountid"] = id;
account["statecode"] = new OptionSetValue(1); // inactive
account["statuscode"] = new OptionSetValue(2);

Console.WriteLine("updating account");
crmService.Update(account);
Console.WriteLine("account updated");


Previous versions of Microsoft Dynamics CRM

In previous versions of Microsoft Dynamics CRM, we can see here that an error occurs, but it doesn't tell us that we have to use the SetStateRequest to change the state of the Account. The Account remains in an active state.

Microsoft Dynamics CRM 2015 Pre-release

In the Microsoft Dynamics CRM 2015 Pre-release, the UpdateRequest allows us to change the state of the Account to inactive without any errors.

The following list describes the deprecated request messages which can now be achieved using the UpdateRequest.

  • AssignRequest
  • SetStateRequest
  • SetParentSystemUserRequest
  • SetParentTeamRequest
  • SetParentBusinessUnitRequest
  • SetBusinessEquipmentRequest
  • SetBusinessSystemUserRequest

Source: https://msdn.microsoft.com/en-us/library/dn932124.aspx

Note: Although the link above states that these messages are deprecated, it was still possible to execute these requests at the time this post was written.