FlowableBPMN用户手册-中文版(v6.3.1).pdf_flowable中文文档pdf资源-CSDN文库

需积分: 50 189 浏览量 2020-07-15 10:14:58 上传评论收藏 10.81MB PDF 举报

资源推荐

资源详情

资源评论

1. 简简介介
1.1. 协议协议
Flowable在Apache V2 协议下发布。
1.2. 下下载载
http://www.flowable.org/downloads.html
1.3. 源源码码
Flowable的发布包里包含了大部分源码，以JAR文件方式提供。Flowable的源码也可以通过以下链接获得： https://github.com/flowable/flowable-engine
1.4. 必要的必要的软软件件
1.4.1. JDK 8+
运行Flowable需要JDK 8或以上版本。可以访问 Oracle Java SE downloads页面 点击“Download JDK”按钮获取。该页面上也有安装指导。安装完成后，可以执行 java -
version 。能看到JDK的版本信息就说明安装成功了。
1.4.2. IDE
可以自行选择用于Flowable开发的IDE。如果想要使用Flowable Designer，则需要Eclipse Mars或Neon。 到 Eclipse下载页面选择Eclipse版本并下载。解压下载的文件， 然
后执行eclipse文件夹下的eclipse文件。手册后续有专门一章介绍如何安装我们的Eclipse Designer插件。
1.5. 反反馈问题馈问题
我们希望开发者在报告或提问之前，先看看提问的智慧。
看完提问的智慧，你可以在用户论坛提问、评论以及提交改进建议，也可以在我们的Github问题跟踪系统创建bug报告。
1.6. 实验实验性功能性功能
标记有[实验实验性性]的章节介绍的功能还不够稳定。
.impl.包下的类都是内部实现类，不保证稳定。但是，在用户手册中作为配置参数介绍的类则是被官方支持的，可以保证稳定。
1.7. 内内部部实现类实现类
在JAR文件中，所有.impl.包下的类（比如org.flowable.engine.impl.db）都是实现类，只应在内部使用。实现类中的所有类或接口都不保证稳定。
1.8. 版本策略版本策略
使用三个整数的形式标记版本：MAJOR.MINOR.MICRO。其中 MAJOR版本代表核心引擎的演进。MINOR版本代表新功能与新API。MICRO版本代表bug修复与改进。
总的来说，Flowable希望在MINOR与MICRO版本中，对所有非内部实现类保持“源代码兼容性”，即应用可以正确构建，且不改变语义。Flowable也希望在MINOR与MICRO版
本中，保持“二进制兼容性”，即用新版本的Flowable直接替换老版本的Jar文件，仍然可以正常工作。
如果在MINOR版本中修改了API，将保留原有版本，并使用@Deprecated注解。这种废弃的API将在两个MINOR版本之后移除。
1.9. 翻翻译说译说明明
由 TKJohn 根据 官方userguide源码 翻译至简体中文，工程发布于 GitHub ，任何意见建议欢迎提issue。
页面发布链接为 https://tkjohn.github.io/
2. 开开始始
2.1. Flowable是什么？是什么？
Flowable是一个使用Java编写的轻量级业务流程引擎。Flowable流程引擎可用于部署BPMN 2.0流程定义（用于定义流程的行业XML标准）， 创建这些流程定义的流程实例，
进行查询，访问运行中或历史的流程实例与相关数据，等等。这个章节将用一个可以在你自己的开发环境中使用的例子，逐步介绍各种概念与API。
Flowable可以十分灵活地加入你的应用/服务/构架。可以将JAR形式发布的Flowable库加入应用或服务，来
嵌入
引擎。 以JAR形式发布使Flowable可以轻易加入任何Java环
境：Java SE；Tomcat、Jetty或Spring之类的servlet容器；JBoss或WebSphere之类的Java EE服务器，等等。 另外，也可以使用Flowable REST API进行HTTP调用。也有许
多Flowable应用（Flowable Modeler, Flowable Admin, Flowable IDM 与 Flowable Task），提供了直接可用的UI示例，可以使用流程与任务。
所有使用Flowable方法的共同点是核心引擎。核心引擎是一组服务的集合，并提供管理与执行业务流程的API。 下面的教程从设置与使用核心引擎的介绍开始。后续章节都建
立在之前章节中获取的知识之上。
第一节展示了以最简单的方式运行Flowable的方法：只使用Java SE的标准Java main方法。这里也会介绍许多核心概念与API。
Flowable REST API章节展示了如何通过REST运行及使用相同的API。
Flowable APP章节将介绍直接可用的Flowable UI示例的基本方法。
2.2. Flowable与与Activiti
Flowable是Activiti(Alfresco持有的注册商标)的fork。在下面的章节中，你会注意到包名，配置文件等等，都使用flowable。
2.3. 构建命令行程序构建命令行程序
2.3.1. 创创建流程引擎建流程引擎
在这个初步教程中，将构建一个简单的例子，以展示如何创建一个Flowable流程引擎，介绍一些核心概念，并展示如何使用API。 截图时使用的是Eclipse，但实际上可以使用
任何IDE。我们使用Maven获取Flowable依赖及管理构建，但是类似的任何其它方法也都可以使用（Gradle，Ivy，等等）。
我们将构建的例子是一个简单的
请假
(holiday request)流程：
雇员
(employee)申请几天的假期
经理
(manager)批准或驳回申请
我们会模拟将申请注册到某个外部系统，并给雇员发送结果邮件
首先，通过File → New → Other → Maven Project创建一个新的Maven项目

