[TOC]
本文为稀土掘金技术社区首发签约文章,14天内禁止转载,14天后未获授权禁止转载,侵权必究!
本专栏第一篇已发布,尚未看过的小伙伴请移步这里:
在我们使用 Flowable 的过程中,最重要的流程绘制工具就是 Flowable-UI 了,虽然我们在上篇文章和大伙也介绍了不少流程绘制工具,但是个人感觉,还是 Flowable-UI 更好用一些。
今天我们就来聊聊 Flowable-UI 的一些玩法。
Flowable-UI 说白了就是一堆 Web 应用,它主要提供了四方面的功能:
简单来说:
在之前的版本中,前面说的这几个应用都是不同的 war 包,部署和访问都非常麻烦,不过现在,官方将之前的 5 个 war 整合成一个了,所以现在访问就非常容易了。
由于这些应用是基于 Spring Boot2.0 开发的,因此也可以直接作为独立应用来直接运行,通过执行 java -jar xxx.war
的方式来启动这些应用。
这个需要大家首先去 GitHub 上下载最新的 Flowable:
下载成功之后解压,里边有一个 wars 文件夹,该文件夹中就有我们需要的 war 包,如下:
然后进入到该目录中,执行如下命令启动该 war 文件:
java -jar flowable-ui.war
复制代码
从启动到日志中我们就可以看出来这是一个 Spring Boot:
既然是一个 Spring Boot,那么如果又一些参数想改,就可以直接在启动命令中修改,例如默认的端口号是 8080,现在想改为 8088,那么就在启动命令中添加参数 --server.port=8088
即可。
所以直接启动这些应用并不是麻烦事,反而是比较简单的。
需要说明的是,有的小伙伴在网上看到的教程里边可能提到了多个 war 包,这是因为 Flowable 的历史问题,早期的 Flowable 上面我们说的四个功能都对应了不同的 war 包,要单独部署,但是在新版中合成一个了,新版用起来相对更方便一些。
我看了下他这个还支持 Docker 安装,所以我还是用 Docker 吧,更省事,将来不想要了删除也方便(对 Docker 不熟悉的小伙伴可以在微信公众号后台回复 docker,有松哥写的入门教程)。
docker 安装的话,直接如下命令即可:
docker run -d --name flowableui -p 8086:8080 flowable/flowable-ui
复制代码
没什么特别需要配置的地方,指定一下容器名字和端口映射即可。
无论是直接运行还是 Docker 运行,运行成功之后,浏览器输入 http://localhost:端口/flowable-ui
进行访问,此时会弹出来如下页面:
默认情况下,登录的用户名是 admin,密码是 test,注意别把密码写错了。
登录成功之后,如果看到如下页面,就表示安装成功了(一般来说应该不会有安装问题):
装好之后,接下来我们就来逐步体验这里的功能,因为之前和小伙伴们讲过这里的大部分功能了,所以今天我主要和大家讲讲这里的身份管理和流程体验功能(因为流程体验中要用到身份管理)。
身份管理就是用户、用户组的管理,我们点进到身份管理页面之后,可以看到如下内容:
可以看到,默认只有一个 admin 用户,也就是我们刚刚登录时候的用户。
接下来点击左边的创建用户按钮,我们可以创建新的用户出来:
填入用户的基本信息和密码即可。
我一共创建了四个用户,最终结果如下:
接下来点击上面的组,我们可以创建用户组,这个用户组相当于我们在 vhr 中所说的角色,给用户分组,相当于给用户分配一个角色。
默认情况下,没有任何组,组是空的:
我们点击创建组按钮,先来创建一个经理组:
组添加成功之后,点击添加用户按钮,为用户组中添加用户:
假设 zhangsan 是经理,最终添加结果如下:
利用相同的方式,我再创建一个主管的组,并为之添加两个用户 lisi 和 wangwu。
我们前面创建的用户现在是没有任何权限的,例如现在如果使用 zhangsan/123 进行登录,登录成功后页面是空的,没有任何东西:
所以我们要为用户添加相应的权限。点击顶部的权限控制一栏,如下:
我们可以为这五种访问分别设置对应的用户/用户组:
以访问 idm 应用为例,在设置的时候,我们可以直接设置用户,也可以设置用户组,设置用户组的话,则这个组中的所有用户都能访问这个菜单项。
我这里设置的是经理和 javaboy 可以访问所有应用,而主管只可以访问 workflow 应用。
好啦,准备工作完成后,接下来我们就来绘制一个报销的流程图,这个流程图稍微复杂一些,并且带有表单,这是松哥之前从未写过的内容。
我先大致上用文字描述下我们的报销流程:
好啦,这就是我们一个大致的流程描述,接下来我们就在 Flowable-UI 中来绘制这样一个流程图我们来看下。
首先点击建模器应用程序,我们开始绘制:
点击右上角创建流程,创建一个流程:
然后就开始绘制。
首先第一步是用户提交报销材料,报销材料需要填写一个表单,所以我们在下面的属性中,找到表单引用,为这个用户任务设置一个外部表单:
如果有提前绘制好的表单,这里就会显示出来,那么直接引用即可,如果没有提前绘制好的表单,那么大家看到的就如同上图那样。
现在我们点击新表单,创建一个新表单:
为新表单设置名称、key 等内容:
创建成功之后,我们就可以看到表单设计页面了:
左边是表单组件区域,右边是表单绘制区域。思考用户需要提交哪些信息来报销,直接将相应的表单拖过来即可。
其实大家看最上面一栏的顶部菜单,也自动切换到表单菜单了,这也就意味着,当我们想要创建一个表单的时候,也可以不用从流程绘制那个入口进来,可以直接提前绘制好表单,然后在画流程的时候直接引用即可。
例如我首先拖一个文本框过来,作为用户名,然后点击右边的编辑按钮进行编辑,如下:
有如下属性:
好了,理解了这个,我们再来随便加两个组件,按照相同的思路进行配置:
报销金额,这是一个小数组件:
报销用途是一个多行文本组件:
最终设计结果如下:
标签后面有一个
*
表示这是一个必填项。
绘制完成后,点击左上角的保存按钮,保存成功后,会自动回到流程绘制页面。
接下来,我们还需要设置这个用户任务由谁来处理,如下:
很明显,这个流程是谁发起的,谁就来填写这个表单,所以,配置如下:
好了,这个用户任务就配置完成了,接下来要根据报销金额进行划分了,我一口气画完吧,再来和大家逐步分析:
先来看报销金额小于等于 1000 的那条线。
首先,我们要为这条线设置条件,也就是流程从互斥网关中出来之后,什么情况下会进入到主管审批这个节点中,选中这条出线,配置流条件,配置如下:
这里的 money 就是我们刚刚在表单中填写的 money,表单中各个字段的值,都会被映射成为一个流程变量,我们可以直接访问。
接下来配置主管审批,首先我们设置分配用户,即由谁来执行这个用户任务:
我们设置候选组为主管,也就是所有的主管都可以审批这个节点:
主管审批的时候,无非就是同意或者拒绝,通过表单我们可以定义出同意或者拒绝这两个按钮。配置方式如下,首先为主管审批设置表单引用:
给这个新建的表单取一个名字和 id,这个 id 大家要记牢了,将来我们会用到:
在表单设计的页面,有一个结果选项卡,这个表示表单的输出内容,这个结果选项卡决定了这个表单上的最终按钮,默认情况下,只有一个完成按钮,我们可以自定义配置:
我们为这个表单设置同意和拒绝两个按钮,方式如下:
这块也有其他设置方式,我就先以这种方式来和大家演示,将来在视频中再来和大家聊一聊其他方式。
表单配置完成后,保存即可,保存之后,就会回到流程绘制页面。
接下来为同意这条出线设置条件:
大家注意这个表单的命名规则,是 form_表单名称_outcome
这个就表示表单的输出结果,也就是我们刚刚在表单中配置的结果选项卡中的内容:
配置完成后,相同的方式,将同意改为拒绝,再来配置一下拒绝那条线。
好啦,上面这条线配置好之后,接下来相同的方式配置下面大于 1000 的情况,其中经理这个用户任务就由经理这个组来处理,CEO 审批这个用户任务就由指定用户 javaboy 来审批即可,具体细节我就不多说了,都跟上面一样。
绘制完成后,记得点一下左上角的勾,看下流程有没有漏洞,如下图:
至此,我们的流程图就画好了。
一个流程图只能有一个开始,但是可以有多个结束。
流程图画好之后,接下来我们可以下载这个流程图对应的 XML 文件,然后去开发自己的 Java 代码。但是,这不是我们本文的工作,本文的工作是直接在 Flowable-UI 这个工具中,创建一个应用,然后发布这个流程。
点击上面的应用程序菜单,然后点击右上角的创建应用程序按钮,如下:
接下来可以为你的应用设置图标、主题啥的:
然后点击编辑包含的模型按钮,为这个应用选择一个流程:
然后点击左上角的保存按钮,保存并发布这个应用,如下:
发布成功之后,回到首页,就可以看到这个应用了,如下:
接下来我们就来体验一把这个报账流程,我们目前的身份是 admin,也就是说 admin 这个用户现在要报账了。
首先点击应用图标,进入到应用中,任务是空的,也就是目前没有 admin 需要审批的任务:
然后我们点击上方的流程菜单,如下:
首先点击左边的启动流程,然后点击右边的启动流程,流程启动之后,我们可以点击右上角的显示图按钮,查看流程目前走到哪一步了:
可以看到,流程目前走到用户提交报销材料这一步了:
用户提交报销材料这一步是由流程的发起人完成的,也就是 admin 自己完成,此时我们回到任务菜单,就可以看到 admin 有需要完成的任务了:
填入报销资料,然后点击完成按钮。
接下来再点击流程菜单,查看流程图,可以看到,此时进入到主管审批这一步了:
按照我们第 3 小节的配置,lisi 和 wangwu 是主管,所以,我们先注销登录,然后重新以 lisi 或者 wangwu 的身份登录,假设我这里以 lisi 的身份登录,登录成功之后,进入到这个应用中,进来之后,首先将筛选规则改为我是其中一个候选人的任务:
然后在任务中就可以看到自己需要处理的任务了:
对于这种候选人或者候选组的任务,需要先点击右上角的认领,然后再处理(如果是直接分配给某一个用户的,就不需要认领了,可以直接处理了),认领之后,就可以选择同意或者拒绝了,如下图:
假设我们点击拒绝按钮,拒绝之后,我们点击流程菜单,查看流程图,如下:
可以看到,流程在进入到主管审批这个节点之后,被拒绝了,然后回到了用户提交报销材料这个节点上,现在 admin 要重新登录,登录之后,在自己的任务中又可以看到提交报销材料了,如下:
随便改一下,然后继续提交。
切换到 wangwu 登录,同意报销,流程结束。
好啦,下面那条超过 1000 块钱的线,小伙伴们可以自行测试,我就不演示啦~
对于前面的案例,数据都存入到哪里去了呢?我们也来分析下。
如果是 war 包直接启动的话,它默认使用的是 H2 数据库,数据存在了系统当前用户目录下的 h2 文件夹里,我们通过 h2 数据库的连接工具即可操作这个数据库。IDEA 上自带的数据库连接工具就可以连接 H2 数据库,这里我就不演示具体连接方式了,我们来看下表的查询:
SELECT COUNT(*) TABLES, table_schema FROM information_schema.TABLES WHERE table_schema = 'flowable02' GROUP BY table_schema;
复制代码
这里显示了 82 张表,是因为我自己手动创建了三个跟用户相关的表,其他 79 张表都是 Flowable 自动创建的。
好了,接下来我们就对这 79 张表进行一个简单的分类整理。
ACT_APP_*
(5)ACT_CMMN_*
(12)ACT_CO_*
(3)ACT_DMN_*
(6)ACT_EVT_*
(1)ACT_FO_*
(6)ACT_GE_*
(2)ACT_HI_*
(10)ACT_ID_*
(9)ACT_PROCDEF_*
(1)ACT_RE_*
(3)ACT_RU_*
(13)FLW_CHANNEL_*
(1)FLW_EV_*
(2)FLW_EVENT_*
(3)FLW_RU_*
(2)*
是通配符,后面的数字表示这种类型的表有多少个。
大致看一下,其实还是有很多规律的。
最明显的规律就表名通过两个 _
隔开成了三部分,接下来我们就以此为线索,一部分一部分来讲。
首先搭建看这个表的前缀,分了两种:
松哥在之前的文章中已经和大家介绍过了,Flowable 是基于 Activiti 开发出来的流程引擎,所以我们在很多地方都还能看到 Activiti 的影子,这个表名中 ACT_
就是 Activiti。
具体来说,与 Flowable 开源代码库相关的数据库表名以 ACT_
开头。特定于 Flowable Work 或 Engage 的数据库表以 FLW_
前缀开头。
紧跟着 ACT_ 或者 FLW_ 后面的内容,基本上也都是简称,例如:
把这些简称的单词搞明白了,接下来的就容易看懂每一个表的含义了。
表名是由三部分构成的,我们现在已经分析了前两部分了,接下来我们来看第三部分。
表名的后缀,有一些是通用的后缀名词,我们先来看下。
这两个加起来就 12 张表了,一共 79 张,现在还剩 67 张,我们来详细看下。
在后面的介绍中,凡是涉及到 DATABASECHANGELOG 和 DATABASECHANGELOGLOCK 的表,我就直接省略了。
7.3.1 ACT_APP_*
以 ACT_APP_*
开头的表负责应用引擎存储和应用部署定义。相关的表一共是五张,如下:
ACT_APP_APPDEF
应用程序模型产生应用程序定义。此定义,如流程/案例/等。是成功部署到应用引擎的应用模型的表示。
ACT_APP_DEPLOYMENT
当通过应用引擎部署应用模型时,会存储一条记录以保存此部署。部署的实际内容被存储在 ACT_APP_DEPLOYMENT_RESOURCE 表中,并从该表中引用。
ACT_APP_DEPLOYMENT_RESOURCE
此表包含构成应用程序部署的实际资源(存储为字节)。当引擎需要实际模型时,将从该表中获取资源。
7.3.2 ACT_CMMN_*
Flowable CMMN Engine 的数据库名称都以 ACT_CMMN_
开头。这里涉及到一个东西就是 CMMN,CMMN 与 BPMN 协议一致,也是一种流程内容的规范,CMMN 这类表一般用于存储处理 BPMN 所不能适用的业务场景数据,CMMN 通常与 BPMN 搭配使用,不过只有符合 CMMN 规范的模型数据才会使用这类表。
这里涉及到的相关表一共是 12 张,如下:
这三个都是没有附加前缀的表,主要定义了静态信息,例如 case 的定义和部署和以及相关的资源等。
接下来这些以 ACT_CMMN_HI_
开头的表代表历史数据,例如过去的案例实例、计划项目等。
ACT_CMMN_HI_CASE_INST
此表记录由 CMMN 引擎启动的每个案例实例的数据。
ACT_CMMN_HI_MIL_INST
此表记录了在案例实例中达到的每个里程碑的数据。
ACT_CMMN_HI_PLAN_ITEM_INST
此表记录了作为案例实例执行的一部分创建的每个计划项实例的数据。
接下来以 ACT_CMMN_RU_
开始的表代表运行时的数据,这些数据包含案例实例、计划项等的运行时数据。Flowable 仅在案例实例执行期间存储运行时数据,并在案例实例结束时删除记录,这使运行时表保持小且查询速度快。
ACT_CMMN_RU_CASE_INST
此表包含每个已启动但尚未完成的案例实例的条目。
ACT_CMMN_RU_MIL_INST
此表包含作为运行案例实例的一部分达到的每个里程碑的条目。
ACT_CMMN_RU_PLAN_ITEM_INST
案例实例执行由案例定义中定义的计划项的多个实例组成,此表包含在案例实例执行期间创建的每个实例的条目。
ACT_CMMN_RU_SENTRY_PART_INST
计划项目实例可以有守卫状态转换的哨兵,这样的哨兵在状态改变之前可以包含多个部分,这个表就是专门用来存储这种哨兵。
7.3.3 ACT_DMN_*
Flowable DMN 的数据库名称都以 ACT_DMN_
开头,这里涉及到的表一共是 6 张:
这两个是就不需要我多说了吧,跟前面的都一样,只不过这里部署的是 DMN。
ACT_DMN_DECISION
此表包含已部署决策表的元数据,并与来自其他引擎的定义相对应。
ACT_DMN_HI_DECISION_EXECUTION
此表包含有关 DMN 决策表执行的审计信息。
7.3.4 ACT_RU_*
以 ACT_RU_
开头的表都是和流程引擎运行时信息相关的一些表。涉及到的表一共有 13 张:
ACT_RU_ACTINST
流程实例中的每个活动在此表中都有一行来指示活动的当前状态。
Flowable 引擎使用作业表来实现异步逻辑、计时器或历史处理。这些表存储每个作业所需的数据。
ACT_RU_ENTITYLINK
此表存储有关实例的父子关系的信息。例如,如果流程实例启动子案例实例,则此关系存储在此表中。这样可以轻松查询关系。
ACT_RU_EVENT_SUBSCR
当流程定义使用事件(信号/消息/等或启动/中间/边界)时,引擎将对该表的引用存储在该表中。这简化了查询哪些实例正在等待某种类型的事件。
ACT_RU_EXECUTION
存储流程实例和指向流程实例当前状态的指针(称为执行)。
ACT_RU_IDENTITYLINK
此表存储有关用户或组的数据及其与(流程/案例/等)实例相关的角色。该表也被其他需要身份链接的引擎使用。
ACT_RU_TASK
此表包含正在运行的实例的每个未完成用户任务的条目。然后在查询用户的任务列表时使用此表。CMMN 引擎也使用此表。
ACT_RU_VARIABLE
此表存储与实例相关的变量。 CMMN 引擎也使用此表。
7.3.5 ACT_HI_*
以 ACT_HI_*
开头的表包含正在运行和已完成的实例的历史数据,这些表的名称遵循其运行时对应的名称,这里一共涉及到 10 张表:
ACT_HI_ACTINST
历史活动信息。这里记录流程流转过的所有节点,与 ACT_HI_TASKINST 不同的是, ACT_HI_TASKINST 只记录 Task 内容。
ACT_HI_ATTACHMENT
历史附件表。
ACT_HI_COMMENT
流程的历史评论表。
ACT_HI_DETAIL
历史详情表:流程中产生的变量详细,包括控制流程流转的变量,业务表单中填写的流程需要用到的变量等。
ACT_HI_ENTITYLINK
历史参与的人员表。
ACT_HI_IDENTITYLINK
任务参与者数据表,主要存储历史节点参与者的信息,可能是 Group 也可能是 User。
ACT_HI_PROCINST
保存每一个历史流程,创建时就生成,一条流程实例对应一个记录。
ACT_HI_TASKINST
记录每一个历史节点,一个 Task 对应一个记录。
ACT_HI_TSK_LOG
每一次执行可能会带上数据,存在这里。
ACT_HI_VARINST
流程历史变量表。
7.3.6 ACT_ID_*
以 ACT_ID_*
开头的都是和用户身份相关的表,一共是有 9 张表:
ACT_ID_BYTEARRAY
这是用户组的部署内容。
ACT_ID_GROUP
这是用户组的表。
ACT_ID_INFO
这是所有的用户的信息,账号密码。
ACT_ID_MEMBERSHIP
用户和用户组的关联表。
ACT_ID_PRIV
权限表。
ACT_ID_PRIV_MAPPING
用户、用户组以及权限之间的关联表。
ACT_ID_PROPERTY
用户的变量表。
ACT_ID_TOKEN
用户访问记录表。
ACT_ID_USER
用户表。
7.3.7 ACT_FO_FORM_*
以 ACT_FO_FORM_
开头的表存储表单引擎和围绕表单模型和这些表单的实例数据。
ACT_FO_FORM_DEFINITION
表单定义表。
ACT_FO_FORM_DEPLOYMENT
表单部署表。
ACT_FO_FORM_INSTANCE
表单实例表。
ACT_FO_FORM_RESOURCE
表单源数据表。
7.3.8 ACT_GE_*
以 ACT_GE_
开头的表表示一些通用信息表,涉及到的表一共是两个。
ACT_GE_BYTEARRAY
存储每个流程的部署记录,bytes_ 字段中保存流程的具体内容。
ACT_GE_PROPERTY
存储 Flowable 自身的一些变量,主要是版本号。
7.3.9 ACT_RE_*
以 ACT_RE_
开头的表表示这些表都是跟流程的定义、流程的资源等等包含了静态信息相关的表。
ACT_RE_DEPLOYMENT
流程部署记录,每次服务重启会部署一次,这里会新增一条记录。
ACT_RE_MODEL
创建模型时,额外定义的一些模型相关信息,存在这张表,默认不保存。
ACT_RE_PROCDEF
记录流程的变更,流程每变更一次存一条记录,version_ 字段加 1。
7.3.10 FLW_EVENT_*
FLW_EVENT_DEFINITION
已部署事件定义的元数据。
FLW_EVENT_DEPLOYMENT
已部署事件部署元数据。
FLW_EVENT_RESOURCE
事件所需资源。
7.3.11 其他表
还剩一些规则不太明显的表,如下:
FLW_RU_BATCH FLW_RU_BATCH_PART
这两个是批量迁移流程时使用。
ACT_PROCDEF_INFO
流程定义信息,对流程的说明。
ACT_CO_CONTENT_ITEM
每项内容在此表中都有个条目。
ACT_EVT_LOG
Flowable 引入了事件日志机制,默认会在数据库中创建 ACT_EVT_LOG
表保存事件日志,如果不使用事件日志,则可以删除这个表。
FLW_CHANNEL_DEFINITION
泳池管道定义表。。