Dynamics 365中自定义工作流活动获取的上下文分析及注意事项

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

为了方便说明，我首先创建一个自定义工作流活动，使用的代码如下。

using System;

using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Activities;
using Microsoft.Xrm.Sdk.Workflow;
using Microsoft.Xrm.Sdk;
using System.Reflection;

namespace CrmVSSolution.Workflow
{
    public sealed class PostTestUpdate : CodeActivity
    {
        protected override void Execute(CodeActivityContext executionContext)
        {
            ITracingService tracingService = executionContext.GetExtension<ITracingService>();
            tracingService.Trace("进入自定义工作流活动CrmVSSolution.Workflow.PostTestUpdate");
            IWorkflowContext context = executionContext.GetExtension<IWorkflowContext>();
            IOrganizationServiceFactory serviceFactory = executionContext.GetExtension<IOrganizationServiceFactory>();
            IOrganizationService orgService = serviceFactory.CreateOrganizationService(context.UserId);
            StringBuilder sb = new StringBuilder();
            PropertyInfo[] properties = context.GetType().GetProperties(BindingFlags.Public | BindingFlags.Instance);
            foreach (PropertyInfo proInfo in properties)
            {
                sb.Append(proInfo.Name);
                sb.Append(" = ");
                if (proInfo.CanRead)
                {
                    sb.Append(proInfo.GetValue(context, null));
                }
                else
                {
                    sb.Append("Cannot read value");
                }
                sb.Append("(");
                sb.Append(proInfo.PropertyType.ToString());
                sb.Append(");");
                sb.Append("\n");
            }
            tracingService.Trace("工作流中context的所有参数如下:\n");
            tracingService.Trace(sb.ToString());
            sb.Clear();
            foreach(var item in context.InputParameters)
            {
                sb.Append(item.Key);
                sb.Append(" = ");
                if (item.Value != null)//注意有的属性的值为null，比如InputArguments
                {
                    sb.Append(item.Value.ToString());
                }
                else
                {
                    sb.Append("null");
                }
                sb.Append("\n");
            }
            tracingService.Trace("工作流中context.InputParameter的参数如下:\n");
            tracingService.Trace(sb.ToString());
            sb.Clear();
            if (context.InputParameters.Contains("Target") && context.InputParameters["Target"] is Entity)
            {
                sb.Append("工作流中包括了Target参数，它是Entity类型.\n");
                var currentEntity = context.InputParameters["Target"] as Entity;
                sb.Append("Target参数包括如下属性:\n");
                foreach (var attr in currentEntity.Attributes)
                {
                    sb.Append(attr.Key);
                    sb.Append(" = ");
                    if (attr.Value != null)//注意有的属性值为null，比如modifiedonbehalfby，所以要加上判断
                    {
                        sb.Append(attr.Value.ToString());
                    }
                    else
                    {
                        sb.Append("null");
                    }
                    sb.Append("\n");
                }
                tracingService.Trace(sb.ToString());
            }
            tracingService.Trace("结束自定义工作流活动CrmVSSolution.Workflow.PostTestUpdate");
            throw new InvalidWorkflowException("有时候不抛出异常不行啊！");
        }
    }
}

然后使用 SDK\Tools\PluginRegistration\PluginRegistration.exe 来注册自定义工作流活动，连接方式如下，我这里是做了IFD的我自己的CRM实验环境。

点击 Register > Register New Assembly，注意注册之前，你的程序集要签名哦。

注册如下，Dynamics 365 Online不支持注册到None中，所以Step 3要选择 Sandbox。但是我的代码中使用了反射来读取参数值，使用的也是本地部署的Dynamics 365，所以注册到None中，注册到Sandbox中的程序集具有的权限要小得多。点击下面的Register Selected Plugins 按钮。电脑分辨率低的童鞋注意，可能要用tab键跳转到这个按钮。

一会儿告诉我注册成功。

根据需要，最好是调整下这个自定义工作流活动的WorkflowActivityGroupName和Name，我这里调整如下。然后点击保存按钮保存就可以了。这个保存按钮好小啊。

然后我们在工作流中就可以使用了，我这里做一个工作流如下，监控的是单行文本字段的变更。我这也也勾选了作为按需工作流，所以是可以手工启动运行的。

当然需要激活工作流，因为我要看的东西都是写在工作流的trace里面，所以我还去设置 > 管理 > 系统设置 > 自定义里面，将启用插件跟踪日志的日志记录这个选项设置为所有。

变更字段值之后我们去看插件日志，在设置>自定义>插件跟踪日志里面查看。不过还真有时候看不到，一般是因为你注册在None中，而不是注册在Sandbox中。为了能看到跟踪信息，我在自定义工作流活动最后抛出异常，这样在工作流的详细信息中肯定可以看到Trace到的消息。我这里先做自动触发的来看看，我更新了单行文本字段值和多行文本字段的值来触发这个工作流，看到的消息如下：

进入自定义工作流活动CrmVSSolution.Workflow.PostTestUpdate

工作流中context的所有参数如下:

PreEntityImages = Microsoft.Xrm.Sdk.EntityImageCollection(Microsoft.Xrm.Sdk.EntityImageCollection);

PostEntityImages = Microsoft.Xrm.Sdk.EntityImageCollection(Microsoft.Xrm.Sdk.EntityImageCollection);

InputParameters = Microsoft.Xrm.Sdk.ParameterCollection(Microsoft.Xrm.Sdk.ParameterCollection);

OutputParameters = Microsoft.Xrm.Sdk.ParameterCollection(Microsoft.Xrm.Sdk.ParameterCollection);

