Microsoft Dynamics CRM 2011 Plugin 插件开发和调试

一、搭建环境:

安装一个虚拟机，配置CRM2011 环境，具体：Microsoft CRM2011 安装步骤。

本机环境:Microsoft Windows 7,Microsoft Sql Server 2008,Microsoft Visual Studio 2010。

下载MS CRM 2001 SDK http://www.microsoft.com/zh-cn/download/details.aspx?id=24004
找到 sdk\tools\developertoolkit 下面的 crmdevelopertools_installer.msi 进行安装。

问题：

1.创建实体商务审批、商务审批明细，其中 商务审批和商务审批明细是一对多的关系
2.商务审批字段
编号、汇总明细价格、商务审批状态(草稿，审批中、审批通过、驳回)
3.商务审批明细字段
编号、价格、商务审批状态(草稿，审批中、审批通过、驳回)

实现开发
1).将商务审批明细中的价格汇总到商务审批汇总明细价格中。

1. 打开VS2010，点击文件，选择新建项目，选择Dynamics CRM模版，选择Dynamics CRM 2011 Plug-in Library,我将名称命名为PluginsTest，点击确定，如图：



点击确定之后，VS会自动生成一些代码。不管它。

2. 打开Plugin.cs，创建默认的构造函数： public Plugin() { } //创建默认的构造函数 必须的。 ---如果不创建默认的构造函数，那么会注册插件失败。

比如：当我新建一条商务审批记录的时候，会出现：



所以 注册插件的时候，必须创建默认的构造函数。

3.在Plugin.cs 找到这个代码：

// Use the factory to generate the Organization Service.

this.OrganizationService = factory.CreateOrganizationService(this.PluginExecutionContext.UserId);//当前用户权限的组织服务
this.OrganizationService = factory.CreateOrganizationService(null);//SYSTEM(系统内置最高权限)的组织服务

然后在下面写代码。

主要代码如下：

#region 将商务审批明细中的价格汇总到商务审批汇总明细价格中
//判断执行上下问验证是否存在Target参数并且为Entity
if (PluginExecutionContext.InputParameters.Contains("Target") && PluginExecutionContext.InputParameters["Target"] is Entity)
{
try
{
if (PluginExecutionContext.MessageName != "Create" &&
PluginExecutionContext.MessageName != "Update" &&
PluginExecutionContext.MessageName != "Delete") { return; } //若不为Create,Update,Delete,则返回

//获取目标实体对象
Entity targetEntity = PluginExecutionContext.InputParameters["Target"] as Entity;

//定义并初始化商务审批ID
Guid swspid = Guid.Empty;

#region Create
if (PluginExecutionContext.MessageName == "Create")//若为Create 创建商务审批明细
{
if (targetEntity.Contains("new_swsp"))//判断是否存在new_swspid
{
swspid = (targetEntity["new_swsp"] as EntityReference).Id;//获取商务审批ID
}
}
#endregion

#region Update
if (PluginExecutionContext.MessageName == "Update")//若为Update
{
Entity imageEntity = PluginExecutionContext.PreEntityImages["preImage"] as Entity;//获取执行上下文的前期映像操作

if (targetEntity.Contains("new_jg"))
{
if (targetEntity != null && targetEntity.Contains("new_swsp"))
{
swspid = (targetEntity["new_swsp"] as EntityReference).Id;//获取商务审批ID
}
else
{
if (imageEntity.Contains("new_swsp")) { swspid = (imageEntity["new_swsp"] as EntityReference).Id; }
}
}
}
#endregion

#region Delete
if (PluginExecutionContext.MessageName == "Delete")//若为Delete
{
Entity imageEntity = PluginExecutionContext.PreEntityImages["preImage"] as Entity;
//Entity imageEntity = PluginExecutionContext.PostEntityImages["postImage"] as Entity;

if (targetEntity != null && targetEntity.Contains("new_swsp"))
{
swspid = (targetEntity["new_swsp"] as EntityReference).Id;
}
else
{
if (imageEntity.Contains("new_swsp"))
{
swspid = (imageEntity["new_swsp"] as EntityReference).Id;//获取商务审批ID的值
}
}
}
#endregion

if (swspid != Guid.Empty)//如swspid不为空
{
GetTotalPriceById(swspid);//执行方法 将商务审批明细中的价格汇总到商务审批汇总明细价格中
}
}
catch (Exception ex)
{
TracingService.Trace("Operate Error:{0}", ex.Message);
throw ex;
}
}
#endregion

