Dynamic CRM 2013学习笔记（三十八）流程1 - 操作（action）开发与配置详解

CRM 2013 里流程有4个类别：操作（action）、业务流程（business process flow）、对话（dialog）和工作流（workflow）。它们都是从 setting –> Process 进入，然后点击New按钮来创建：

这篇主要介绍操作：什么是操作、什么时候使用操作、如何创建以及如何调用

一、什么是操作

操作是CRM 2013 新增加的一个功能，用来扩展系统的标准功能。业务人员可以用它来实现业务逻辑，然后开发人员可以在系统事件里（比如update，create）来使用它。业务人员可以写业务逻辑，就像以前在工作流时一样。如果业务逻辑改变了，业务人员可以直接在操作里修改，而不需要开发人员的参与。 它可以针对某个实体，也可以是全局的(也就是不针对任何实体)，也是在执行管道的30阶段执行，参与到数据库事物中，可以将多个步骤或者操作包含到操作中，支持输入和输出参数，支持在这个消息的Pre或者Post阶段调用其他的插件或者工作流，支持在C#或者JavaScript中调用它，但是它不支持在工作流中直接被调用，也不支持设定触发的范围，设置触发范围为组织级或者用户级。

二、什么时候使用操作

如果你想在一些条件下执行待定的一些步骤，比如一个case被打开多少天并且没有其它操作；我们能根据case打开的天数来实现业务逻辑，然后在case记录里执行它。我们可以发邮件到高级service manager，改变proirity，把case分配到队列里，所以的这些步骤都可以在一个流程里。在以前的版本里，我们用工作流来实现。

三、怎么创建操作

1. settings –> process, 点击New 按钮创建操作

2. 点击ok后，会弹出下面的界面：

3. 可以定义输入，输出参数，是否回滚等：

4. 添加步骤

• 发送邮件：

• 更新实体：

• 创建队列：

• 赋值：

最终效果图如下：

四、如何调用

1. 插件调用

消息里不是我们以前常用的update，create之类了。

public class ActionsSample :IPlugin 

{ 

    string priority = string.Empty; 

    public void Execute( IServiceProvider serviceProvider) 

    { 

        IPluginExecutionContext context = (IPluginExecutionContext) serviceProvider.GetService( typeof( IPluginExecution Context)); 

        EntityReference caseRecord = context.InputParameters[" Target"] as EntityReference; 

        EntityReference EscalatedBy = context.InputParameters[" EscalatedBy"] as EntityReference; 

        priority = context.OutputParameters[" Priority"]. ToString(); }

    } 

}

也可以在update或create之类的消息里，用下面的方法调用操作：

OrganizationRequest req = new OrganizationRequest("new_Escalat");

req["EscalatedBy"] = new EntityReference("systemuser", context.InitiatingUserId);

req["Target"] = new EntityReference(context.PrimaryEntityName, context.PrimaryEntityId);

OrganizationResponse response = service.Execute(req);

2. JS调用

界面上添加一个按钮，然后调用下面的function：

var requestXML = new XMLHttpRequest(); 

requestXML.onreadystatechange = ShowResponse; 

function Escalate() {// function for the command bar 

    var recordId = Xrm.Page.data.entity.getId(); var userId = Xrm.Page.context.getUserId();

    EscalateRequest( userId, recordId); 

}

function EscalateRequest( EscalatedById, CaseId) { 

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

    // WebService Url var requestText = ""; requestText + = "< s:Envelope xmlns:s =\" http:// schemas.xmlsoap.org/ soap/ envelope/\" >"; 

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

    requestText + = " < request xmlns:a =\" http:// schemas.microsoft.com/ xrm/ 2011/ Contracts\" >"; 

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

    requestText + = " < a:KeyValuePairOfstringanyType >" 

    requestText + = " < c:key > EscalatedBy </ c:key >" 

    requestText + = " < c:value i:type =\" a:EntityReference\" >" 

    requestText + = " < a:Id >" + EscalatedById + "</ a:Id >" 

    requestText + = " < a:LogicalName > systemuser </ a:LogicalName >" 

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

    requestText + = " </ c:value >" 

    requestText + = " </ a:KeyValuePairOfstringanyType >" 

    requestText + = " < a:KeyValuePairOfstringanyType >" 

    requestText + = " < c:key > Target </ c:key >" 

    requestText + = " < c:value i:type =\" a:EntityReference\" >" 

    requestText + = " < a:Id >" + CaseId + "</ a:Id >" 

    requestText + = " < a:LogicalName > incident </ a:LogicalName >" 

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

    requestText + = " </ c:value >" 

    requestText + = " </ a:KeyValuePairOfstringanyType >" 

    requestText + = " </ a:Parameters >" 

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

    requestText + = " < a:RequestName > new_Escalate </ a:RequestName >" 

    requestText + = " </ request >" 

    requestText + = " </ Execute >" 

    requestText + = " </ s:Body >" 

    requestText + = "</ s:Envelope >" 

    requestXML.open(" POST", postUrl, true);// true is for async 

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

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

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

    requestXML.send( requestText); } 

function ShowResponse() { 

    var x = requestXML.responseXML.getElementsByTagName(" a:KeyValuePairOfstringany Type"); 

    for (i = 0; i < x.length; i + +) { 

        if (x[ i]. childNodes[ 0]. textContent = = "Priority") 

        { alert(" The case has been assigned to " + x[ i]. childNodes[ 1]. textContent + " priority."); } } 

}

Dynamic CRM 2013学习笔记 系列汇总