activiti流程开发基本步骤详解

1、activiti流程开发指南一、 BPMN二、 activiti主要接口三、如何实现一个业务流程四、如何管理所有流程与实例五、开发流程六、 api一、 BPMN1.什么是 BPMN首先 BPMN 规范是由标准组织BPMI 发布的 .BPMN 1.0规范发布于2004 年 5 月。此规范展示了 BPMI 组织两年多的努力成果。BPMN 的主要目标就是要提供被所有业务用户理解的一套标记语言，包括业务分析者、软件开发者以及业务管理者与监察者。BPMN 还将支持生成可执行的BPEL4WS语言。所以，BPMN 在业务流程设计与流程实现之间搭建了一条标准化的桥梁。BPMN 定义了 业务流程图 ，其基于流程

2、图技术，同时为创建业务流程操作的图形化模型进行了裁减。业务流程的模型就是图形化对象的网图，包括活动（也可以说工作）和定义操作顺序的流控制。2. BPMN 基础业务流程图由一系列的图形化元素组成。这些元素简化了模型的开发，且业务分析者看上去非常熟悉。这些元素每个都有各自的特性，且与大多数的建模器类似。比如，活动是矩形，条件是菱形。应该强调的是：开发 BPMN 的动力就是为了在创建业务流程模型时提供一个简单的机制，同时又能够处理来自业务流程的复杂性。要处理这两个矛盾的需求的方法就是将标记的图形化方面组织分类为特定的类别。这里提供标记类别中的一小部分，以便 业务流程图 的读者可以简单地识别出元素的基

3、本类型从而理解图形。以下是四种基本的类型：1 ）流对象2 ）连接对象3 ）泳道4 ）人工信息BPMN2.0概要：二、 activiti主要接口ProcessEngineprocessEngine= ProcessEngines.getDefaultProcessEngine();RuntimeServiceruntimeService= processEngine.getRuntimeService();RepositoryServicerepositoryService= processEngine.getRepositoryService();TaskServicetaskService=

4、 processEngine.getTaskService();ManagementService managementService = processEngine .getManagementService (); IdentityService identityService = processEngine .getIdentityService ();HistoryService historyService = processEngine .getHistoryService (); FormService formService = processEngine .getFormSe

5、rvice ();ProcessEngines.getDefaultProcessEngine()会在第一次调用时初始化并创建一个流程引擎，以后再调用就会返回相同的流程引擎。使用对应的方法可以创建和关闭所有流程引擎：ProcessEngines.init()和 ProcessEngines.destroy()。ProcessEngines会扫描所有activiti.cfg.xml和 activiti-context.xml文件。对于activiti.cfg.xml文件，流程引擎会使用Activiti 的经典方式构建：ProcessEngineConfiguration.createProces

6、sEngineConfigurationFromInputStream(inputStream).buildProcessEngine(). 对于 activiti-context.xml文件，流程引擎会使用 Spring 方法构建：先创建一个Spring 的环境，然后通过环境获得流程引擎。所有服务都是无状态的。这意味着可以在多节点集群环境下运行Activiti，每个节点都指向同一个数据库， 不用担心哪个机器实际执行前端的调用。无论在哪里执行服务都没有问题RepositoryService可能是使用 Activiti引擎时最先接触的服务。它提供了管理和控制发布包和流程定义 的操作。 这里不涉及

7、太多细节，流程定义是BPMN 2.0流程的 java 实现。 它包含了一个流程每个环节的结构和行为。发布包 是 Activiti 引擎的打包单位。一个发布包可以包含多个BPMN2.0 xml 文件和其他资源。开发者可以自由选择把任意资源包含到发布包中。既可以把一个单独的BPMN 2.0 xml 文件放到发布包里，也可以把整个流程和相关资源都放在一起。（比如， hr-processes 实例可以包含hr 流程相关的任何资源）。可以通过 RepositoryService来部署 这种发布包。发布一个发布包，意味着把它上传到引擎中，所有流程都会在保存进数据库之前分析解析好。从这点来说，系统知道这个发

8、布包的存在，发布包中包含的流程就已经可以启动了。除此之外，服务可以o 查询引擎中的发布包和流程定义。ooo暂停或激活发布包，对应全部和特定流程定义。激活是对应的反向操作。获得多种资源，像是包含在发布包里的文件，获得流程定义的pojo 版本，可以用来通过暂停意味着它们不能再执行任何操作了，或引擎自动生成的流程图。java 解析流程，而不必通过xml 。正如 RepositoryService负责静态信息（比如，不会改变的数据，至少是不怎么改变的）， RuntimeService正好是完全相反的。它负责启动一个流程定义的新实例。如上所述， 流程定义定义了流程各个节点的结构和行为。流程实例就是这样一

9、个流程定义的实例。对每个流程定义来说，同一时间会有很多实例在执行。RuntimeService 也可以用来获取和保存流程变量 。 这些数据是特定于某个流程实例的，并会被很多流程中的节点使用（比如，一个排他网关常常使用流程变量来决定选择哪条路径继续流程）。Runtimeservice也能查询流程实例和执行。执行对应 BPMN2.0 中的 token 。基本上执行指向流程实例当前在哪里。最后， RuntimeService 可以在流程实例等待外部触发时使用，这时可以用来继续流程实例。流程实例可以有很多 暂停状态 ，而服务提供了多种方法来 触发 实例， 接受外部触发后，流程实例就会继续向下执行。任务

