深入理解Activiti工作流

　　Activiti作为一个流行的开源工作流引擎，正在不断发展，其6.0版本以API形式提供服务，而之前版本基本都是要求我们的应用以JDK方式与其交互，只能将其携带到我们的应用中，而API方式则可以服务器独立运行方式，能够形成一个专网内工作流引擎资源共享的方式。

Activiti执行的BPMN2.0，这个规范中有几个要素见下图：

其实最经常使用的是开始结束事件和任务，本文就以这三个为例，说明通过UI画图和REST API方式如何实现调用，当然如果能够了解BPMN的XML，就能更加精确地定制流程，否则只能是玩玩而已，当然如果你说掌握XML定义不如编程呢，至少编程工具还能提示错误，BPMN绘图画错了很难发现，特别是携带很多数据，这些数据又有不同的逻辑关系时，隐藏在图形化流程背后的逻辑关系被弱化了。

2.下载

我们可以从Activiti网站本身下载两个webapps 的war文件。

对于v6.0.0，我们可以下载activiti-6.0.0.zip，解压缩，war文件可以在activiti-6.0.0 / wars目录中找到。

activiti-app提供了一个用户界面，用户可以通过该界面执行任何身份管理和任务管理相关的操作，创建用户和组。同样，activiti-rest是一个webapp，它提供REST API，用于对流程，任务等执行任何操作。

3. Activiti Kickstart App

我们需要一个可用的Java运行时和一个Apache Tomcat安装来部署该应用程序。任何Web容器都可以工作，但Activiti主要在Tomcat上进行测试。

现在，我们只需要在Tomcat上部署战争并使用http://localhost:8080/activiti-app访问它。

用户名和密码：

activiti-admin: admin/admin
activiti-app: admin/test
activiti-rest: kermit/kermit

主页应如下所示：

3.1 数据库

默认情况下，它使用H2内存数据库。如果我们想要更改数据库配置，我们可以检查代码并修改activiti-app.properties文件。执行此操作后，我们需要重新生成war文件，这可以通过运行start.sh脚本来完成。这将构建activiti-app以及所需的依赖项。

3.2。Kickstart App

当我们点击Kickstart App时，我们会获得使用Process的选项。我们可以创建/导入流程并从这里运行它们。

让我们创建一个包含单个User Task的小流程，该任务接收来自用户的消息。进入Kickstart应用程序后，要创建流程，请选择Processes选项卡，然后单击Create Process：

流程编辑器将打开，我们可以拖放开始事件，各种类型的任务和结束事件的各种符号来定义流程。

当我们在我们的流程中添加用户任务时，我们需要将其分配给某人。我们可以通过单击此任务选项中的分配并选择受理人来完成此操作。

为简单起见，让我们将任务分配给流程启动器：

我们还希望此用户任务从用户获取输入消息。为此，我们需要将Form与单个文本字段关联到此任务。

选择用户任务，然后选择参考表格 Referenced form。目前，没有与任务关联的表单，因此单击“ 新建表单”，然后添加所需的详细信息：

在此之后，它将带我们到表单部分，我们可以在表单中拖放我们想要的各种字段，并为它们设置标签：

请注意，我们已勾选Required，这意味着如果不输入Message，则无法完成User任务。

完成后，我们将保存并转到“app”标签。为了能够运行我们创建的流程，我们需要创建一个Process App。

在Process App中，我们可以添加一个或多个Process Definitions。执行此操作后，我们需要发布此应用程序，以便其他用户可以使用流程，这个发布很重要，如果你的流程有错误就发布不了，当然Activiti也不会像IDE那样告诉你精确的错误位置和原因或提示，你自己好好反省自查。

当然我们也可以将流程导出BPMN.xml文件,主要部分内容：

这些startEvent、userTask是文章开头第一张图里面的对应含义。sequenceFLow是顺序流，startEvent是流程事件，userTask是任务。

3.3 任务应用程序

在任务应用程序中，有两个选项卡：任务 - 用于当前正在运行的任务，以及流程 - 用于当前正在运行的流程。

单击“ 流程中的开始流程”选项卡后，我们将获得可以运行的可用流程列表。从此列表中，我们将选择我们的流程并单击开始按钮，只有你的流程发布publish之后才能看到，也才能按开始按钮。

我们的流程只包含一个任务，它是一个用户任务。因此，该过程正在等待用户完成此任务。当我们点击流程正在等待的任务时，我们可以看到我们创建的表单：

如果我们点击查看图，这将不仅向我们展示过程图也强调，完成的任务和正在等待的人。在我们的示例中，用户任务仍处于待处理状态，会突出显示：

要完成此任务，我们可以单击Complete butto n。如前所述，我们需要输入消息，因为我们必须保留它。因此，在输入消息后，我们可以完成任务。

3.4。身份管理应用

除了管理流程外，我们还有一个身份管理应用程序，允许我们添加用户和组。我们还可以为用户定义角色。

4. Activiti REST

Activiti为Activiti Engine提供REST API，可以通过将activiti-rest.war文件部署到像Apache Tomcat这样的servlet容器来安装。

默认情况下，Activiti Engine将连接到内存中的H2数据库。就像我们在activiti-app中看到的一样，在这里我们可以更改WEB-INF / classes文件夹中db.properties文件中的数据库设置并重新创建war文件。

启动并运行应用程序后，我们可以将此基本URL用于所有请求：

默认情况下，所有REST资源都需要对有效的Activiti用户进行身份验证。每次REST调用都应使用基本HTTP访问身份验证。

4.1。创建和运行流程

要创建流程，首先，我们需要BPMN文件用于流程。我们可以按照之前基于Activiti with Java的文章中的描述创建文件，也可以从Kickstart App的Process部分下载。

我们需要发一个POST请求，以及contentType：multipart / form-data，我们将为我们的新流程上传BPMN文件，在postman中设置：body中选择form，key填入file；类型从text和file中选择file，然后上传我们之前导出的BPMN.xml文件，授权选择basic auth，用户名和密码: kermit

当我们通过传递我们创建的流程的BPMN文件来进行此调用时，它将提供以下输出：

现在，如果我们获得所有流程定义，我们可以看到列出的流程定义：

接下来，我们可以使用我们在BPMN文件中提到的processKey来运行此过程：

有了这个请求正文：

响应将是：

我们可以使用上一个响应返回的流程实例的id来查看正在运行的流程图：

如前所述，该过程正在等待用户任务完成，因此它在图中突出显示：

4.2。完成任务

现在让我们看看我们的待处理任务：

响应将包含待处理任务的列表。目前，只有一项任务 - 我们的用户任务：

最后，让我们使用任务ID 49完成此任务：

这是一个POST请求，我们需要发送操作字段来指示我们要对该任务执行的操作。我们可以“解决”，“完成”或“删除”任务。此外，我们可以传递任务所需的变量数组来完成。

在我们的例子中，我们要传递一个字段“message”，它就是用户消息文本字段。所以我们的要求是：

5.结论

在本文中，我们讨论了如何使用Activiti Kickstart应用程序和提供的REST API。

Github案例1 GitHub案例2

在Spring Boot中使用activiti

工作流引擎四重罪

无服务器使用流程场景举例

#工作流专题