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

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

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

2017-06-21 16:21 上传

下载附件 (25.54 KB)

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

2017-06-21 16:23 上传

下载附件 (9.29 KB)

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 (CustomizeConditionR