Flowable BPMN 6.5.0-SNAPSHOT 用户手册：中文版与技术要点

需积分: 17 166 浏览量更新于2024-07-15 1 收藏 10.24MB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

资源详情

资源推荐

"value": "John Doe" }, { "name":"nrOfHolidays", "value": 7 }]}'

http://localhost:8080/flowable-rest/service/runtime/process-instances

将返回：

{"id":"43","url":"http://localhost:8080/flowable-rest/service/runtime/process-

instances/43","businessKey":null,"suspended":false,"ended":false,"processDefiniti

onId":"holidayRequest:1:42","processDefinitionUrl":"http://localhost:8080/flowabl

e-rest/service/repository/process-

definitions/holidayRequest:1:42","activityId":null,"variables":

[],"tenantId":"","completed":false}

2.4.4. 任务列表与完成任务任务列表与完成任务

当流程实例启动后，第一个任务会指派给’managers’组。要获取这个组的所有任务，可以通过REST API进行任务查询：

curl --user rest-admin:test -H "Content-Type: application/json" -X POST -d '{

"candidateGroup" : "managers" }' http://localhost:8080/flowable-

rest/service/query/tasks

这将返回’manager’组的所有任务的列表。

可以这样完成任务：

curl --user rest-admin:test -H "Content-Type: application/json" -X POST -d '{

"action" : "complete", "variables" : [ { "name" : "approved", "value" : true} ]

}' http://localhost:8080/flowable-rest/service/runtime/tasks/25

然而，很可能会产生如下的错误：

{"message":"Internal server error","exception":"couldn't instantiate class

org.flowable.CallExternalSystemDelegate"}

这意味着引擎无法找到服务任务引用的CallExternalSystemDelegate类。要解决这个错误，需要将该类放在应用的

classpath下（并需要重启应用）。按照上一章节的介绍创建该类，并将其打包为JAR，放在Tomcat的webapps目录下

的flowable-rest目录下的WEB-INF/lib目录下。

3. 配置配置

3.1. 创建创建ProcessEngine

Flowable流程引擎通过名为flowable.cfg.xml的XML文件进行配置。请注意这种方式与使用Spring创建流程引

擎不不一样。

获取ProcessEngine，最简单的方式是使用org.flowable.engine.ProcessEngines类：

1 ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine()

这样会从classpath寻找flowable.cfg.xml，并用这个文件中的配置构造引擎。下面的代码展示了一个配置的例子。

后续章节会对配置参数进行详细介绍。

<beans xmlns="http://www.springframework.org/schema/beans"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://www.springframework.org/schema/beans

http://www.springframework.org/schema/beans/spring-beans.xsd">

<bean id="processEngineConfiguration"

class="org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration">

<property name="jdbcUrl" value="jdbc:h2:mem:flowable;DB_CLOSE_DELAY=1000"

</bean>

</beans>

请注意这个配置XML文件实际上是一个Spring配置文件。但这并不意味着但这并不意味着Flowable只能用于只能用于Spring环境！环境！我们只是利

用Spring内部的解析与依赖注入功能来简化引擎的构建过程。

也可以通过编程方式使用配置文件，来构造ProcessEngineConfiguration对象。也可以使用不同的bean id(例如第3行)。

ProcessEngineConfiguration.

createProcessEngineConfigurationFromResourceDefault();

createProcessEngineConfigurationFromResource(String resource);

createProcessEngineConfigurationFromResource(String resource, String

beanName);

createProcessEngineConfigurationFromInputStream(InputStream inputStream);

createProcessEngineConfigurationFromInputStream(InputStream inputStream,

String beanName);

也可以不使用配置文件，使用默认配置（参考不同的支持类获得更多信息）。

ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();

ProcessEngineConfiguration.createStandaloneInMemProcessEngineConfiguration();

所有的ProcessEngineConfiguration.createXXX()方法都返回ProcessEngineConfiguration，并可以

继续按需调整。调用buildProcessEngine()后，生成一个ProcessEngine：

ProcessEngine processEngine =

ProcessEngineConfiguration.createStandaloneInMemProcessEngineConfiguration()

.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_FALSE)

.setJdbcUrl("jdbc:h2:mem:my-own-db;DB_CLOSE_DELAY=1000")

.setAsyncExecutorActivate(false)

.buildProcessEngine();

3.2. ProcessEngineConfiguration bean

flowable.cfg.xml文件中必须包含一个id为'processEngineConfiguration'的bean。

<bean id="processEngineConfiguration"

class="org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration">

这个bean用于构建ProcessEngine。有多个类可以用于定义processEngineConfiguration。这些类用于不同

的环境，并各自设置一些默认值。最佳实践是选择最匹配你环境的类，以便减少配置引擎需要的参数。目前可以使用的

类为：

org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration：流程引擎独立运行。Flowable自行处

理事务。在默认情况下，数据库检查只在引擎启动时进行（如果Flowable表结构不存在或表结构版本不对，会抛

出异常）。

org.flowable.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration：这是一个便于使用单元测试

的类。Flowable自行处理事务。默认使用H2内存数据库。数据库会在引擎启动时创建，并在引擎关闭时删除。使

用这个类时，很可能不需要更多的配置（除了使用任务执行器或邮件等功能时）。

org.flowable.spring.SpringProcessEngineConfiguration：在流程引擎处于Spring环境时使用。查看Spring集

成章节了解更多信息。

org.flowable.engine.impl.cfg.JtaProcessEngineConfiguration：用于引擎独立运行，并使用JTA事务的情况。

3.3. 配置数据库配置数据库

有两种方式配置Flowable引擎使用的数据库。第一种方式是定义数据库的JDBC参数：

