Dynamics 365-四：Action操作

参考文档

• 瑞泰信息技术有限公司
• 微软MVP(15-18)罗勇

语义说明

核心名词

​ FetchXML：是基于Xml的查询语言，可以把它简单理解成SQL语句，通过它可以查询Dynamics 365 CRM的数据。开发人员可以在WebAPI或者Organization Service执行FetchXML查询来获取数据，类似于SqlHelper.QueryTable(sql)

​ Action：Dynamics 365 流程中的一种，允许开发人员进行自定义开发，用来定制并组合各种业务逻辑，比如商机赢单、订单提交。我们可以把它简单理解成C#中的一个方法，有输入参数、输出参数。操作的注册模式分为两种：一个是全局，一个是绑定到实体，可以获取到实体ID

​ Web API：是客户端连接服务端的一种方式，拥有良好的平台兼容性，不管什么平台都可以调用，与开发语言无关。它是基于OData v4.0实现，提供了各种现代化的Restful Web服务

​ Organization Service：是客户端连接服务端的另外一种方式，它是基于WCF技术实现，数据传输采用XML，仅使用于.NET客户端

Action

​ 操纵类似与我们常用的方法，用于扩展系统的标准功能，用来实现项目中的业务逻辑。操作可以针对单个实体，也可以是全局（也就是任意实体都可使用）全局方法/局部方法

​ 工作流中可以调用操作，JS也可以调用操作，通过后端C#代码也可调用操作。始终在组织范围内执行操作，不支持执行限制到用户、业务部门或组织的范围。

​ 和Plugin类似，都需要签名，注册到CRM中

自定义操作

新建Action流程

打开D365，进入我的流程中心

在流程中心页面，点击左上角新建按钮，输入流程名称（全英文），类别选择操作（Action），实体选择无（全局）/实体（局部），建议全局，点击确定创建

可选：定义输入参数及输出参数，完成后点击保存，发布，激活

新建Action项目

打开VS，新建类库项目（.NET 版本与D365版本对应）

新建类，继承IPlugin接口，并实现Execute方法

using Microsoft.Xrm.Sdk;
using System;

namespace ActionApp
{
    public class ConeAction : IPlugin
    {
        public void Execute(IServiceProvider serviceProvider)
        {
            IPluginExecutionContext context = (IPluginExecutionContext)serviceProvider.GetService(typeof(IPluginExecutionContext));
            IOrganizationServiceFactory serviceFactory = (IOrganizationServiceFactory)serviceProvider.GetService(typeof(IOrganizationServiceFactory));
            IOrganizationService service = serviceFactory.CreateOrganizationService(null); // 权限
            
            Random rd = new Random();

            string name = context.InputParameters["name"].ToString();
            string area = context.InputParameters["area"].ToString();
            string phone = context.InputParameters["phone"].ToString();

            Entity entity = new Entity("new_customer");
            entity["new_name"] = name + rd.Next(1000, 9999);
            entity["new_area"] = area + rd.Next(1000, 9999);
            entity["new_phone"] = phone + rd.Next(1000, 9999);
            //entity["new_contact"] = entityRef;
            entity["new_lasttime"] = DateTime.UtcNow.AddDays(rd.Next(1,100));

            service.Create(entity);

            context.OutputParameters["msg"] = "ok";
        }
    }
}

签名：右键项目，属性，签名，勾选为程序集签名，新建，填写文件名称，取消使用密码保护密钥文件，确定

编译：右键项目，清理，重新生成

注册/绑定Action

打开注册工具，登录，新建Assembly

在步骤一中选择Action项目编译的DLL文件

在步骤二中勾选添加（使用）的Action（一个类库可有多个action），点击选择添加

新建执行时机：找的上一步添加的类库集合，点击展开，右键添加的Action，选择添加Step

Message：与action流程名一致；Primary Entity：关联实体，若为实体则此Action为局部（实体），none为全局；其次，执行时期为PostOperation，完成

使用Action

JS调用

// 调用全局带参方法
function createEntity() {
	var entity = new Object();
	entity['name'] = '21586625'
	entity['area'] = '21586625'
	entity['phone'] = '21586625'
    
	var req = new XMLHttpRequest();
	req.open('post', Xrm.Page.context.getClientUrl() + "/api/data/v9.0/new_wyg_cone", false)
	req.setRequestHeader("Accept", "application/json");
	req.setRequestHeader("Content-Type", "application/json; charset=utf-8");
	req.setRequestHeader("OData-MaxVersion", "4.0");
	req.setRequestHeader("OData-Version", "4.0");

	req.onreadystatechange = function() {
		if (this.readyState == 4) {
			if (this.status == 200) alert(1)
		}
	}
	req.send(JSON.stringify(entity));
}

调试Action

与插件（Plugin）方式一致，详情

接收参数

字符串类型

string name = context.InputParameters["name"].ToString();
string area = context.InputParameters["area"].ToString();
string phone = context.InputParameters["phone"].ToString();

整数类型

string name = context.InputParameters["name"].ToString();
int money = (int)context.InputParameters["money"];
int age = (int)context.InputParameters["age"];

布尔类型

string name = context.InputParameters["name"].ToString();
bool gender = (bool)context.InputParameters["gender"];
int age = (int)context.InputParameters["age"];

日期类型

string name = context.InputParameters["name"].ToString();
bool gender = (bool)context.InputParameters["gender"];
int age = (int)context.InputParameters["age"];
DateTime time = (DateTime)context.InputParameters["time"];

选择列表

Entity（实体）类型

// Entity类型的参数建议指定@data.type (可以不指定，若是lookup到具体实体，不是customer，partylist类型)，格式为Microsoft.Dynamics.CRM.实体逻辑名称
// 需要指定记录主键值，还有需要用到的该记录的其他字段值
var cus = {}
cus['@data.type'] = 'Microsoft.Dynamics.CRM.new_customer'
cus.new_customerid = '1377FF4A-B494-E811-8ACD-005056948ABE'
cus.new_name = 'libai'
cus.new_area = '上海市'
entity['cus'] = cus

Entity cus = (Entity)context.InputParameters["cus"];

EntityReference（查找）类型

// EntityReference类型的参数指定记录ID就可以,在流程参数类型中已执行实体
var cus = {}
cus.new_customerid = '56C134ED-A433-EB11-B392-005056993F73'
entity['cus'] = cus 

EntityReference cus = (EntityReference)context.InputParameters["cus"];
// or
var s = context.InputParameters["cus"];

EntityCollection（实体列表）类型

var cusitem = {}
cus['@data.type'] = 'Microsoft.Dynamics.CRM.new_customer'
cus.new_customerid = '1377FF4A-B494-E811-8ACD-005056948ABE'
cus.new_name = 'libai'
cus.new_area = '上海市'
entity['cus'] = [cusitem]

EntityCollection cus = (EntityCollection)context.InputParameters["cus"];
// or
var s = context.InputParameters["cus"];

返回参数

context.OutputParameters["msg"] = "ok";