Executing Messages in a Single Transaction in Dynamics CRM 2015

Executing Messages in a Single Transaction in Dynamics CRM 2015
In CRM 2015, you can now execute multiple CRM requests in a single transaction. This gives developers the ability to easily rollback or cancel transactions if one of the CRM requests within the transaction fail.

We can now use the "ExecuteTransactionRequest" message which will automatically rollback the entire transaction if any of the associated requests fail.

Example:
We are going to create a record in three different entity.

1.Create a instance of sales order,invoice and email

Entity order = new Entity("salesorder");

order["name"] = "Shipment Order: A Song of Ice and Fire";

  Entity invoice = new Entity("invoice");

invoice["name"] = "Invoice: INV-00001";

Entity email = new Entity("email");

email["subject"] = "Thank you for purchasing: A Song of Ice and Fire";

2.Form a create request

CreateRequest createOrderRequest = new CreateRequest 

{

Target = order

};

CreateRequest createInvoiceRequest = new CreateRequest 

{

Target = invoice

};

CreateRequest createEmailRequest = new CreateRequest 

{

Target = email

}; 

3.Call execute method

ExecuteTransactionRequest transactionRequest = new ExecuteTransactionRequest 

{

// Pass independent operations 

Requests = new OrganizationRequestCollection 

{

createOrderRequest,

createInvoiceRequest, // we have forced this request to fail 

createEmailRequest

},

};


try 

{

ExecuteTransactionResponse transactResponse =

(ExecuteTransactionResponse)_service.Execute(transactionRequest);

       

// Display the results returned in the responses 

foreach (var response in transactResponse.Responses)

{

foreach (var result in response.Results)

{

Console.WriteLine(

"{0} {1} {2}", response.ResponseName, result.Key, result.Value);

}

}

}

catch (FaultException<Microsoft.Xrm.Sdk.OrganizationServiceFault> ex)

{

Console.WriteLine("Transaction rolled back because: {0}", ex.Message);

}

catch (Exception)

{

throw;

} 

 I have created a plugin which will force the Invoice to fail during creation, so we can see what happens.

The entire transaction rollback no record is created.