jdbcUrl: 数据库的JDBC URL。

jdbcDriver: 对应数据库类型的驱动。

jdbcUsername: 用于连接数据库的用户名。

jdbcPassword: 用于连接数据库的密码。

通过提供的JDBC参数构造的数据源，使用默认的MyBatis连接池设置。可用下列属性调整这个连接池（来自MyBatis文

档）：

jdbcMaxActiveConnections: 连接池能够容纳的最大活动连接数量。默认值为10.

jdbcMaxIdleConnections: 连接池能够容纳的最大空闲连接数量。

jdbcMaxCheckoutTime: 连接从连接池“取出”后，被强制返回前的最大时间间隔，单位为毫秒。默认值为

20000（20秒）。

jdbcMaxWaitTime: 这是一个底层设置，在连接池获取连接的时间异常长时，打印日志并尝试重新获取连接（避

免连接池配置错误，导致没有异常提示）。默认值为20000（20秒）。

数据库配置示例：

我们的跑分显示MyBatis连接池在处理大量并发请求时，并不是最经济或最具弹性的。因此，建议使

用javax.sql.DataSource的实现，并将其注入到流程引擎配置中（如Hikari、Tomcat JDBC连接池，等等）：

</bean>

<bean id="processEngineConfiguration"

class="org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration">

...

请注意Flowable发布时不包括用于定义数据源的库。需要自行把库放在classpath中。

无论使用JDBC还是数据源方式配置，都可以使用下列参数：

databaseType: 通常不需要专门设置这个参数，因为它可以从数据库连接信息中自动检测得出。只有在自动检测

失败时才需要设置。可用值：{h2, mysql, oracle, postgres, mssql, db2}。这个选项会决定创建、删除与查询时使

用的脚本。查看“支持的数据库”章节了解我们支持哪些类型的数据库。

databaseSchemaUpdate: 用于设置流程引擎启动关闭时使用的数据库表结构控制策略。

false (默认): 当引擎启动时，检查数据库表结构的版本是否匹配库文件版本。版本不匹配时抛出异常。

true: 构建引擎时，检查并在需要时更新表结构。表结构不存在则会创建。

create-drop: 引擎创建时创建表结构，并在引擎关闭时删除表结构。

3.4. 配置配置JNDI数据源数据源

默认情况下，Flowable的数据库配置保存在每个web应用WEB-INF/classes文件夹下的db.properties文件中。有时这样

并不合适，因为这需要用户修改Flowable源码中的db.properties文件并重新编译war包，或者在部署后解开war包并修改

db.properties文件。

通过使用JNDI（Java Naming and Directory Interface，Java命名和目录接口）获取数据库连接，连接就完全交由

Servlet容器管理，并可以在WAR部署之外管理配置。同时也提供了比db.properties中更多的控制连接的参数。

3.4.1. 配置配置

根据你使用的servlet容器应用不同，配置JNDI数据源的方式也不同。下面的介绍用于Tomcat，对于其他容器应用，请

参考对应的文档。

Tomcat的JNDI资源配置在$CATALINA_BASE/conf/[enginename]/[hostname]/[warname].xml (对于Flowable UI通常会是

$CATALINA_BASE/conf/Catalina/localhost/flowable-app.xml)。当应用第一次部署时，默认会从Flowable war包中复制

context.xml。所以如果存在这个文件则需要替换。例如，如果需要将JNDI资源修改为应用连接MySQL而不是H2，需要

如下修改：

<?xml version="1.0" encoding="UTF-8"?>

<Resource auth="Container"

name="jdbc/flowableDB"

type="javax.sql.DataSource"

description="JDBC DataSource"

url="jdbc:mysql://localhost:3306/flowable"

driverClassName="com.mysql.jdbc.Driver"

username="sa"

password=""

defaultAutoCommit="false"

initialSize="5"

maxWait="5000"

maxActive="120"

maxIdle="5"/>

</Context>

3.4.2. JNDI参数参数

在Flowable UI的配置文件中使用下列参数配置JNDI数据源：

spring.datasource.jndi-name=: 数据源的JNDI名

datasource.jndi.resourceRef: 设置是否在J2EE容器中查找。也就是说，如果JNDI名中没有包

含"java:comp/env/"前缀，是否需要添加它。默认为"true"。

3.5. 支持的数据库支持的数据库

下面列出Flowable用于引用数据库的类型（区分大小写！）。

Flowable数据库类型数据库类型示例示例JDB C URL 备注备注

h2 jdbc:h2:tcp://localhost/flowable 默认配置的数据库

剩余422页未读，继续阅读

KeepHealth

粉丝: 2
资源: 5

Flowable BPMN 6.5.0-SNAPSHOT 用户手册：中文版与技术要点

Flowable BPMN 用户手册

Flowable用户手册中文版（pdf+html）

Flowable BPMN 用户手册 中文版 (v 6.3.0).pdf

flowable bpmn 用户手册 pdf

flowable bpmn离线手册

flowable-engine-flowable-.tar.gz

flowable-6.7.2.zip

启动项目里面apache-tomcat-9.0.73-flowable如何用Tomcat启动

org.flowable:flowable-spring-boot-starter-basic

集成flowable-spring-boot-starter-process

如何在springboot中整和flowable-ui

flowable bpmn visualizer 绘制bpmn文件

flowable框架实例ID控制

activiti5.22 数据迁移至flowable

Flowable 6.8 怎么启动

flowable启动配置

springboot 集成flowable 依赖

flowable-spring-boot-starter-process 页面流程设计

Flowable 6.5 h2数据库配置在哪里

最新资源

Flowable BPMN 用户手册中文版 (v 6.3.0).pdf