Flowable入门系列文章84 - 流动的UI应用程序

Posted 2022-01-05 分享牛

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服务器。

1. 下载最新的Apache Tomcat稳定版本。
2. 下载最新的稳定的Flowable 6版本。
3. 将Flowable-admin.war，flowable-idm.war，flowable-modeler.war和flowable-task.war文件从Flowable distribution wars文件夹复制到Tomcat webapps文件夹。
4. 运行bin / startup.sh（Mac OS和Linux）或bin / startup.bat（Windows）脚本来启动Tomcat服务器。
5. 打开网页浏览器并转到 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应用程序的默认管理员用户的电子邮件。默认是[e-mail]。
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
了解更多文章可以关注微信公众号：