自定义表单引擎是什么
流程实例按步骤执行时,需要保存并使用一些数据,在Flowable中,这些数据称为变量( variable )。
流程实例可以持有变量,称作流程变量( process variables )。
为了使用效率,Flowable将变量分为两种:运行时变量、历史变量。
流程实例运行时的变量,存入act_ru_variable表中。在流程实例运行结束时,此实例的变量在表中删除。
在流程实例创建及启动时,可设置流程变量。所有的 startProcessInstanceXXX 方法都有一个可选参数用于设置变量。例如,在 RuntimeService 中:
也可以在流程执行中加入变量。例如,( RuntimeService ):
读取变量方法(请注意 TaskService 中有类似的方法。这意味着任务与执行一样,可以持有局部变量,其生存期为任务持续的时间。)
历史变量,存入act_hi_varinst表中。在流程启动时,流程变量会同时存入历史变量表中;在流程结束时,历史表中的变量仍然存在。可理解为“永久代”的流程变量。
获取已完成的、id为’XXX’的流程实例中,所有的HistoricVariableInstances(历史变量实例),并以变量名排序。
在实际业务中,流程伴随着各种各样的表单,Flowable引擎将表单数据统一作为流程变量存入变量表中。所以,对于Flowable引擎,可以完全独立于表单运行,因为可以用流程变量替代表单数据。
但一般的,我们需要结构化的数据,表单仍然是我们推荐的用法。
表单定义有两种方法,内置表单和外部表单。
以请假为例,XML内容:
使用方法:
或
内置表单了解即可,实际应用更多的是使用外部表单。
根据表单文件自行渲染的任务表单,称为外部表单。
在springboot环境下, resources/forms 目录下任何.form后缀的表单定义文件都会被自动部署。
例如,将2.2.2表单定义内容保存为leave.form文件,放入 resources/forms 目录下。
实际上,渲染表单所需的所有数据都组装在下面两个方法:
可以通过下面两个方法提交表单参数:
表单参数FormProperty的具体信息:
获取指定流程实例的表单数据的方法:
提交表单数据的方法:
表单数据实际存放在流程变量表,所以,用流程变量的方法同样可以获取及提交表单数据。
表单支持以下类型字段
在实际应用中,Flowable提供的表单字段类型并不能完全满足需求,往往我们需要自定义表单字段类型。
所有自定义字段类型需要继承一个表达类型抽象类“org.flowable.engine.form.AbstractFormType”。
比如,定义一个"卡片"自定义类型:
新建配置类,注册自定义字段类型解析类
Flowable支持自定义表单引擎以适应各种场景。只需要实现接口org.flowable.engine.impl.form.FormEngine,然后在引擎中注册自定义的表单引擎实现类即可。
注册方法与自定义表单字段类型相似,在配置类中加入以下语句:
使用方法:
通过本篇,我们了解到了表单和流程变量的具体使用,同样的,在实际业务使用中,还需要不少优化。比如,我们可以在formKey中保存通用的key,通过算法或转换得到实际需要使用的表单模板,在普通屏幕尺寸的Web应用中显示一个表单,在手机等小屏幕中显示另一个表单。还有下一篇将讲到的“集成JPA”,进一步对表单和流程变量的使用做出优化。