{"id":3387,"date":"2018-10-05T06:55:19","date_gmt":"2018-10-05T06:55:19","guid":{"rendered":"http:\/\/himbap.com\/blog\/?p=3387"},"modified":"2018-10-09T06:03:10","modified_gmt":"2018-10-09T06:03:10","slug":"executing-workflow-from-command-button-using-web-api","status":"publish","type":"post","link":"https:\/\/himbap.com\/blog\/?p=3387","title":{"rendered":"Executing workflow from command button using Web API"},"content":{"rendered":"

Introduction<\/strong>
\nIn our earlier sample<\/a>, we discussed how to call actions using Web API, today we are going to share sample code to execute workflow from\u00a0command button using Web API.<\/p>\n

Requirement<\/strong>
\nLet’s say we got some requirement to validate some logic on click of the\u00a0command button and need to send email using workflow. Let’s see how we can do that.<\/p>\n

Solution<\/strong>
\nFirst we need to create\u00a0 custom solution, in our solution we are going to add the workflow which we want to call using Web API, our entity (we are using Contact entity for demo) and will create a java script web resource (We will be calling this web resource from\u00a0command button).<\/p>\n

We have created workflow on contact entity which is set to run as On Demand<\/strong> and we can copy it’s GUID from the URL like following.
\n\"ribbonbtn3\"<\/a><\/p>\n

Now we are going use following code\u00a0in our java script web resource to call above workflow.<\/p>\n

\r\nfunction ExecuteWorkflow()\r\n{\r\n    \/\/show indication to user\r\n    Xrm.Utility.showProgressIndicator("Executing Workflow....");\r\n    var serverURL = Xrm.Page.context.getClientUrl();\r\n    var contactID=Xrm.Page.data.entity.getId().substring(1, 37);\r\n    \/\/workflow id that we captured above\r\n    var workflowID="E7C36B0F-DCAB-4440-9A0A-FC499A4E2A84";\r\n    \r\n     var data = {\r\n        "EntityId": contactID\r\n    };\r\n \r\n    var req = new XMLHttpRequest();\r\n    req.open("POST", serverURL + "\/api\/data\/v8.2\/workflows("+workflowID+")\/Microsoft.Dynamics.CRM.ExecuteWorkflow", true);\r\n    req.setRequestHeader("Accept", "application\/json");\r\n    req.setRequestHeader("Content-Type", "application\/json; charset=utf-8");\r\n    req.setRequestHeader("OData-MaxVersion", "4.0");\r\n    req.setRequestHeader("OData-Version", "4.0");\r\n    req.onreadystatechange = function() {\r\n        if (this.readyState == 4 \/* complete *\/ ) {\r\n            req.onreadystatechange = null;\r\n            if (this.status == 200) {\r\n                 Xrm.Utility.closeProgressIndicator();\r\n            } else {\r\n                var error = JSON.parse(this.response).error;\r\n                alert(error.message);\r\n                Xrm.Utility.closeProgressIndicator();\r\n            }\r\n        }\r\n    };\r\n     req.send(JSON.stringify(data));\r\n}\r\n<\/pre>\n
In above code we are using showProgressIndicator<\/a> to display a notification to use, earlier there was no supported way to show these type of notification and we used to write unsupported<\/a>\u00a0code to show notification message. Next we are adding parameter required for ExecuteWorkflow<\/a> action, we need to pass entity id and we\u00a0are using\u00a0workflow id in our Web API request. We need to hide notification message using closeProgressIndicator<\/a>.<\/p>\n
Now we can add a button on contact entity, we can add button easily using RIBBON WORKBENCH<\/a>, now this tool is also available on the XrmToolBox<\/a>, you can check our earlier post for how to add button<\/a>.<\/p>\n
First we will add command that we will be using in our\u00a0command button like following, we need select our java script web resource that we have created above and name of the method in script resource.
\n\"ribbonbtn2\"<\/a><\/p>\n
After that we need to use this command in our button like following
\n\"ribbonbtn1\"<\/a><\/p>\n
After publishing our changes we should be able to see Call Workflow button in contact entity form and once click it should show message like following and should call workflow.<\/p>\n
\"backbtn4\"<\/a><\/p>\n
Hope it will help someone !!<\/p>\n","protected":false},"excerpt":{"rendered":"
Introduction In our earlier sample, we discussed how to call actions using Web API, today we are going to share sample code to execute workflow from\u00a0command button using Web API. Requirement Let’s say we got some requirement to validate some logic on click of the\u00a0command button and need to send email using workflow. Let’s see how we can do that…. Read more »<\/a><\/p>\n","protected":false},"author":1,"featured_media":3036,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[402,522],"tags":[653,650,404,651,652],"_links":{"self":[{"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3387"}],"collection":[{"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=3387"}],"version-history":[{"count":6,"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3387\/revisions"}],"predecessor-version":[{"id":3397,"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=\/wp\/v2\/posts\/3387\/revisions\/3397"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=\/wp\/v2\/media\/3036"}],"wp:attachment":[{"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=3387"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=3387"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/himbap.com\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=3387"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}