流程插件开发系列2：自定义流转条件插件

背景：
目前流程连线上支持单据字段作为条件，决定流程走向；还有其他特殊需求，就希望通过自定义条件插件，编写代码决定流程走向，流程设计将会更加灵活自由。
很高兴告诉各位伙伴们，后续版本（预计在V6.2的7月份补丁、V7.0）将支持流程连线上配置自定义条件，预算模块还内置了“预算条件方案”插件支持预算流转判断。可用于无法从单据字段取值判断的场景，比如需求是用“发起员工所属组织”作为连线条件，连线上仅能判断发起人用户无法获取发起员工及组织，这种场景就可以通过自定义连线条件插件实现。

1.    用户如何配置自定义条件
本例以配置“发起员工所属组织”作为自定义条件，用户可以在条件项中选择基础资料组织“集团本部”，作为参数传入条件插件中解析条件真假；若发起员工的组织是“集团本部”，则流转到“集团本部”这个节点：
 

2.    开发者如何实现自定义条件插件
2.1.       条件插件基类
Kingdee.BOS.Workflow.Kernel.Condition. AbstractConditionExecutorPlugIn
引用组件Kingdee.BOS.Workflow.Kernel.dll，开发者编写的条件执行类需要继承该基类。
2.2.       方法Execute
方法说明：条件执行的核心方法。
C#定义
public virtual void Execute(MapStateContext flowSateContext, 
List<CustomizeConditionRow> customizeConditionList)
备注：插件中覆写此方法，自行实现条件计算，并将条件计算结果传回流程引擎即可。

2.3.       示例插件代码
以下示例插件，举例说明如何解析“发起员工所属组织”连线条件，示例未经测试仅供参考思路。到K/3 Cloud安装目录的WebSite\Bin子目录，引用如下基本组件（其他组件按需引用）：
Kingdee.BOS.dll
Kingdee.BOS.Core.dll
Kingdee.BOS.DataEntity.dll
Kingdee.BOS.ServiceHelper.dll
Kingdee.BOS.Workflow.Kernel.dll
Kingdee.BOS.Workflow.ServiceHelper.dll
 

using Kingdee.BOS.Condition;

using Kingdee.BOS.Core.Metadata;

using Kingdee.BOS.Orm.DataEntity;

using Kingdee.BOS.ServiceHelper;

using Kingdee.BOS.Workflow.Kernel;

using Kingdee.BOS.Workflow.Kernel.Condition;

using System;

using System.Collections.Generic;

using System.Linq;

using System.Text;

namespace Demo.Workflow.PlugIn.CustomizeCondition

{

    /// <summary>

    /// 以发起员工所属组织作为条件（本插件仅作为参考示例，未经测试）

    /// </summary>

    public class CustomizeConditionStaffOrg : AbstractConditionExecutorPlugIn

    {

        public override void Execute(MapStateContext flowSateContext, List<CustomizeConditionRow> customizeConditionList)

        {

            var context =flowSateContext.MapContext.BOSContext; // 获取BOS上下文

            var originatorId =flowSateContext.MapContext.MapInstance.OriginatorId; // 获取流程发起人用户ID

            foreach (CustomizeConditionRow conditionRow in customizeConditionList)

            {

                // TODO 此处根据conditionRow.ConditionKey获得每行自定义条件项中基础资料ID，本例中即为组织ID；并计算条件真假，计算结果通过conditionRow.ConditionResult传回流程引擎

                // 获取发起人员工

                long senderStaffId =Kingdee.BOS.Workflow.ServiceHelper.EntrustServiceHelper.GetStaffByUserId(context,originatorId);

                FormMetadata senderStaffMeta = MetaDataServiceHelper.Load(context, "BD_Empinfo") as FormMetadata;

                DynamicObject senderStaff = BusinessDataServiceHelper.LoadSingle(context,senderStaffId, senderStaffMeta.BusinessInfo.GetDynamicObjectType());

                // 判断发起人员工所属组织，是否符合自定义条件中的组织要求

                string senderStaffOrgId = Convert.ToString(senderStaff["UseOrgId_Id"]);

                conditionRow.ConditionResult= (senderStaffOrgId == conditionRow.ConditionKey);

            }

        }

    }

}

3.    开发者如何注册自定义条件插件
开发好自定义条件插件后，需要注册到数据表T_WF_ConditionType中。用户才能在流程连线的自定义条件设置界面，使用新的条件类型。

例如注册“员工所属组织”条件插件：
该条件类型的编码假定为WfConditionDemo；
该条件类型对应的基础资料组织FormID是ORG_Organizations；
条件插件格式是命名空间+类名, +组件名称，比如：
Demo.Workflow.PlugIn.CustomizeCondition.CustomizeConditionStaffOrg,Demo.Workflow.PlugIn
则在BOS设计器中导入如下KSQL：

DELETE T_WF_ConditionType WHERE FID = '200001';

INSERT INTO T_WF_ConditionType(FID,FNUMBER,FCREATORID,FCREATEDATE,FMODIFIERID,FMODIFYDATE,FDOCUMENTSTATUS,FFORBIDSTATUS,FOBJECTTYPEID,FPARSECLASS)

VALUES (200001,N'WfConditionDemo',16394,{ts'2017-04-27  10:08:12'},16394,{ts'2017-04-27 10:08:12'},'C','A','ORG_Organizations',N'Demo.Workflow.PlugIn.CustomizeCondition.CustomizeConditionStaffOrg,Demo.Workflow.PlugIn') ;

DELETE T_WF_ConditionType_L WHERE FID = '200001' AND FLOCALEID = 2052;

INSERT INTO T_WF_ConditionType_L(FPKID,FID,FLOCALEID,FNAME,FDESCRIPTION) VALUES(100001,200001,2052,N'以员工所属组织作为条件',N' ') ;

全文完。