Dynamics CRM - Trigger a workflow from JavaScript

 

Updated on – 24th Sep 2015

 

Recently I had a requirement to trigger a workflow on click of ribbon button when it meets certain criteria. Refer below link for calling JavaScript function from custom ribbon button.

http://ankit.inkeysolutions.com/2012/01/crm-2011-how-to-use-visual-ribbon.html

The criteria values are checked using JavaScript and if all criteria are satisfied then the workflow is to be triggered. The function below will take two inputs where entityId is the id of the record for which the workflow will execute and workflowProcessId is the id of the workflow which we want to execute.

function startWorkflow(entityId, workflowProcessId) {

  var request = "<s:Envelope xmlns:s=\"http://schemas.xmlsoap.org/soap/envelope/\">" +

   "<s:Body>" +

     "<Execute xmlns=\"http://schemas.microsoft.com/xrm/2011/Contracts/Services\" xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\">" +

       "<request i:type=\"b:ExecuteWorkflowRequest\" xmlns:a=\"http://schemas.microsoft.com/xrm/2011/Contracts\" xmlns:b=\"http://schemas.microsoft.com/crm/2011/Contracts\">" +

         "<a:Parameters xmlns:c=\"http://schemas.datacontract.org/2004/07/System.Collections.Generic\">" +

           "<a:KeyValuePairOfstringanyType>" +

             "<c:key>EntityId</c:key>" +

             "<c:value i:type=\"d:guid\" xmlns:d=\"http://schemas.microsoft.com/2003/10/Serialization/\">" + entityId + "</c:value>" +

           "</a:KeyValuePairOfstringanyType>" +

           "<a:KeyValuePairOfstringanyType>" +

             "<c:key>WorkflowId</c:key>" +

             "<c:value i:type=\"d:guid\" xmlns:d=\"http://schemas.microsoft.com/2003/10/Serialization/\">" + workflowProcessId + "</c:value>" +

           "</a:KeyValuePairOfstringanyType>" +

         "</a:Parameters>" +

         "<a:RequestId i:nil=\"true\" />" +

         "<a:RequestName>ExecuteWorkflow</a:RequestName>" +

       "</request>" +

     "</Execute>" +

   "</s:Body>" +

 "</s:Envelope>";

  var requestURL = Xrm.Page.context.getClientUrl() + "/XRMServices/2011/Organization.svc/web";

  var xmlHttpRequest = new XMLHttpRequest();

  xmlHttpRequest.open("POST", requestURL, false)

  xmlHttpRequest.setRequestHeader("Accept", "application/xml, text/xml, */*");

  xmlHttpRequest.setRequestHeader("Content-Type", "text/xml; charset=utf-8");

  xmlHttpRequest.setRequestHeader("SOAPAction", "http://schemas.microsoft.com/xrm/2011/Contracts/Services/IOrganizationService/Execute");

  xmlHttpRequest.send(request);

}

That’s it. The above common method can be used to trigger workflow from JavaScript.

I hope this would be helpful.