SharedVariables = Microsoft.Xrm.Sdk.ParameterCollection(Microsoft.Xrm.Sdk.ParameterCollection);

WorkflowCategory = 0(System.Int32);

Mode = 1(System.Int32);

LegacyContext = Microsoft.Crm.Workflow.LegacyWorkflowContext(Microsoft.Crm.Workflow.ILegacyWorkflowContext);

OperationStatus = Microsoft.Crm.Workflow.WorkflowOperationInProgressResult(Microsoft.Crm.IGenericHandlerResult);

PluginTypeCache = Microsoft.Crm.Caching.PluginTypeCache(Microsoft.Crm.Caching.PluginTypeCache);

PrimaryEntityName = ly_test(System.String);

PrimaryEntityId = b707de1b-cf99-e611-8161-000d3a80c8b8(System.Guid);

MessageName = Update(System.String);

RequestId = (System.Nullable`1[System.Guid]);

UserId = e9cd027f-26a3-e511-80c6-000d3a807ec7(System.Guid);

InitiatingUserId = e9cd027f-26a3-e511-80c6-000d3a807ec7(System.Guid);

CorrelationId = 7d92631b-2f5f-4d71-b6c2-16608ba82b0c(System.Guid);

Depth = 1(System.Int32);

IsolationMode = 1(System.Int32);

OwningExtension = Microsoft.Xrm.Sdk.EntityReference(Microsoft.Xrm.Sdk.EntityReference);

BusinessUnitId = 487cdd4b-26a3-e511-80c6-000d3a807ec7(System.Guid);

IsExecutingOffline = False(System.Boolean);

IsOfflinePlayback = False(System.Boolean);

IsInTransaction = False(System.Boolean);

OperationId = e697feec-b901-e711-8178-000d3a80c8b8(System.Guid);

OrganizationId = bd2a5c49-6b08-4eda-8a15-84159d9fd349(System.Guid);

OrganizationName = Demo(System.String);

SecondaryEntityName = (System.String);

OperationCreatedOn = 3/5/2017 3:39:32 PM(System.DateTime);

StageName = (System.String);

WorkflowMode = 0(System.Int32);

ExtensionParameters = Microsoft.Xrm.Sdk.ParameterCollection(Microsoft.Xrm.Sdk.ParameterCollection);

PrimaryEntityImage = Microsoft.Xrm.Sdk.Entity(Microsoft.Xrm.Sdk.Entity);

IsCrmUIWorkflow = True(System.Boolean);

IsAutoDeleteSet = False(System.Boolean);

IsLoggingEnabled = True(System.Boolean);

GoingIdle = False(System.Boolean);

WorkflowStageProperty = Microsoft.Crm.Workflow.WorkflowStageProperty(Microsoft.Crm.Workflow.WorkflowStageProperty);

WorkflowLogsProperty = Microsoft.Crm.Workflow.WorkflowLogsProperty(Microsoft.Crm.Workflow.WorkflowLogsProperty);

CorrelationToken = Microsoft.Crm.Sdk.CorrelationToken(Microsoft.Crm.Sdk.CorrelationToken);

EntityDependencies = System.Collections.ObjectModel.Collection`1[Microsoft.Crm.Workflow.EntityDependencyBase](System.Collections.ObjectModel.Collection`1[Microsoft.Crm.Workflow.EntityDependencyBase]);

WorkflowTracingService = Microsoft.Crm.Workflow.WorkflowTracingService(Microsoft.Crm.Workflow.WorkflowTracingService);

SdkService = (Microsoft.Crm.Workflow.IWorkflowSdkServiceFactory);

Event = Microsoft.Crm.Asynchronous.AsyncEvent(Microsoft.Crm.Asynchronous.IGenericEventData);

ChildWorkflowInstanceId = 00000000-0000-0000-0000-000000000000(System.Guid);

InstanceState = Microsoft.Crm.Workflow.AsyncWorkflowInstanceState(Microsoft.Crm.Workflow.WorkflowInstanceStateBase);

ProxyTypesAssembly = (System.Reflection.Assembly);

CallerOrigin = Microsoft.Crm.Sdk.ApplicationOrigin(Microsoft.Crm.Sdk.CallerOrigin);

CorrelationUpdateTime = 3/5/2017 3:39:32 PM(System.DateTime);

TransactionContextId = e697feec-b901-e711-8178-000d3a80c8b8(System.Guid);

ParentPluginExecutionId = 00000000-0000-0000-0000-000000000000(System.Guid);

Arguments = (Microsoft.Xrm.Sdk.Workflow.ArgumentsCollection);

ConversionContext = Microsoft.Crm.BusinessEntities.ConversionContext(Microsoft.Crm.BusinessEntities.ICrmConversionContext);

LegacyConversionContext = Microsoft.Crm.BusinessEntities.ConversionContext(Microsoft.Crm.BusinessEntities.ICrmConversionContext);

工作流中context.InputParameter的参数如下:

Target = Microsoft.Xrm.Sdk.Entity

ConcurrencyBehavior = Default

工作流中包括了Target参数，它是Entity类型.

Target参数包括如下属性:

ly_singlelinetext = 新的单行文本字段值

ly_testid = b707de1b-cf99-e611-8161-000d3a80c8b8

modifiedon = 3/5/2017 3:39:28 PM

modifiedby = Microsoft.Xrm.Sdk.EntityReference

modifiedonbehalfby = null

结束自定义工作流活动CrmVSSolution.Workflow.PostTestUpdate

然后我手工启动工作流来触发该工作流，得到的结果如下：