{"id":12,"date":"2013-09-27T05:09:00","date_gmt":"2013-09-26T23:39:00","guid":{"rendered":"https:\/\/www.inogic.com\/blog\/?p=12"},"modified":"2021-05-24T11:52:58","modified_gmt":"2021-05-24T11:52:58","slug":"introduction-to-actions-in-crm-2013","status":"publish","type":"post","link":"https:\/\/www.inogic.com\/blog\/2013\/09\/introduction-to-actions-in-crm-2013\/","title":{"rendered":"Introduction to Actions in CRM 2013"},"content":{"rendered":"
\n
<\/div>\n
\n

Until CRM 4 there were Workflows that could be used for asynchronous processing of business logic, generally used for setting up automated actions and defining sales process in Dynamics CRM.<\/span><\/p>\n<\/div>\n

<\/div>\n
Since CRM 2011, the workflows became a category under Processes and there was another category Dialogs introduced. Dialogs provided for execution of Dialog scripts to set up process flows for the Salesforce. These could be used to guide the sales people through the sales process using a question\/answer format. The Dialog included execution of automated steps like the workflows.<\/span><\/div>\n
<\/div>\n
With CRM 2013, the Processes have been extended to now include Business Process Flow and Actions in addition to the categories from the previous versions. In our earlier blog<\/a> we have discussed the concept of Business Process Flow. This article will concentrate on Actions.<\/span><\/div>\n
<\/div>\n
What are Actions?<\/span><\/b><\/div>\n
<\/div>\n
Actions are messages that can defined for an entity. Existing examples messages include Create, Update, Set State, Assign etc. With Actions, the CRM platform has enabled the creation of custom actions for entities to extend the XRM platform. <\/span><\/div>\n
<\/div>\n
Where to use Actions?<\/span><\/b><\/div>\n
<\/div>\n
An example of a custom action could be \u201cApprove\u201d. Often times we have to design an approval process for Dynamics CRM. Once the item is approved, certain actions need to be performed. In previous versions it would either be implemented as a Workflow that is manually executed from the Workflows Dialog or it involved added of a custom attribute that when checked would imply the item is approved and then the workflow would capture the update of this field to process any automated actions defined.<\/span><\/div>\n
<\/div>\n
How to setup an Action?<\/span><\/b><\/div>\n
<\/div>\n
Let us take an example of an approval process. When an item is \u201cApproved\u201d, we want to send email notifying the concerned parties of the approval.\u00a0<\/span><\/div>\n
<\/div>\n
<\/div>\n
<\/div>\n
<\/a><\/div>\n

 <\/p>\n

Here is an action created for \u201cApprove\u201d<\/span><\/div>\n

 <\/p>\n

It accepts an input parameter for the ApprovedBy User. You can specify parameters of any of the following data types<\/span><\/div>\n

 <\/p>\n

<\/div>\n
<\/a><\/div>\n
\u00a0 <\/span><\/div>\n

These parameters could be defined as input\/output parameter.<\/span>
\n\u00a0<\/span><\/p>\n

In the workflow actions, it sends a mail from the ApprovedBy user to the Owner of the Order notifying them of the order being approved. You can also call custom workflow assemblies here.<\/span><\/div>\n

 <\/p>\n

Note the schema name generated \u201cnew_Approve\u201d. This is the name of the new message that will not be available for the Order entity.<\/span><\/div>\n

 <\/p>\n

These actions are available for further implementation of custom business logic through the use of plugins. In some scenarios, say we need to validate certain conditions are met before the item can be approved. In this case we can register a plugin in the Pre-Stage of the Approve Message. The plugin could validate the conditions and throw an exception to abort the processing of the Approve Message.<\/span><\/div>\n

How to use Actions?<\/span><\/b><\/p>\n

Since Actions are implemented as custom messages\/requests, they can be implemented similar to any other OOB messages like Create or Update. <\/span><\/div>\n

 <\/p>\n

Using C# code,<\/span><\/b> you can invoke the Approve request using the following code\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0 \u00a0 <\/span><\/div>\n
\n

<\/span>
\n\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0 \u00a0 \/\/get current user details<\/span><\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 WhoAmIRequest userReq = new WhoAmIRequest();<\/span><\/span><\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 WhoAmIResponse resp = (WhoAmIResponse) proxy.Execute(userReq);<\/span><\/span><\/div>\n

 <\/p>\n

<\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 OrganizationRequest req = new OrganizationRequest(“new_Approve”);<\/span><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 req[“ApprovedBy”] = new EntityReference(“systemuser”, resp.UserId);<\/span><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 req[“Target”] = new EntityReference(“salesorder”,orderid);<\/span><\/div>\n
<\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/\/execute the request<\/span><\/div>\n
\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 OrganizationResponse response = proxy.Execute(req);<\/span><\/div>\n

 <\/p>\n<\/div>\n

Through jscript<\/span><\/b> it can be invoked as follows.<\/span><\/div>\n
\u00a0 <\/span><\/div>\n
<\/span><\/div>\n
\n

<\/span><\/p>\n<\/div>\n

if (typeof (SDK) == “undefined”)
\n{ SDK = { __namespace: true}; }<\/div>\n

 <\/p>\n

SDK.Action = {<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0 _getClientUrl: function () {<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 var ServicePath = “\/XRMServices\/2011\/Organization.svc\/web”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 var clientUrl= “”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if (typeofGetGlobalContext == “function”) {<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 var context = GetGlobalContext();<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 clientUrl = context.getClientUrl();<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 }<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 else {<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if (typeofXrm.Page.context == “object”) {<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 clientUrl = Xrm.Page.context.getClientUrl();<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 }<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 else<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 { throw newError(“Unable to access the server URL”); }<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 }<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if (clientUrl.match(\/\\\/$\/)) {<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 clientUrl = clientUrl.substring(0, clientUrl.length – 1);<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0}<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 return clientUrl + ServicePath;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0 },<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0 ApproveRequest : function (salesOrderId, approvedById) {<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 var requestMain = “”<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += “http:\/\/schemas.xmlsoap.org\/soap\/envelope\/\\”>”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0 http:\/\/schemas.microsoft.com\/xrm\/2011\/Contracts\/Services\\” xmlns:i=\\”http:\/\/www.w3.org\/2001\/XMLSchema-instance\\”>”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0 http:\/\/schemas.microsoft.com\/xrm\/2011\/Contracts\\”>”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 http:\/\/schemas.datacontract.org\/2004\/07\/System.Collections.Generic\\”>”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Target”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 ” + salesOrderId + “”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 salesorder”;<\/div>\n

 <\/p>\n

\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0\u00a0requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 ApprovedBy”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 ” + approvedById + “”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 systemuser”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 new_Approve”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += ”\u00a0\u00a0\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0requestMain += ”\u00a0 “;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 requestMain += “”;<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 var req = newXMLHttpRequest();<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 req.open(“POST”, SDK.Action._getClientUrl(), false)<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 req.setRequestHeader(“Accept”, “application\/xml, text\/xml, *\/*”);<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 req.setRequestHeader(“Content-Type”, “text\/xml; charset=utf-8”);<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 req.setRequestHeader(“SOAPAction”, “http:\/\/schemas.microsoft.com\/xrm\/2011\/Contracts\/Services\/IOrganizationService\/Execute”);<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 req.send(requestMain);<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/\/work with the response here<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/\/var strResponse = req.responseXML.xml;<\/div>\n

 <\/p>\n

<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0 },<\/div>\n

 <\/p>\n

\u00a0\u00a0\u00a0 __namespace: true<\/div>\n

 <\/p>\n

};<\/div>\n

 <\/p>\n

<\/div>\n

 <\/p>\n

<\/div>\n
\n

Here in this above script RequestName<\/b> indicates the Unique Name of Action<\/b>and Parameters contains collection of key value pairs that can be passed to Action. In above script We can use below function using below syntax.<\/span><\/p>\n<\/div>\n

<\/div>\n
<\/div>\n
SDK.Action.ApproveRequest(salesOrderId, approvedById);<\/span><\/div>\n

 <\/p>\n

<\/div>\n
<\/div>\n
You can register plugin on the Approve message<\/b>. The input parameters of the Approve message will receive the input parameters as defined in the Approve Action.<\/span><\/div>\n

 <\/p>\n

<\/div>\n
<\/div>\n
The plugin registration tool will start showing this message for the Order entity to register plugin against.<\/span><\/div>\n

 <\/p>\n

<\/div>\n
<\/div>\n
<\/div>\n
<\/a><\/div>\n
<\/div>\n
<\/div>\n

Once the plugin is registered, in the code you can access the input parameters just like you do for other messages as shown below<\/span><\/p>\n

<\/div>\n

 <\/p>\n

To get access to the image of the Order record<\/span><\/div>\n

 <\/p>\n

<\/div>\n

 <\/p>\n

EntityReference entityRef = localContext.PluginExecutionContext.InputParameters[“Target”] as EntityReference;<\/span><\/div>\n

 <\/p>\n

<\/div>\n

 <\/p>\n

To read the ApprovedBy input parameter<\/span><\/div>\n

 <\/p>\n

<\/div>\n

 <\/p>\n

EntityReference approvedBy = localContext.PluginExecutionContext.InputParameters[“ApprovedBy”] as EntityReference;<\/span><\/div>\n

 <\/p>\n

<\/div>\n

 <\/p>\n

In the pre-stage, you can throw an InvalidPluginExecution error to abort the Approve operation.<\/span><\/div>\n

 <\/p>\n

<\/div>\n

 <\/p>\n

Conclusion:<\/span><\/b><\/div>\n

 <\/p>\n

\u00a0<\/span>Actions is a powerful tool in the hands of the developer to truly extend the CRM platform for XRM implementations.<\/span><\/div>\n

 <\/p>\n

<\/span><\/div>\n

 <\/p>\n

<\/div>\n
<\/div>\n

 <\/p>\n

<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

Until CRM 4 there were Workflows that could be used for asynchronous processing of business logic, generally used for setting up automated actions and defining sales process in Dynamics CRM. Since CRM 2011, the workflows became a category under Processes and there was another category Dialogs introduced. Dialogs provided for execution of Dialog scripts to\u2026 Read More »<\/a><\/span><\/p>\n","protected":false},"author":13,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"om_disable_all_campaigns":false,"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[21,22,24],"tags":[85],"class_list":["post-12","post","type-post","status-publish","format-standard","hentry","category-dynamics-crm-2013","category-dynamics-crm-2015","category-dynamics-crm-2016","tag-actions"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts\/12","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/users\/13"}],"replies":[{"embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/comments?post=12"}],"version-history":[{"count":0,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/posts\/12\/revisions"}],"wp:attachment":[{"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/media?parent=12"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/categories?post=12"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.inogic.com\/blog\/wp-json\/wp\/v2\/tags?post=12"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}