从入门到实战—————Flowable(工作流)

目录

前言

相关概念

Flowable

流程图

流程id

任务id

SpringBoot项目集成Flowable

1、pom.xml文件添加依赖

添加flowable依赖（查找依赖有很多方式，这里用idea查找的）

2、配置yml文件

3、绘制流程图

①下载压缩包

②运行war包

4、必知API

常见问题

github下载速度慢怎么办？

绘制流程图生成的xml总是报错？

有没有相关手册？

---

前言

前段时间项目中用到了Flowable，现在我来聊一聊Flowable的使用，即使没有这方面基础的朋友也可以轻轻松松的阅读实践。

相关概念

Flowable

Flowable是一个使用 Java 编写的轻量级业务流程引擎。

流程图

将整个流程形象直观的展现，使各种情况一目了然，构建完成后可以生成xml文件放到项目中。

流程id

按照拟定好的流程图创建出一个流程的唯一标识，可以通过此标识查看当前流程状态。

任务id

创建流程后，待审批的工作会在对应的审批人上生成一个任务id，在审批人审批后任务id无效。

SpringBoot项目集成Flowable

1、pom.xml文件添加依赖

添加flowable依赖（查找依赖有很多方式，这里用idea查找的）

 大家可以直接复制下面依赖哦！

        <dependency>
            <groupId>org.flowable</groupId>
            <artifactId>flowable-spring-boot-starter</artifactId>
            <version>6.3.0</version>
        </dependency>

连接mysql依赖我用的8.0.16版本，此版本之前有漏洞！！！

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>8.0.16</version>
</dependency>

2、配置yml文件

  flowable:
    # 关闭异步，不关闭历史数据的插入就是异步的，会在同一个事物里面，无法回滚
    # 开发可开启会提高些效率，上线需要关闭
    async-executor-activate: false

3、绘制流程图

①下载压缩包

（1）github网址：Releases · flowable/flowable-engine · GitHub（点击flowable-6.4.0.zip）

 也可以直接点击后面链接下载https://github.com/flowable/flowable-engine/releases/download/flowable-6.4.0/flowable-6.4.0.zip

②运行war包

我的tomcat是9.0.38版本的，上一步下载的压缩包解压，并将所有war包放到tomcat中运行，访问 flowable-modeler （用户名admin,密码test）

绘制好流程图验证无异常可以保存后生成xml文件放到项目中的resources/processes/目录下

4、必知API

    @Autowired
    private RuntimeService runtimeService;
    @Autowired
    private TaskService taskService;
    @Autowired
    private HistoryService historyService;
    @Autowired
    private RepositoryService repositoryService;
    @Autowired
    private ProcessEngine processEngine;

/**
     * 创建流程
     *
     * @param key                 process id
     * @param userId              用户ID
     * @param purchaseOrderNumber 采购单号
     * @param remark              采购备注
     * @return 流程ID
     */
    @GetMapping("add")
    public String addExpense(String key, String userId, String purchaseOrderNumber, String remark) {
        Map<String, Object> map = new HashMap<>();
        map.put("userId", userId);
        map.put("purchaseOrderNumber", purchaseOrderNumber);
        map.put("remark", remark);
        ProcessInstance processInstance = runtimeService.startProcessInstanceByKey(key, map);
        return processInstance.getId();
    }

    /**
     * 获取指定用户组流程任务列表
     *
     * @param group 用户(组)
     * @return    
     */
    @GetMapping("lists")
    public Object gettasksByGroup(String group) {
        List<Task> tasks = taskService.createTaskQuery().taskCandidateGroup(group).list();
        return tasks.toString();
    }

     /**
     * 通过/拒绝任务
     *
     * @param taskId   任务ID
     * @param approved 0 ：通过 1：拒绝
     * @return ResultUtil是我曾令瑶封装的返回对象
     */
    @GetMapping("apply")
    public ResultUtil apply(String taskId, String approved) {
        Task task = taskService.createTaskQuery().taskId(taskId).singleResult();
        if (task == null) {
            return ResultVoUtil.error("该任务不存在！");
        }
        Map<String, Object> variables = new HashMap<>();
        Boolean apply = approved.equals("0") ? true : false;
        variables.put("approved", apply);
        taskService.complete(taskId, variables);
        return new ResultUtil("操作成功");
    }

    /**
     * 查看历史流程记录
     *
     * @param processInstanceId 流程ID
     * @return 历史信息列表
     */
    @GetMapping("historyList")
    public List<HistoricActivityInstance> getHistoryList(String processInstanceId) {
        return historyService.createHistoricActivityInstanceQuery()
                .processInstanceId(processInstanceId).finished().orderByHistoricActivityInstanceEndTime().asc().list();
    }

常见问题

github下载速度慢怎么办？

答：私信我，让你下载速度快近百倍！！！

绘制流程图生成的xml总是报错？

建议生成之前，先点击左上角那个对号图标，没有异常再生成xml文件

有没有相关手册？

Flowable BPMN 用户手册 (v 6.3.0)

里面内容很不错，比如你想找创建实例api