10、是由系统中真实人员执行的，它是Activiti 这类 BPMN 引擎的核心功能之一。所有与任务有关的功能都包含在 TaskService中：o 查询分配给用户或组的任务o 创建独立运行 任务。这些任务与流程实例无关。o 手工设置任务的执行者，或者这些用户通过何种方式与任务关联。o认领并完成一个任务。认领意味着一个人期望成为任务的执行者，即这个用户会完成这个任务。完成意味着“做这个任务要求的事情”。 通常来说会有很多种处理形式。IdentityService 非常简单。它可以管理（创建，更新，删除，查询 .）群组和用户。 请注意， Activiti 执行时并没有对用户进行检查。 例如，任务可以分

11、配给任何人，但是引擎不会校验系统中是否存在这个用户。 这是 Activiti 引擎也可以使用外部服务，比如 ldap ，活动目录，等等。FormService是一个可选服务。即使不使用它，Activiti 也可以完美运行，不会损失任何功能。这个服务提供了启动表单 和 任务表单 两个概念。启动表单 会在流程实例启动之前展示给用户，任务表单会在用户完成任务时展示。 Activiti 支持在 BPMN 2.0 流程定义中设置这些表单。 这个服务以一种简单的方式将数据暴露出来。再次重申，它时可选的， 表单也不一定要嵌入到流程定义中。HistoryService提供了 Activiti 引擎收集的所有历

12、史数据。（根据配置），比如流程实例启动时间，任务的参与者，径，等等。这个服务主要通过查询功能来获得这些数据。在执行流程时，引擎会保存很多数据完成任务的时间，每个流程实例的执行路ManagementService 在使用 Activiti 的定制环境中基本上不会用到。 它可以查询数据库的表和表的元数据。另外，它提供了查询和管理异步操作的功能。 Activiti 的异步操作用途很多，比如定时器，异步操作， 延迟暂停、激活，等等。三、如何实现一个业务流程1. 静态表单（每个节点绘制对应的表单）o创建工作流实例（process_model）o 创建每个节点的 jsp 表单一般以 list 页面弹出一个

13、form 表单页面就可以，至于表单的字段隐藏或者展示，由表单自己控制。o 部署流程把 process_model 导出为 BPMN.XML 格式，再导入进行流程部署开始流程保存业务实体leaveManager.saveLeave(entity);开始业务流程/ 用来设置启动流程的人员 ID ，引擎会自动把用户 ID 保存到 activiti:initiator 中 identityService .setAuthenticatedUserId(entity.getUserId();/process为流程 keyprocessInstance = runtimeService .startPro

14、cessInstanceByKey( process , businessKey, variables);办理流程taskSplete(taskId, variables);其中variables是可以传递在流程间的变量，通过Mapvariables =taskService.getVariables(taskId)可以获取那些变量。待办列表TaskQuery taskQuery =taskService.createTaskQuery().taskCandidateOrAssigned(userId);/自己办理或在该节点对应工作组中的流程过程中列表ProcessInstanceQuery

15、query =runtimeService .createProcessInstanceQuery().processDefiniti onKey( process ).active().orderByProcessInstanceId().desc();List list = query.listPage(pageParams0,pageParams 1);已结束列表HistoricProcessInstanceQuery query =historyService.createHistoricProcessInstanceQuery().processDefinitionKey( proc

16、ess ).finished().orderByProcessInstanceE ndTime().desc();List list =query.listPage(pageParams0, pageParams1);四、如何管理所有流程与实例查看所有已部署的流程repositoryService .createProcessDefinitionQuery().active().o rderByDeploymentId().desc();查看所有待办tasks =taskService .createTaskQuery().active().orderByTaskId().desc ().li

17、st();个人待办tasks =taskService.createTaskQuery().taskCandidateOrAssigned(user.getId().active().orderByTaskId().desc().list();查看所有办理中ProcessInstanceQuery dynamicQuery =runtimeService .createProcessInstanceQuery().orderByProcessI nstanceId().desc().active();办理中（本人）ProcessInstanceQuery dynamicQuery =runti

18、meService .createProcessInstanceQuery().involvedUser(UserUtil.getUserFromSession(sessi on).getId().orderByProcessInstanceId().desc().active();查看所有已办HistoricProcessInstanceQuery dynamicQuery =historyService .createHistoricProcessInstanceQuery().finishe d().orderByProcessInstanceEndTime().desc();已办（本人

19、）HistoricProcessInstanceQuery dynamicQuery =historyService .createHistoricProcessInstanceQuery().involve dUser(UserUtil.getUserFromSession(session).getId().finishe d().orderByProcessInstanceEndTime().desc();五、开发流程1. 绘制流程图单节点，多用户流程：必须设置下图红框属性，Multi-instance type代表是单用户还是多用户，,Collection (Multi-instance

20、),代表是用户的集合名称，需要在代码中设置Element variable (Multi-instance)，集合中的属性，不需要设置。并行网关，不管是否设置条件，都会并行执行包容网关，根据条件可以执行单个或多个分支。注意点： 1.绘制流程的时候，箭头保证一定要已连接到usertask2. 保证网关使用的时候，条件要写明3. 保证流程绘制的简单化，重复节点最好保证使用同一个usertask，减少 jsp 代码的编写量。2.表单编写3. 编写后台entityentity 继承 model 类， model 类中存在一个公共的业务实体 commmodel, 用来存储表单共用的的属性。4.编写后台controllercontroller继承 modelcontroller,modelcontroller存在待办，已办，办理的查询列表，完成以及开始功能也存在，只是由于开始和完成可能存在不同的业务需求，所以还是写在自己的 controller 中。startWorkflow开始流程complete完成任务taskList待办列表runningList办理列表finishedList已办列表5.编写前台表单JS 控制setStep()设置每一步的可编辑与不可编辑com