#region 通过商务审批明细的id 汇总价格
/// <summary>
/// 通过商务审批明细的id 汇总价格
/// </summary>
/// <param name="spid"></param>
private void GetTotalPriceById(Guid spid)
{
//通过高级查找聚合查询 下载fetchxml,进行修改。
string fetchxml = @"<fetch version='1.0' mapping='logical' distinct='false' aggregate='true'>
<entity name='new_swspmx'>
<attribute name='new_jg' alias='new_jg_sum' aggregate='sum' />
<filter type='and'>
<condition attribute='statecode' operator='eq' value='0' />
<condition attribute='new_swsp' operator='eq' value='" + spid + @"' />
</filter>
</entity>
</fetch>";

EntityCollection entityCollection = OrganizationService.RetrieveMultiple(new FetchExpression(fetchxml));//获取集合信息

if (entityCollection.Entities.Count == 0) { return; }
decimal new_jg = 0;

foreach(var item in entityCollection.Entities)
{
if (item.Contains("new_jg_sum"))
{
new_jg = ((Money)(((AliasedValue)item["new_jg_sum"]).Value)).Value;
Entity swspEntity = new Entity("new_swsp");//实例化商务审批实体
swspEntity.Attributes.Add("new_swspid",spid);//添加商务审批id
swspEntity.Attributes.Add("new_hzmxjg", new Money(new_jg));//添加商务审批价格
OrganizationService.Update(swspEntity);//执行Update操作
}
}

}
#endregion

然后重新生成



右击类库PluginsTest 属性，为Plugin.cs签名。





签名之后，点击保存文件。

然后重新生成PluginsTest类库。

二、调试插件

下载 PluginRegistration.exe

打开 PluginRegistration.exe



打开如图所示：

我们先来调试 当创建一条商务审批明细记录出现报错信息的时候。

第一：首先创建一个新的connection. 选择你虚拟机的ip地址，用户名,如图：



然后点击Connect,出现



出入正确的密码。点击确定之后会出现



再点击Connect 就OK了。

第二：注册插件

1. 在Plugin Registration Tool 窗体上 Register :



选择 Register New Assembly (注册新的程序集) 。选择PluginTest生成的dll路径:



点击Register Selected之后：



再选择



出现：



选择 Register New Step，会弹出一个新的窗体：



说明下：Message:当输入C的时候，界面会自动提示。---执行什么操作 Primary Entity:操作的主实体。这里为new_swspmx(商务审批明细)。

选择Post-operation。点Register New就可以了。

然后出现：



选择（Step）PluginTest.Plugin:Create of new_swspmx。选择上面的 Profile(注意要先点击install Profiler，才会有Profile).

出现：



然后进行CRM页面上创建一条商务审批明细记录。

首先，创建一条商务审批记录：



点击保存之后，选择商务审批窗体 左边导航下面的 商务审批明细：



然后创建一条新的商务审批明细记录，输入基本的信息，点击保存，

会弹出一个日志报错信息（注意要出现业务流程错误这样子很长的信息，才可以调试），然后下载日志报错信息，我这里把日志报错信息放到了电脑桌面上：



接着，PluginRegistration.exe上面点击 Stop Profiling，会变成Profile





然后选择 Debug,选择报错的日志文件：ErrorDetails.txt ,选择dll的路径，出现：



然后在VS里面设置断点，选择调试，附件进程：





在点击前面的 Start plugin 就可以，调试了。按F10，F11



基本上就这样子，谢谢。

注意 ：这里一个情况就是停用和启用的时候没有考虑到，代码就不写了，大家可以自己加上。