1、介绍
Flowable提供了几个Web应用程序来演示和利用Flowable项目提供的功能：
- 可流动的IDM：一种身份管理应用程序，为所有Flowable UI应用程序提供单一登录身份验证功能，对于具有IDM管理权限的用户，还提供管理用户，组和特权的功能。
- Flowable Modeler：一个允许具有建模者权限的用户对流程，表单，决策表和应用程序定义进行建模的应用程序。
- Flowable Task：一个运行时任务应用程序，提供启动流程实例，编辑任务表单，完成任务和查询任务和流程实例的功能。
- Flowable Admin：一个管理应用程序，允许具有管理权限的用户查询BPMN，DMN，表单和内容引擎，并提供多个选项来更改流程实例，任务，作业等。管理应用程序通过与Flowable Task应用程序和Flowable REST应用程序一起部署的REST API连接到引擎。
所有其他应用程序都需要Flowable IDM来启用身份验证。每个应用程序的WAR文件可以部署到相同的servlet容器（如Apache Tomcat），但也可以部署在不同的servlet容器上。由于每个应用都使用相同的cookie进行身份验证，因此应用需要在同一个域上运行。
2、安装
如前所述，所有四个UI应用程序可以一起部署在同一个Tomcat服务器上，要开始这可能是最简单的方法。例如，您可以选择仅安装Modeler应用程序，但要确保Flowable IDM应用程序始终在运行/部署。对于本安装指南，我们将描述将所有四个应用程序安装到Tomcat服务器。
- 下载最新的Apache Tomcat稳定版本。
- 下载最新的稳定的Flowable 6版本。
- 将Flowable-admin.war，flowable-idm.war，flowable-modeler.war和flowable-task.war文件从Flowable distribution wars文件夹复制到Tomcat webapps文件夹。
- 运行bin / startup.sh（Mac OS和Linux）或bin / startup.bat（Windows）脚本来启动Tomcat服务器。
- 打开网页浏览器并转到 http：// localhost：8080 / flowable-modeler。
现在，所有Flowable UI应用程序都应该使用H2内存数据库运行，并且以下登录屏幕应显示在您的Web浏览器中：
默认情况下，Flowable IDM应用程序将创建一个具有所有Flowable UI应用程序权限的管理员用户。您可以使用admin / test登录，浏览器应该重定向到Flowable Modeler应用程序：
通常，您需要将默认的H2内存数据库配置更改为MySQL或Postgres（或其他持久数据库）配置。您可以通过更改每个应用程序的WEB-INF /
classes / META-INF目录中的flowable-ui-app.properties文件来为每个应用程序执行此操作。但是从其中一个应用程序复制flowable-uiapp.properties文件或从Github获取它并将其放在Tomcat的lib文件夹中更容易。UI应用程序将首先直接查看类路径上可用的flowable-uiapp.properties文件，该配置将优先于WAR中的配置文件。要将默认配置更改为MySQL，需要对属性文件进行以下更改：
datasource.driver=com.mysql.jdbc.Driver
datasource.url=jdbc:mysql://127.0.0.1:3306/flowable?characterEncoding=UTF-8
datasource.username=flowable datasource.password=flowable
这种配置将期望在MySQL服务器中存在可流动的数据库，UI应用程序将自动生成必要的数据库表。对于Postgres，以下更改是必要的：
datasource.driver=org.postgresql.Driver
datasource.url=jdbc:postgresql://localhost:5432/flowable
datasource.username=flowable datasource.password=flowable
除了更改配置之外，请确保数据库驱动程序在类路径中可用。再一次，您可以通过将驱动程序JAR文件添加到WEB-INF / lib文件夹来单独为每个Web应用程序执行此操作，但是也可以将JAR文件一次复制到Tomcat lib文件夹。对于MySQL和Postgres，可以从以下位置下载数据库驱动程序：
- MySQL的： https://dev.mysql.com/downloads/connector/j
- Postgres的： https://jdbc.postgresql.org/
下表中介绍了其他配置选项：
| 属性名称 | 描述 |
|---|---|
| security.rememberme.key | Spring Security使用的散列键在应用程序中散列密码值。确保您更改此属性的值。 |
| security.passwordencoder | 为IDM用户定义一个密码编码器。使用spring_bcrypt的值来使用Spring密码编码器。默认情况下，密码将以纯文本格式保存。 |
| datasource.jndi.name | 数据源的JNDI名称，在servlet容器中配置数据源时使用，而不是在此配置文件中定义数据源url和驱动程序 |
| datasource.jndi.resourceRef | 设置查找是否发生在J2EE容器中，即如果JNDI名称尚未包含前缀，则需要添加前缀“java：comp / env /”。默认值是“true”。 |
| datasource.driver | JDBC驱动程序类名称 |
| datasource.url | JDBC驱动程序网址 |
| datasource.username | 用于JDBC连接的用户名 |
| datasource.password | 用于JDBC连接的密码 |
| datasource.min池大小 | 最小的数据源池大小 |
| datasource.max池大小 | 最大的数据源池大小 |
| datasource.acquire增量 | 确定c3p0在池耗尽时将尝试获取多少个连接 |
| datasource.preferred测试查询 | 定义将为所有连接测试执行的查询 |
| datasource.test-连接上签 | 入住游泳池时测试连接 |
| datasource.test连接上结帐 | 测试从池中结帐的连接 |
| datasource.max空闲时间 | 秒连接可以保持汇集，但未被使用之前被丢弃。零意味着空闲连接永不过期 |
| datasource.max空闲时间过剩的连接 | 超过minPoolSize的连接数应该被允许在被剔除之前在池中保持空闲的秒数 |
| email.host | Flowable Task应用程序电子邮件服务任务的电子邮件服务器的主机名 |
| email.port | 电子邮件服务器的端口 |
| email.useCredentials | 电子邮件服务器是否需要验证？ |
| email.username | 电子邮件服务器连接的用户名 |
| email.password | 电子邮件服务器连接的密码 |
| flowable.process-definitions.cache.max | 定义进程定义缓存中可用的最大进程定义数量 |
| admin.userid | Flowable IDM应用程序的默认管理员用户的用户名。默认是admin。 |
| admin.password | Flowable IDM应用程序的默认管理员用户的密码。默认是测试。 |
| admin.firstname | Flowable IDM应用程序的默认管理员用户的名字。默认是测试。 |
| admin.lastname | Flowable IDM应用程序的默认管理员用户的姓氏。默认是管理员。 |
| admin.email | Flowable IDM应用程序的默认管理员用户的电子邮件。默认是admin@flowable.org。 |
| file.upload.max.size | 文件上传的最大尺寸，例如附件和模型文件 |
| contentstorage.fs.rootFolder | 存放内容文件的根文件夹位置，例如，任务附件或表单文件上载 |
| contentstorage.fs.createRoot | 如果根文件夹不存在，Flowable Task应用程序是否应该创建它？ |
| idm.app.url | IDM应用程序的URL，用于cookie未设置或无效时的登录重定向，以及用户信息和令牌信息REST GET调用。 |
| idm.admin.user | 用于执行REST调用（使用基本身份验证）到IDM REST服务的用户名。默认是admin。 |
| idm.admin.password | 用于对IDM REST服务执行REST调用（使用基本身份验证）的密码。默认是测试。 |
| deployment.api.url | Flowable引擎的REST服务的根URI，由Flowable Modeler应用程序用于将应用程序定义BAR文件部署到引擎。Flowable Task应用程序的默认URL是http：// localhost：8080 / flowable-task / process-api |
除了由多个Flowable Web应用程序使用的这些属性之外，Flowable管理应用程序还具有其他一些属性。属性文件的完整内容可以在Github上查看。附加属性主要用于定义不同引擎的REST端点的初始值。Admin应用程序使用初始值与Flowable引擎建立连接，但可以在Admin应用程序配置视图中覆盖这些值，这些值存储在ACT \ _ADM \ _SERVER \ _CONFIG表中。下面显示了BPMN引擎REST属性的一个示例：
rest.process.app.name=Flowable Process app
rest.process.app.description=Flowable Process REST config
rest.process.app.host=http://localhost rest.process.app.port=8080
rest.process.app.contextroot=flowable-task
rest.process.app.restroot=process-api rest.process.app.user=admin
rest.process.app.password=test
当Flowable Task应用程序（包括所有Flowable引擎）由Flowable Admin应用程序管理时，可以使用这些值。
上面文章来自盘古BPM研究院：http://vue.pangubpm.com/
文章翻译提交：https://github.com/qiudaoke/flowable-userguide
了解更多文章可以关注微信公众号：