Dynamics 365 Customer Engagement中插件的调试

微软动态CRM专家罗勇 ,回复319或者20190319可方便获取本文,同时可以在第一间得到我发布的最新博文信息,follow me!我的网站是 www.luoyong.me 。

本文主要根据官方的教程 Tutorial: Debug a plug-in 而写,使用的环境是我自己搭建在Azure VM中的,版本为 版本 1612 (9.0.2.3034) (DB 9.0.2.3034) (本地) 。

最近开始我的博文使用的Dynamics 365 Customer Engagement版本都不再使用V8.2版本,而会使用V9.X版本。插件程序集需要引用 Microsoft.CrmSdk.CoreAssemblies 这个NuGet包的最新版本,当然针对的.NET Framework 也要变化,使用的版本是 4.6.2版本,若还没有下载,可以去 .NET SDKs for Visual Studio 下载 .NET Framework 4.6.2 Develper Pack 安装即可。

根据 Tutorial: Write and register a plug-in ,我注册个简单的插件,代码很简单,如下:

Dynamics 365 Customer Engagement中插件的调试

using System;using System.Security.Cryptography;using System.ServiceModel;using Microsoft.Xrm.Sdk;namespace CRM.Plugins
{    public class PreWorkOrderCreate : IPlugin
    {        public void Execute(IServiceProvider serviceProvider)
        {
            ITracingService tracingService = (ITracingService)serviceProvider.GetService(typeof(ITracingService));
            IPluginExecutionContext context = (IPluginExecutionContext)serviceProvider.GetService(typeof(IPluginExecutionContext));            if (context.InputParameters.Contains("Target") && context.InputParameters["Target"] is Entity)
            {
                Entity currentEntity = (Entity)context.InputParameters["Target"];
                IOrganizationServiceFactory serviceFactory = (IOrganizationServiceFactory)serviceProvider.GetService(typeof(IOrganizationServiceFactory));
                IOrganizationService service = serviceFactory.CreateOrganizationService(context.UserId);                try
                {                    var rng = new RNGCryptoServiceProvider();                    byte[] data = new byte[100000];                    int seed = BitConverter.ToInt32(data, 0);                    var rand = new Random(seed);
                    currentEntity["ly_autonum"] = rand.Next(1, 100000).ToString("000000");
                }                catch (FaultException<OrganizationServiceFault> ex)
                {                    throw new InvalidPluginExecutionException("An error occurred in PreWorkOrderCreate.", ex);
                }                catch (Exception ex)
                {
                    tracingService.Trace("PreWorkOrderCreate unexpected exception: {0}", ex.Message);                    throw;
                }
            }
        }
    }
}

Dynamics 365 Customer Engagement中插件的调试

 

这里贴两个注册插件的截图:因为我自己搭建的OP V9.0环境注册插件报错,所以我用CRM Online来完成本博文的,报错信息如下:此插件程序集使用了版本 4.6.2 的 .NET Framework。目前,Microsoft Dynamics 365 要求插件程序集使用版本 4.5.2 的 .NET Framework。请使用 .NET Framework 版本 4.5.2 重新生成此程序集,然后重试。

特别说明,本地部署版本注册插件报错的问题在 Microsoft Dynamics 365 Server v9.0 (on-premises) Update 0.3 中解决了。

Dynamics 365 Customer Engagement中插件的调试

 

Dynamics 365 Customer Engagement中插件的调试

 

 然后我测试下插件代码基本有效。

下面开始讲述如何调试插件。首先点击插件注册工具上的【Install Profiler】安装,我安装失败,报错如下,原来是我这个用户虽然有系统管理员角色,但是其【Access Mode】为Administration,所以会缺少很多权限。将这个用户在Office 365 Admin Portal中授予其Dynamics 365 Customer Engagement的许可(License)稍等一会儿待该用户的【Access Mode】变成Read-Write后重新点击插件注册工具上的【Install Profiler】按钮即可。

Microsoft.Crm.CrmSecurityException: SecLib::CheckPrivilege failed. User: 28eafdf4-363a-e911-a9ae-000d3a1ad5ea, PrivilegeName: prvCreateContractTemplate, PrivilegeId: d6cd0451-bca1-42b0-9ffd-5596a3b9a8f9, Required Depth: Basic, BusinessUnitId: 5d2366b2-3b1d-e911-a9b1-000d3a1adfba, MetadataCache Privileges Count: 3998, User Privileges Count: 555 ---&gt; Microsoft.Crm.CrmSecurityException: SecLib::CheckPrivilege failed. User: 28eafdf4-363a-e911-a9ae-000d3a1ad5ea, PrivilegeName: prvCreateContractTemplate, PrivilegeId: d6cd0451-bca1-42b0-9ffd-5596a3b9a8f9, Required Depth: Basic, BusinessUnitId: 5d2366b2-3b1d-e911-a9b1-000d3a1adfba, MetadataCache Privileges Count: 3998, User Privileges Count: 555

 

Dynamics 365 Customer Engagement中插件的调试

 

 然后选中我要调试的插件步骤,然后点击 【Start Profiling】这个菜单项

Dynamics 365 Customer Engagement中插件的调试

 

 保持不变,直接点击 【OK】按钮。

Dynamics 365 Customer Engagement中插件的调试

 

【Start Profiling】成功的话可以看到这个插件步骤后面多了【Profiled】,然后我要触发这个插件的执行,我这里就简单,创建一条【工单】记录就可以。然后点击 【Stop Profiling】按钮停止Profile,Stop Profiling成功的话,这个插件步骤后面多了的【Profiled】字眼会消失。

Dynamics 365 Customer Engagement中插件的调试

 

在选中要调试的插件步骤的前提下,点击 【Debug】按钮。

Dynamics 365 Customer Engagement中插件的调试

 

在弹出的对话框中,点击Profile 文本框旁边的向下按钮,会弹出【Select Profile From CRM】窗口,选择合适的记录(每次记录成功的Profile都有一条记录,所以可能会出来多条,根据Created和Type Name选择合适的)后点击【Select】按钮。

Dynamics 365 Customer Engagement中插件的调试

 

然后选择合适的【Assembly Location】和【Plugin】,也就是插件编译的程序集,此时不要点击【Start Execution】按钮,请继续后面的步骤。

Dynamics 365 Customer Engagement中插件的调试

 

然后在Visual Studio对插件的代码设置好断点,再点击【Debug】 > 【Attach to Process】,在弹出的如下【Attach to Process】框中,找到名称为【PluginRegistration.exe】的Process (前面步骤的截图中已经告知了这个Process 的ID为16700,刚好对上),点击【Attach】后。点击前面步骤截图中的【Start Execution】按钮。

Dynamics 365 Customer Engagement中插件的调试

 

可以看到下图,击中断点,你可以尽情调试拉。

Dynamics 365 Customer Engagement中插件的调试

 


上一篇:利用Azure虚拟机安装Dynamics 365 Customer Engagement之九:新建组


下一篇:利用Azure虚拟机安装Dynamics 365 Customer Engagement之十:为SQ