Activiti 5.4 用户指南（中文版）_高清_

第一章、简介 .......................................................................................................................................................................... 1 1.1 许可 ........................................................................................................................................................................... 1 1.2 下载 ........................................................................................................................................................................... 1 1.3 源码 ........................................................................................................................................................................... 1 1.4 所需的软件 ............................................................................................................................................................... 1 1.4.1 JDK 5+ .............................................................................................................................................................. 1 1.4.2 Ant 1.8.1+ ........................................................................................................................................................ 1 1.4.3 Eclipse 3.6.2 ..................................................................................................................................................... 1 1.5 报告问题 ................................................................................................................................................................... 1 1.6 试验性的特性 ........................................................................................................................................................... 1 1.7 内部实现类 ............................................................................................................................................................... 2 第二章、开始 .......................................................................................................................................................................... 2 2.1 一分钟版 ................................................................................................................................................................... 2 2.2 演示设置 ................................................................................................................................................................... 2 2.3 workspace文件夹下的示例项目 ............................................................................................................................... 4 2.4 依赖函数库 ............................................................................................................................................................... 4 2.5 Eclipse设置 ................................................................................................................................................................ 5 2.6 查看数据库 ............................................................................................................................................................... 6 2.7 数据库表的命名 ....................................................................................................................................................... 7 第三章、配置 .......................................................................................................................................................................... 8 3.1 创建ProcessEngine ................................................................................................................................................... 8 3.2 ProcessEngineConfiguration bean ............................................................................................................................... 9 3.3 数据库配置 ............................................................................................................................................................... 9 3.4 作业执行器的（Job executor）激活 ...................................................................................................................... 10 3.5 邮件服务器的配置 ................................................................................................................................................. 11 3.6 历史的配置 ............................................................................................................................................................. 11 3.7 在表达式、脚本中公布配置的beans .................................................................................................................... 11 3.8 支持的数据库 ......................................................................................................................................................... 11 3.9 修改数据库 ............................................................................................................................................................. 11 3.10 下载Oracle驱动 ................................................................................................................................................... 12 3.11 数据库更新 ........................................................................................................................................................... 12 第四章、Spring的集成 ......................................................................................................................................................... 14 4.1 ProcessEngineFactoryBean ....................................................................................................................................... 14 4.2 事务 ......................................................................................................................................................................... 14 4.3 表达式 ..................................................................................................................................................................... 17 4.4 自动资源部署 ......................................................................................................................................................... 18 4.5 单元测试 ................................................................................................................................................................. 18 第五章、API........................................................................................................................................................................... 20 5.1 引擎API ................................................................................................................................................................... 20 5.2 异常策略 ................................................................................................................................................................. 20 5.3 单元测试 ................................................................................................................................................................. 21 5.4 调试单元测试 ......................................................................................................................................................... 22 5.5 web应用程序中的工作流引擎 ............................................................................................................................... 24 5.6 流程虚拟机（PVM） API ...................................................................................................................................... 25 小觑夜漫酒作伴，破晓黎明当笑言 ii 5.7 表达式 ..................................................................................................................................................................... 26 第六章、部署 ........................................................................................................................................................................ 27 6.1 业务归档文件 ......................................................................................................................................................... 27 6.1.1 使用Activiti Probe部署 ............................................................................................................................... 27 6.1.2 编程式部署 .................................................................................................................................................. 27 6.1.3 使用ant部署 ............................................................................................................................................... 27 6.1.4 使用Activiti Probe部署 ............................................................................................................................... 28 6.2 外部资源 ................................................................................................................................................................. 28 6.2.1 Java类 ........................................................................................................................................................... 28 6.2.2 在流程中使用Spring beans ......................................................................................................................... 28 6.2.3 创建独立应用 .............................................................................................................................................. 28 6.3 流程定义的版本 ..................................................................................................................................................... 28 6.4 提供流程图 ............................................................................................................................................................. 29 6.5 生成流程图 ............................................................................................................................................................. 30 第七章、BPMN ...................................................................................................................................................................... 31 7.1 BPMN是什么 ........................................................................................................................................................... 31 7.2 示例 ......................................................................................................................................................................... 31 7.3 定义流程 ................................................................................................................................................................. 31 7.4 入门：10分钟指南 ................................................................................................................................................ 32 7.4.1 先决条件 ...................................................................................................................................................... 32 7.4.2 目标 .............................................................................................................................................................. 32 7.4.3 用例 .............................................................................................................................................................. 33 7.4.4 流程图 .......................................................................................................................................................... 33 7.4.5 XML的描述 ................................................................................................................................................... 33 7.4.6 启动流程实例 .............................................................................................................................................. 34 7.4.7 任务列表 ...................................................................................................................................................... 36 7.4.8 认领任务 ...................................................................................................................................................... 37 7.4.9 完成任务 ...................................................................................................................................................... 37 7.4.10 结束流程 .................................................................................................................................................... 38 7.4.11 代码综述 .................................................................................................................................................... 39 7.4.12 以后扩展 .................................................................................................................................................... 41 7.5 BPMN 2.0 结构 ........................................................................................................................................................ 41 7.5.1 自定义扩展 .................................................................................................................................................. 41 7.5.2 事件 .............................................................................................................................................................. 42 定时器事件的定义 ........................................................................................................................................ 42 7.5.3 Start事件 ...................................................................................................................................................... 43 7.5.4 None start事件 ............................................................................................................................................. 43 描述 ................................................................................................................................................................ 43 图形化符号 .................................................................................................................................................... 44 XML表示 ........................................................................................................................................................ 44 7.5.5 Timer start事件 ............................................................................................................................................ 44 描述 ................................................................................................................................................................ 44 图形化符号 .................................................................................................................................................... 44 XML表示 ........................................................................................................................................................ 44 7.5.6 End事件 ........................................................................................................................................................ 45 7.5.7 None end事件 .............................................................................................................................................. 45 小觑夜漫酒作伴，破晓黎明当笑言 iii 描述 ................................................................................................................................................................ 45 图形化符号 .................................................................................................................................................... 45 XML表示 ........................................................................................................................................................ 45 7.5.8 Error end事件 ............................................................................................................................................... 45 描述 ................................................................................................................................................................ 45 图形化符号 .................................................................................................................................................... 46 XML表示 ........................................................................................................................................................ 46 7.5.9 顺序流（sequence flow） ............................................................................................................................ 47 描述 ................................................................................................................................................................ 47 图形化符号 .................................................................................................................................................... 47 XML表示 ........................................................................................................................................................ 47 7.5.10 带条件的顺序流（conditional sequence flow） ....................................................................................... 47 描述 ................................................................................................................................................................ 47 图形化符号 .................................................................................................................................................... 47 XML表示 ........................................................................................................................................................ 48 7.5.11 默认顺序流 ................................................................................................................................................ 49 描述 ................................................................................................................................................................ 49 图形化符号 .................................................................................................................................................... 49 XML表示 ........................................................................................................................................................ 49 7.5.12 分支（Gateways） .................................................................................................................................... 50 7.5.13 单一分支（Exclusive Gateway） ................................................................................................................ 50 描述 ................................................................................................................................................................ 50 图形化符号 .................................................................................................................................................... 51 XML表示 ........................................................................................................................................................ 51 7.5.14 并行分支（parallel gateway） ................................................................................................................... 52 描述 ................................................................................................................................................................ 52 图形化符号 .................................................................................................................................................... 52 XML表示 ........................................................................................................................................................ 53 7.5.15 用户任务 .................................................................................................................................................... 54 描述 ................................................................................................................................................................ 54 图形化符号 .................................................................................................................................................... 54 XML表示 ........................................................................................................................................................ 54 到期时间 ........................................................................................................................................................ 55 用户的分配 .................................................................................................................................................... 55 Activiti对于任务分配的扩展 ......................................................................................................................... 56 7.5.16 脚本任务（script task） ............................................................................................................................. 58 描述 ................................................................................................................................................................ 58 图形化符号 .................................................................................................................................................... 58 XML表示 ........................................................................................................................................................ 58 脚本中的变量 ................................................................................................................................................ 58 脚本的结果 .................................................................................................................................................... 59 7.5.17 Java服务任务 ............................................................................................................................................. 59 描述 ................................................................................................................................................................ 59 图形化符号 .................................................................................................................................................... 59 XML表示 ........................................................................................................................................................ 60 实现 ................................................................................................................................................................ 60 小觑夜漫酒作伴，破晓黎明当笑言 iv 字段的注入 .................................................................................................................................................... 61 服务任务的结果 ............................................................................................................................................ 63 处理异常 ........................................................................................................................................................ 63 7.5.18 WebService任务 ......................................................................................................................................... 64 描述 ................................................................................................................................................................ 64 图形化符号 .................................................................................................................................................... 64 XML表示 ........................................................................................................................................................ 64 WebService任务的IO规范 ........................................................................................................................... 65 服务任务的数据输入关系 ............................................................................................................................. 65 服务任务的数据输出关系 ............................................................................................................................. 66 7.5.19 业务规则任务 ............................................................................................................................................ 66 描述 ................................................................................................................................................................ 67 图形化符号 .................................................................................................................................................... 67 XML表示 ........................................................................................................................................................ 67 7.5.20 Email任务 ................................................................................................................................................... 68 Mail服务器的配置 ........................................................................................................................................ 68 定义邮件任务 ................................................................................................................................................ 68 用法举例 ........................................................................................................................................................ 69 7.5.21 手动任务 .................................................................................................................................................... 70 描述 ................................................................................................................................................................ 70 图形化符号 .................................................................................................................................................... 70 XML表示 ........................................................................................................................................................ 70 7.5.22 Java接收任务 ............................................................................................................................................. 71 描述 ................................................................................................................................................................ 71 图形化符号 .................................................................................................................................................... 71 XML表示 ........................................................................................................................................................ 71 7.5.23 执行（execution）监听器 ......................................................................................................................... 71 执行监听器上的字段注入 ............................................................................................................................. 73 7.5.24 任务监听器 ................................................................................................................................................ 74 7.5.25 多实例（for each） ................................................................................................................................... 75 描述 ................................................................................................................................................................ 75 图形化符号 .................................................................................................................................................... 76 XML表示 ........................................................................................................................................................ 76 边界事件与多实例 ........................................................................................................................................ 77 7.5.26 边界事件 .................................................................................................................................................... 78 7.5.27 定时器边界事件 ........................................................................................................................................ 78 描述 ................................................................................................................................................................ 78 图形化符号 .................................................................................................................................................... 79 XML表示 ........................................................................................................................................................ 79 使用边界事件的已知问题 ............................................................................................................................. 80 7.5.28 Error边界事件 ............................................................................................................................................ 80 描述 ................................................................................................................................................................ 80 图形化符号 .................................................................................................................................................... 81 XML表示 ........................................................................................................................................................ 81 示例 ................................................................................................................................................................ 81 7.5.29 中间媒介捕获事件（intermediate catching events） .............................................................................. 82 小觑夜漫酒作伴，破晓黎明当笑言 v 7.5.30 定时器中间媒介捕获事件（Timer intermediate catching event） .......................................................... 82 描述 ................................................................................................................................................................ 82 图形化符号 .................................................................................................................................................... 82 XML表示 ........................................................................................................................................................ 83 7.5.31 子流程 ........................................................................................................................................................ 83 描述 ................................................................................................................................................................ 83 图形化符号 .................................................................................................................................................... 83 XML表示 ........................................................................................................................................................ 85 7.5.32 调用活动（子流程） ................................................................................................................................ 85 描绘 ................................................................................................................................................................ 85 图形化符号 .................................................................................................................................................... 85 XML表示 ........................................................................................................................................................ 86 传递变量 ........................................................................................................................................................ 86 示例 ................................................................................................................................................................ 86 第八章、表单 ........................................................................................................................................................................ 88 8.1 内置的表单渲染 ..................................................................................................................................................... 88 8.2 外部的表单渲染 ..................................................................................................................................................... 94 8.3 表单属性 ................................................................................................................................................................. 95 第九章、JPA ........................................................................................................................................................................... 98 9.1 要求 ......................................................................................................................................................................... 98 9.2 配置 ......................................................................................................................................................................... 98 9.3 用法 ......................................................................................................................................................................... 99 9.3.1 简单示例 ...................................................................................................................................................... 99 9.3.2 查询JPA流程变量 ..................................................................................................................................... 101 9.3.3 使用Spring beans和JPA的高级示例 ....................................................................................................... 101 第十章、历史（History） .................................................................................................................................................. 104 10.1 查询历史 ............................................................................................................................................................. 104 10.1.1 HistoricProcessInstanceQuery .................................................................................................................... 104 10.1.2 HistoricActivityInstanceQuery .................................................................................................................... 104 10.1.3 HistoricDetailQuery ................................................................................................................................... 105 10.1.4 HistoricTaskInstanceQuery ......................................................................................................................... 105 10.2 历史的配置 ......................................................................................................................................................... 106 10.3 审查目的的历史 ................................................................................................................................................. 106 第十一章、Eclipse Designer ................................................................................................................................................ 108 11.1 安装 ..................................................................................................................................................................... 108 11.2 Activiti Designer编辑器的特性 ............................................................................................................................ 109 11.3 Activiti Designer的BPMN特性 ............................................................................................................................ 113 11.4 Activiti Designer的部署特性 ............................................................................................................................... 116 11.5 扩展Activiti Designer .......................................................................................................................................... 117 11.5.1 定制画板 .................................................................................................................................................. 118 11.5.1.1 扩展的设置（Eclipse/Maven）..................................................................................................... 118 11.5.1.2 将扩展应用到Activiti Designer ..................................................................................................... 120 11.5.1.3 向画板添加形状 ............................................................................................................................ 122 11.5.1.4 属性的类型 ................................................................................................................................... 125 11.5.1.5 禁用画板中默认形状 .................................................................................................................... 128 11.5.2 校验图形和导出到自定义的输出格式 ................................................................................................... 130 小觑夜漫酒作伴，破晓黎明当笑言 vi 11.5.2.1 创建ProcessValidator扩展 ........................................................................................................... 131 11.5.2.2 创建ExportMarshaller扩展 .......................................................................................................... 132 第十二章、Activiti Modeler ................................................................................................................................................ 134 12.1 修改流程模型库的位置 ..................................................................................................................................... 134 12.2 修改Modeler的主机 ......................................................................................................................................... 134 12.3 为Activiti Modeler配置Apache Tomcat ............................................................................................................ 135 第十三章、Activiti Cycle ..................................................................................................................................................... 136 13.1 概述 ..................................................................................................................................................................... 136 13.2 仓库 ..................................................................................................................................................................... 137 13.3 构建和行为 ......................................................................................................................................................... 138 13.4 更多插件 ............................................................................................................................................................. 139 第十四章、REST API ............................................................................................................................................................ 140 14.1 仓库 ..................................................................................................................................................................... 140 14.1.1 上传部署 .................................................................................................................................................. 140 14.1.2 获取部署 .................................................................................................................................................. 141 14.1.3 获取部署资源 .......................................................................................................................................... 141 14.1.4 删除部署 .................................................................................................................................................. 142 14.1.5 删除多个部署 .......................................................................................................................................... 142 14.2 引擎 ..................................................................................................................................................................... 142 14.2.1 获取流程引擎 .......................................................................................................................................... 142 14.3 流程 ..................................................................................................................................................................... 143 14.3.1 列出流程定义 .......................................................................................................................................... 143 14.3.2 获得流程定义 .......................................................................................................................................... 143 14.3.3 获得流程定义表单 .................................................................................................................................. 144 14.3.4 启动流程实例 .......................................................................................................................................... 144 14.3.5 列出流程实例 .......................................................................................................................................... 145 14.3.6 获得流程实例图 ...................................................................................................................................... 146 14.4 任务 ..................................................................................................................................................................... 146 14.4.1 获取任务概述 .......................................................................................................................................... 146 14.4.2 列出任务 .................................................................................................................................................. 146 14.4.3 获得任务 .................................................................................................................................................. 147 14.4.4 获得任务表单 .......................................................................................................................................... 148 14.4.5 执行任务操作 .......................................................................................................................................... 148 14.4.6 列出表单属性 .......................................................................................................................................... 148 14.5 身份 ..................................................................................................................................................................... 149 14.5.1 登陆 .......................................................................................................................................................... 149 14.5.2 获得用户 .................................................................................................................................................. 149 14.5.3 列出用户的组 .......................................................................................................................................... 149 14.5.4 获取组 ...................................................................................................................................................... 150 14.5.5 列出组内的用户 ...................................................................................................................................... 150 14.6 管理 ..................................................................................................................................................................... 151 14.6.1 列出作业 .................................................................................................................................................. 151 14.6.2 获得作业 .................................................................................................................................................. 152 14.6.3 执行作业 .................................................................................................................................................. 152 14.6.4 执行多个作业 .......................................................................................................................................... 152 14.6.5 列出数据库表 .......................................................................................................................................... 153 小觑夜漫酒作伴，破晓黎明当笑言 vii 14.6.6 获得表的元数据 ...................................................................................................................................... 153 14.6.7 获得表数据 .............................................................................................................................................. 153 第十五章、Activiti Explorer ................................................................................................................................................ 155 15.1 概述 ..................................................................................................................................................................... 155 15.2 任务的管理 ......................................................................................................................................................... 155 15.3 启动流程 ............................................................................................................................................................. 155 第十六章、Activiti Probe .................................................................................................................................................... 157 16.1 概述 ..................................................................................................................................................................... 157 16.2 流程引擎的状态 ................................................................................................................................................. 157 16.3 作业管理 ............................................................................................................................................................. 157 16.4 部署 ..................................................................................................................................................................... 158 16.5 数据库 ................................................................................................................................................................. 159 16.6 流程 ..................................................................................................................................................................... 160 第十七章、Activiti KickStart ................................................................................................................................................ 161 17.1 概述 ..................................................................................................................................................................... 161 17.2 修改数据库 ......................................................................................................................................................... 163 17.3 引用表单属性 ..................................................................................................................................................... 164 17.4 捕捉流程的启动程序 ......................................................................................................................................... 164 第十八章 JBPM迁移 .......................................................................................................................................................... 166 18.1 数据库迁移 ......................................................................................................................................................... 166 18.2 流程转换 ............................................................................................................................................................. 167 18.3 扩展迁移逻辑 ..................................................................................................................................................... 167 附录 ...................................................................................................................................................................................... 170 附录一 认识ant构建脚本 ......................................................................................................................................... 170 附录二 认识发布文件结构 ........................................................................................................................................ 171 翻译日程 .............................................................................................................................................................................. 172