办理人变量表达式

[!IMPORTANT]
1、业务中，经常会出现设计流程时，还不确定具体办理人是谁，就需要后续能够动态设置办理人功能，此时办理人变量表达式就派上用场了

1、特点

• 1、内置常见表达式，同时支持功能强大的spel表达，支持扩展
• 2、支持一对一替换，同时支持多对一的替换，替换集合

 @SpringBootTest
public class VariableTest {

    /**
     * 办理人变量表达式测试
     */
    @Test
    public void testVariable() {
        List<Task> addTasks = new ArrayList<>();
        addTasks.add(FlowFactory.newTask().setPermissionList(Arrays.asList("${handler1}"
                , "#{@user.evalVar(#handler2)}", "${handler3}", "#{@user.evalVar(#handler4)}"
                , "#{@user.evalVarEntity(#handler5)}", "role:1", "1")));
        FlowParams flowParams = new FlowParams();
        Map<String, Object> variable = new HashMap<>();
        variable.put("handler1", Arrays.asList(4, "5", 100L));
        variable.put("handler2", 12L);
        variable.put("handler3", new Object[]{9, "10", 102L});
        variable.put("handler4", "15");
        Task task = FlowFactory.newTask();
        variable.put("handler5", task.setId(55L));

        ExpressionUtil.evalVariable(addTasks, variable);
        addTasks.forEach(p -> p.getPermissionList().forEach(System.out::println));
    }
}

2、内置表达式

• 1、默认办理人变量策略: ${handler1}， $前缀表示默认办理人变量策略
• 2、spel办理人变量策略: #{@user.evalVar(#handler2)}，#前缀表示spel办理人变量策略

3、匹配规则

• 1、默认按照注入策略顺序，倒叙匹配。比如最后注入spel策略，就先遍历spel策略，匹配上就执行。

4、变量替换时机

• 1、流程设计时，本节点配置办理人变量表达式
• 2、上一个节点任务办理时，传入变量
• 3、办理完成会生成本节点任务，即可替换完成

比如B-->C, C任务设置办理人变量为${handler1}，B任务或者之前任务办理时传入变量handler1=100，则C节点办理人变量为100

5、默认办理人变量策略

前端页面设置变量

• 比如：${handler1}，表示默认办理人变量策略，handler1是需要被流程变量中替换的标识

后端代码设置变量

// 流程变量
Map<String, Object> variable = new HashMap<>();
variable.put("handler1", "100");
flowParams.variable(variable);

Instance instance = insService.skipByInsId(testLeave.getInstanceId(), flowParams);

6、spel办理人变量策略

前端页面设置变量

• 比如：#{@user.evalVar(#handler2)}，是spel表达式，#handler2是方法入参变量，可以不设置

后端代码设置变量

/**
 * 用户类
 */
@Component("user")
public class User {

    /**
     * spel办理人变量表达式
     * @param handler2 办理人
     * @return String
     */
    public String evalVar(String handler2) {
        return handler2;
    }
}

// 流程变量
Map<String, Object> variable = new HashMap<>();
variable.put("handler2", "101");
flowParams.variable(variable);

Instance instance = insService.skipByInsId(testLeave.getInstanceId(), flowParams);

7、办理人选择项接口

通过此接口可以给办理人选择，增加默认选项比如发起人、部门领导审批之类的（待开发）