1. 工作流分支控制

1.1. 工作流分支自定义函数(Since:V5.6)

开发人员通过自定义函数在工作流分支原有的函数基础上进行扩展，完成预置函数不能完成的逻辑。

可从外部系统取数控制表单流程流转，比如可以在处理时实时从ERP取数决定流转的分支。

代码实现非常简单，定义任意类，加上相关注解，在Spring中注册即可

package com.seeyon.ctp.common.function.test;

import com.seeyon.ctp.util.annotation.Function;

public class ERPFunctions {
    @Function(title = "wffuncdemo.checkbudget.title", description = "wffuncdemo.checkbudget.description", category = "wf_branch_function")
    public static boolean isBudgetAvailable(String department, double amount) {
        System.out.println("部门:" + department + "未超出预算.");
        return true;
    }

    @Function(title = "wffuncdemo.checkmember.title", description = "wffuncdemo.checkmember.description", category = "wf_branch_function")
    public static boolean checkMember(String member, int month) {
        System.out.println("人员" + member + " " + month + "全勤");
        return true;
    }
}

方法上添加Function注解，声明当前方法是自定义函数。

在函数列表中显示的标题的国际化资源的key。

在函数列表中显示的函数描述国际化资源的key。

固定使用wf_branch_function，表明用于工作流分支。

函数的名称，使用方法名称，工作流分支自定义函数要求是返回值为boolean型的静态方法。

注意：只有部署了自定义函数的环境，分支函数对话框才会出现“自定义函数”，请参照示例代码。

1.2. 节点人员匹配规则自定义接口(Since:V6.1SP1)

1.2.1. 功能说明

在选人界面新增一个页签，是指在如下图所示的选人界面红色框位置增加一个页签，同时在流程图添加节点时可以选择该页签下的内容，并根据选择的内容进行节点人员匹配。

1.2.2. 开发步骤

每个实现了选人界面面板接口的实现类都有一个类型标识，比如是JoinAccountTag，需要修改的文件列表如下：

修改orgDataCenter.js文件

修改Panel.js文件

修改SelectPeople.jsp文件

修改spring-workflow-manager.xml文件

修改workflowEditSubProcess_js.jsp文件

新增人员匹配类VJAccountTagMatchImpl

public class VJAccountTagMatchImpl extends HumenNodeMatchAbstract {

    public static final Logger log = Logger.getLogger(VJAccountTagMatchImpl.class);

    private OrgManager orgManager;

    private JoinOrgManagerDirect joinOrgManagerDirect;

    @Override
    public String getCatagory() {
        return "vjoin";
    }

    @Override
    public String getTypeId() {
        return V3xOrgEntity.ORGENT_TYPE_JOINACCOUNTTAG;
    }

    @Override
    public String getTypeName() {
        return "vjoin单位标签";
    }

    @Override
    public int getOrder() {
        return 0;
    }

    @Override
    public WorkflowOrgnazitionVO findMatchedOrgVo(String preNodeType, String preNodeId, Map<String, Object> formDataMap,String baseMasterId) {
        WorkflowOrgnazitionVO vo= new WorkflowOrgnazitionVO();
        vo.setId(preNodeId);
        vo.setType(OrgConstants.ORGENT_TYPE.Account);
        return vo;
    }

    @Override
    public WorkflowNodeUsersMatchResult getMatchedUsers(String partyId, Map<String, Object> matchContext) throws BusinessException {
        try{
            WorkflowNodeUsersMatchResult result= new WorkflowNodeUsersMatchResult();
            Long enumItemId= Long.parseLong(partyId);
            List<V3xOrgMember> members = joinOrgManagerDirect.getMembersByEnumId(enumItemId);

            result.setMembers(members);
            String matchMsg = "该vjoin单位标签人员匹配结果为"+WorkflowUtil.getMemberNames(members);
            result.setMatchRuleMsg(matchMsg);
            result.setNodeOrgType(getTypeName());
            return result;
        }catch(Throwable e){
            WorkflowNodeUsersMatchResult result= new WorkflowNodeUsersMatchResult();
            String matchMsg = "该单位节点人员匹配发生异常："+e.getMessage();
            result.setMatchRuleMsg(matchMsg);
            log.error(matchMsg,e);
            result.setNodeOrgType(getTypeName());
            return result;
        }
    }

    public OrgManager getOrgManager() {
        return orgManager;
    }

    public void setOrgManager(OrgManager orgManager) {
        this.orgManager = orgManager;
    }

    public void setJoinOrgManagerDirect(JoinOrgManagerDirect joinOrgManagerDirect) {
        this.joinOrgManagerDirect = joinOrgManagerDirect;
    }

}

这个类实现的接口定义如下： 接口定义：com.seeyon.ctp.workflow.wapi.HumenNodeMatchAbstract 接口方法定义：

/**
     * 节点分类
     * @return
     */
    public String getCatagory();

    /**
     * 组织模型类型标识
     * @return
     */
    public String getTypeId();

    /**
     *     组织模型类型名称
     * @return
     */
    public String getTypeName();

    /**
     * 节点显示序号
     * @return
     */
    public int getOrder();

    /**
     * 获得节点人员列表
     * @param partyId
     * @param matchContext
     * @return
     * @throws BusinessException
     */
    public WorkflowNodeUsersMatchResult getMatchedUsers(String partyId,Map<String,Object> matchContext)  throws BusinessException;

    /**
     * 获得节点的真正的组织模型类型
     * @param preNodeType上节点类型
     * @param partyId 节点ID
     * @param formDataMap 表单数据
     * @param baseMasterId 表单数据ID
     * @return
     */
    public WorkflowOrgnazitionVO findMatchedOrgVo(String preNodeType, String partyId, Map<String, Object> formDataMap,String baseMasterId);

1.3. 动态函数自定义接口(Since:V6.1SP1)

1.3.1. 功能说明

动态函数自定义接口，提供了一套工作流分支函数扩展机制，开发人员通过开发动态函数，并注册到V5系统中，然后在工作流分支条件设置的地方就可以使用动态函数进行分支条件设置，从而实现使用动态函数实现流程分支判断。

1.3.2. 开发步骤

公式配置

用单位管理员登录系统，进入公式配置页面，如下图所示：

新建动态函数

注意工作流函数的返回值必须是布尔值，否则工作流分支设置时不会识别。 在上图右侧黑色框中写好groovy脚本后，单击【校验】按钮，如图看到如下图所示的提示，则表示动态函数设置是正确的，单击【确定】按钮进行保存即可。

设置工作流分支条件

根据新建公式函数时选择的应用范围(全局、协同模板、表单制作和公文模板)，用对应的账号登录系统进行公式函数的绑定。 如果应用范围是【全局】，则表示该公式函数可以在协同模板、表单模板和公文模板的分支设置中使用。 如果应用范围是【协同模板】，则需要用单位管理员登录系统，在协同模板的分支设置中使用。 如果应用范围是【表单制作】，则需要用表单管理员登录系统，在表单制作的应用绑定的分支设置中使用。 如果应用范围是【公文模板】，则需要用单位管理员登录系统，在公文模板的应用绑定的分支设置中使用。 在对工作流分支条件进行设置时，对动态函数的配置过程如下图所示：