深入理解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 id="startEvent1"></startEvent>
<userTask id="sid-9A9219F8-306C-4ED0-A243-88756537F7FA" activiti:assignee="$INITIATOR" activiti:formKey="userinputmessage">
<extensionElements>
<modeler:activiti-idm-initiator xmlns:modeler="http://activiti.com/modeler"><![CDATA[true]]></modeler:activiti-idm-initiator>
</extensionElements>
</userTask>
<sequenceFlow id="sid-4CB3BA7F-30A3-49F6-97CE-82D0BD2FD9F8" sourceRef="startEvent1" targetRef="sid-9A9219F8-306C-4ED0-A243-88756537F7FA"></sequenceFlow>
<endEvent id="sid-A6BA7A4E-D1AC-451D-A3D2-5FEC5408519C"></endEvent>
<sequenceFlow id="sid-B8CC1746-E80B-4185-AA6A-5E85031E4152" sourceRef="sid-9A9219F8-306C-4ED0-A243-88756537F7FA" targetRef="sid-A6BA7A4E-D1AC-451D-A3D2-5FEC5408519C"></sequenceFlow>
</process>

这些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

POST http://127.0.0.1:8080/activiti-rest/service/repository/deployments

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

{
"id": "40",
"name": "myprocess.bpmn20.xml",
"deploymentTime": "2018-08-21T15:20:11.056+08:00",
"category": null,
"url": "http://127.0.0.1:8080/activiti-rest/service/repository/deployments/40",
"tenantId": ""
}

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

GET http://127.0.0.1:8080/activiti-rest/service/repository/process-definitions

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

POST http://127.0.0.1:8080/activiti-rest/service/runtime/process-instances

有了这个请求正文:

{
"processDefinitionKey":"myprocess-Id"
}

响应将是:

{
"id": "48",
"url": "http://127.0.0.1:8080/activiti-rest/service/runtime/process-instances/48",
"businessKey": null,
"suspended": false,
"ended": false,
"processDefinitionId": "myprocess-Id:2:47",
"processDefinitionUrl": "http://127.0.0.1:8080/activiti-rest/service/repository/process-definitions/myprocess-Id:2:47",
"processDefinitionKey": "myprocess-Id",
"activityId": null,
"variables": [],
"tenantId": "",
"name": null,
"completed": false
}

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

GET http://127.0.0.1:8080/activiti-rest/service/runtime/process-instances/48/diagram

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

 

4.2。完成任务

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

 
GET http://127.0.0.1:8080/activiti-rest/service/runtime/tasks

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

{
"data": [
{
"id": "53",
"url": "http://127.0.0.1:8080/activiti-rest/service/runtime/tasks/53",
"owner": null,
"assignee": "$INITIATOR",
"delegationState": null,
"name": null,
"description": null,
"createTime": "2018-08-21T15:23:55.714+08:00",
"dueDate": null,
"priority": 50,
"suspended": false,
"taskDefinitionKey": "sid-9A9219F8-306C-4ED0-A243-88756537F7FA",
"tenantId": "",
"category": null,
"formKey": "userinputmessage",
"parentTaskId": null,
"parentTaskUrl": null,
"executionId": "50",
"executionUrl": "http://127.0.0.1:8080/activiti-rest/service/runtime/executions/50",
"processInstanceId": "48",
"processInstanceUrl": "http://127.0.0.1:8080/activiti-rest/service/runtime/process-instances/48",
"processDefinitionId": "myprocess-Id:2:47",
"processDefinitionUrl": "http://127.0.0.1:8080/activiti-rest/service/repository/process-definitions/myprocess-Id:2:47",
"variables": []
}
],
"total": 1,
"start": 0,
"sort": "id",
"order": "asc",
"size": 1
}

最后,让我们使用任务ID 49完成此任务:

POST http://127.0.0.1:8080/activiti-rest/service/runtime/tasks/53

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

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

{
    "action": "complete",
     "variables": [{
         "name": "message",
         "value": "This is a User Input Message"
     }]
}

 

5.结论

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

 

Github案例1 GitHub案例2

在Spring Boot中使用activiti

工作流引擎四重罪

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