在下一界面中，选中'create a simple project (skip archetype selection)'

填入'Group Id'与'Artifact id':

这样就建立了空的Maven项目，然后添加两个依赖：

Flowable流程引擎。使我们可以创建一个ProcessEngine流程引擎对象，并访问Flowable API。

一个内存数据库。本例中为H2，因为Flowable引擎在运行流程实例时，需要使用数据库来存储执行与历史数据。请注意H2依赖包含了数据库

及

驱动。如果使用其他数据

库（例如PostgreSQL，MySQL等），需要添加对应的数据库驱动依赖。

在pom.xml文件中添加下列行：

<groupId>org.flowable</groupId>

<artifactId>flowable-engine</artifactId>

</dependency>

<groupId>com.h2database</groupId>

</dependency>

</dependencies>

如果由于某些原因，依赖JAR无法自动获取，可以右键点击项目，并选择'Maven → Update Project'以强制手动刷新（一般不会需要这么操作）。在这个项目中的'Maven

Dependencies'下，可以看到flowable-engine与许多其他（传递的）依赖。

创建一个新的Java类，并添加标准的Java main方法：

package org.flowable;

public class HolidayRequest {

public static void main(String[] args) {

}

首先要做的是初始化ProcessEngine流程引擎实例。这是一个线程安全的对象，因此通常只需要在一个应用中初始化一次。

ProcessEngine由ProcessEngineConfiguration实例创建。该实例可以配置与调整流程引擎的设置。通常使用一个配置XML文件创建ProcessEngineConfiguration，但是

（像在这里做的一样）也可以编程方式创建它。 ProcessEngineConfiguration所需的最小配置，是数据库JDBC连接：

package org.flowable;

import org.flowable.engine.ProcessEngine;

import org.flowable.engine.ProcessEngineConfiguration;

import org.flowable.engine.impl.cfg.StandaloneProcessEngineConfiguration;

public class HolidayRequest {

public static void main(String[] args) {

ProcessEngineConfiguration cfg = new StandaloneProcessEngineConfiguration()

.setJdbcUrl("jdbc:h2:mem:flowable;DB_CLOSE_DELAY=-1")

.setJdbcUsername("sa")

.setJdbcPassword("")

.setJdbcDriver("org.h2.Driver")

.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);

ProcessEngine processEngine = cfg.buildProcessEngine();

}

在上面的代码中，第10行创建了一个

独立

(standalone)配置对象。这里的'

独立

'指的是引擎是完全独立创建及使用的（而不是在Spring环境中使用，这时需要使

用SpringProcessEngineConfiguration类代替）。第11至14行中，传递了一个内存H2数据库实例的JDBC连接参数。重要：请注意这样的数据库在JVM重启后会消失。如果需

要永久保存数据，需要切换为持久化数据库，并相应切换连接参数。第15行中，设置了true，确保在JDBC参数连接的数据库中，数据库表结构不存在时，会创建相应的表结

构。另外，Flowable也提供了一组SQL文件，可用于手动创建所有表的数据库表结构。

然后使用这个配置创建ProcessEngine对象（第17行）。

这样就可以运行了。在Eclipse中最简单的方法是右键点击类文件，选择Run As → Java Application ：

应用运行没有问题，但也没有在控制台提供有用的信息，只有一条消息提示日志没有正确配置：

Flowable使用SLF4J作为内部日志框架。在这个例子中，我们使用log4j作为SLF4J的实现。因此在pom.xml文件中添加下列依赖：

</dependency>

</dependency>

Log4j需要一个配置文件。在src/main/resources文件夹下添加log4j.properties文件，并写入下列内容：

log4j.rootLogger=DEBUG, CA

log4j.appender.CA=org.apache.log4j.ConsoleAppender

log4j.appender.CA.layout=org.apache.log4j.PatternLayout

log4j.appender.CA.layout.ConversionPattern= %d{hh:mm:ss,SSS} [%t] %-5p %c %x - %m%n

重新运行应用。应该可以看到关于引擎启动与创建数据库表结构的提示日志：

这样就得到了一个启动可用的流程引擎。接下来为它提供一个流程！

2.3.2. 部署流程定部署流程定义义

我们要构建的流程是一个非常简单的请假流程。Flowable引擎需要流程定义为BPMN 2.0格式，这是一个业界广泛接受的XML标准。在Flowable术语中，我们将其称为一个流流

程定程定义义(process definition)。一个

流程定义

可以启动多个流程流程实实例例(process instance)。

流程定义

可以看做是重复执行流程的蓝图。在这个例子中，

流程定义

定义了请假的各

个步骤，而一个

流程实例

对应某个雇员提出的一个请假申请。

BPMN 2.0存储为XML，并包含可视化的部分：使用标准方式定义了每个步骤类型（人工任务，自动服务调用，等等）如何呈现，以及如何互相连接。这样BPMN 2.0标准使技

术人员与业务人员能用双方都能理解的方式交流业务流程。

我们要使用的流程定义为：

这个流程应该已经十分自我解释了。但为了明确起见，说明一下几个要点：

我们假定启动流程需要提供一些信息，例如雇员名字、请假时长以及说明。当然，这些可以单独建模为流程中的第一步。但是如果将它们作为流程的“输入信息”，就能保

证只有在实际请求时才会建立一个流程实例。否则（将提交作为流程的第一步），用户可能在提交之前改变主意并取消，但流程实例已经创建了。在某些场景中，就可能

影响重要的指标（例如启动了多少申请，但还未完成），取决于业务目标。

左侧的圆圈叫做启动启动事件事件 (start event)。这是一个流程实例的起点。

第一个矩形是一个用用户户任任务务(user task)。这是流程中人类用户操作的步骤。在这个例子中，经理需要批准或驳回申请。

取决于经理的决定，排他网排他网关关(exclusive gateway) (带叉的菱形)会将流程实例路由至批准或驳回路径。

如果批准，则需要将申请注册至某个外部系统，并跟着另一个用户任务，将经理的决定通知给申请人。当然也可以改为发送邮件。

如果驳回，则为雇员发送一封邮件通知他。

一般来说，这样的

流程定义

使用可视化建模工具建立，如Flowable Designer(Eclipse)或Flowable Web Modeler(Web应用)。

但在这里我们直接撰写XML，以熟悉BPMN 2.0及其概念。

与上面展示的流程图对应的BPMN 2.0 XML在下面显示。请注意这只包含了“流程部分”。如果使用图形化建模工具，实际的XML文件还将包含“可视化部分”，用于描述图形信

息，如流程定义中各个元素的坐标（所有的图形化信息包含在XML的BPMNDiagram标签中，作为definitions标签的子元素）。

将下面的XML保存在src/main/resources文件夹下名为holiday-request.bpmn20.xml的文件中。

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

<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL"

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

xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI"

xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC"

xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI"

xmlns:flowable="http://flowable.org/bpmn"

typeLanguage="http://www.w3.org/2001/XMLSchema"

expressionLanguage="http://www.w3.org/1999/XPath"

targetNamespace="http://www.flowable.org/processdef">

<![CDATA[

${approved}

]]>

</conditionExpression>

</sequenceFlow>

<![CDATA[

${!approved}

]]>

</conditionExpression>

</sequenceFlow>

<serviceTask id="externalSystemCall" name="Enter holidays in external system"

flowable:class="org.flowable.CallExternalSystemDelegate"/>

剩余188页未读，继续阅读

评论收藏

内容反馈

IT有个圈儿

粉丝: 90
资源: 4

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

最新资源

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

Flowable-6.5.0 用户手册.pdf

Flowable BPMN 用户手册

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

Flowable.6.3.0.BPMN.中文用户手册.RC1.pdf

flowable学习手册

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

Flowable-6.5.0 用户手册(中文版).zip

flowable官方文档中文版.zip

flowable中文资料

flowable 6.2官方汉化文档带运行demo

Flowable BPMN 用户手册 (v 6.3.0).zip

Flowable 6.6.0 BPMN用户指南 第一部分.pdf

Flowable 6.6.0 BPMN用户指南 第三部分.pdf

Flowable-6.5.0 用户手册中文版.pdf

flowable官方文档汉化版V6.2(原文翻译)

flowable-bpmn---idea的插件--超级好用

Flowable BPMN 用户手册 (v 6.5.pdf

Flowable BPMN 用户手册 (v 6.5.0-SNAPSHOT).pdf

flowable-用户手册-6.0.0.rc1.zip

flowable的IDEA插件-flowable-bpmn-plugin-0.4.9.2.zip

flowable 6.3.1的war包

flowable_6.0.1_用户手册

BPMN2.0中文介绍

Flowable-6.5.x 用户手册(中文版).zip

flowable v6.5.0 中文开发手册

vue使用flowable绘制流程图.docx

最新资源

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

Flowable 6.6.0 BPMN用户指南第一部分.pdf

Flowable 6.6.0 BPMN用户指南第三部分.pdf