Dynamics CRM 2015/2016新特性之三十四：有了插件日志，调试插件so easy!

摘要：

如果调试本机代码正常，插件调试可以查看我的两篇博文：DynamicsCRM插件开发教程：Dynamics365CustomerEngagement中的插件调试和插件调试。如果调试非本机代码，则需要使用远程调试，这更令人讨厌。为了便于演示，我监控了罗勇测试实体的PostUpdate插件中ownerid字段的更改，使用的插件代码如下：protectedvoidExecutePostTestOwnerIdUpdate｛if｛thrownewArgumentNullException；｝//TODO:实现您的自定义plug-inbusinesslogical.localContent.TracingService.Trace（“在PostTestOwnerId分配插件中输入代码！”；annotationEntity[“objectid”]=newEntityReference；服务创建；｝｝插件也在PostAssign消息中注册。代码如下：protectedvoid ExecutePost-TestAssign｛if｛thrownewArgumentNullException；｝//TODO:ImplementyourcustomPlug-inbusinesslogical.localContext.TracingService.Trace（“在PostTestAssign插件中输入代码！”）；IPluginExecutionContextcontext=localContext.PluginExecution上下文；varservice=localContext.OrganizationService；如果｛EntityannotationEntity=newEntity；annotation实体[“subject”]=“这是由POSTSAssign消息中注册的插件生成的！

关注本人微信和易信公众号：微软动态CRM专家罗勇，回复217或者20160330可方便获取本文，同时可以在第一间得到我发布的最新的博文信息，follow me！我的网站是 www.luoyong.me 。

还记得以前调试插件或者自定义工作流代码吗？如果是调试本机的代码还好，插件调试可以查考我这两篇博文：Dynamics CRM插件开发教程之：插件的调试和 Dynamics 365 Customer Engagement中插件的调试，如果是调试非本机代码，需要使用远程调试，更麻烦。现在好多了，新增了一个名称为 PluginTraceLog 的实体，在插件或者自定义工作流中可以调用 ITracingService 服务来向这个实体写入数据，并且在CRM界面上可见，为了使用它，我们需要先开启，导航到设置 > 管理 > 系统设置 > 自定义，可以看到有三个选项，默认是关闭，还有异常和所有两个选项，我这里先设置为所有来看看效果。

Dynamics CRM 2015/2016新特性之三十四：有了插件日志，调试插件so easy!第1张

为了方便演示，我在罗勇测试实体的Post Update插件中监控了ownerid字段的变更，使用的插件代码如下：

protected void ExecutePostTestOwnerIdUpdate(LocalPluginContext localContext)
{
    if (localContext == null)
    {
        throw new ArgumentNullException("localContext");
    }

    // TODO: Implement your custom Plug-in business logic.
    localContext.TracingService.Trace("进入到PostTestOwnerIdAssign插件中的代码了!");
    IPluginExecutionContext context = localContext.PluginExecutionContext;
    var service = localContext.OrganizationService;
    if (context.InputParameters.Contains("Target") && context.InputParameters["Target"] is Entity)
    {
        Entity currentEntity = context.InputParameters["Target"] as Entity;
        localContext.TracingService.Trace(string.Format("新的OwnerId={0}", currentEntity.GetAttributeValue<EntityReference>("ownerid").Id));
        Entity annotationEntity = new Entity("annotation");
        annotationEntity["subject"] = "这是由注册在POSTOWNERIDUPDATE消息中的插件产生的!";
        annotationEntity["objectid"] = new EntityReference(currentEntity.LogicalName, currentEntity.Id);
        service.Create(annotationEntity);
    }
}

在Post Assign消息中也注册了插件，代码如下：

protected void ExecutePostTestAssign(LocalPluginContext localContext)
{
    if (localContext == null)
    {
        throw new ArgumentNullException("localContext");
    }

    // TODO: Implement your custom Plug-in business logic.
    localContext.TracingService.Trace("进入到PostTestAssign插件中的代码了!");
    IPluginExecutionContext context = localContext.PluginExecutionContext;
    var service = localContext.OrganizationService;
    if (context.InputParameters.Contains("Target") && context.InputParameters["Target"] is EntityReference)
    {

        Entity annotationEntity = new Entity("annotation");
        annotationEntity["subject"] = "这是由注册在POSTASSIGN消息中的插件产生的!";
        annotationEntity["objectid"] = context.InputParameters["Target"];
        if (context.InputParameters.Contains("Assignee") && context.InputParameters["Assignee"] is EntityReference)
        {
            localContext.TracingService.Trace(string.Format("新的OwnerId={0}", ((EntityReference)context.InputParameters["Assignee"]).Id));
        }
        service.Create(annotationEntity);
        throw new InvalidPluginExecutionException("罗勇故意抛出的异常!");
    }
}