来源:https://www.jdon.com/soa/activiti.html
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文件来进行此调用时,它将提供以下输出:
{ |
现在,如果我们获得所有流程定义,我们可以看到列出的流程定义:
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 |
有了这个请求正文:
{ |
响应将是:
{ |
我们可以使用上一个响应返回的流程实例的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。