目录
项目工作流基本需求
项目实现
Flowable交互设计实现
流程主要名词介绍
1.流程部署API
2.获取已经部署的流程API
3.获取已经部署的流程定义API
4.获取流程图片API
5.启动流程，获取实例API
6.获取流程图片（运行时）API
7.查询任务API
8.完成任务API
9.其他API，删除，查询历史等
10.如何知道流程开始和结束，可以使用监听器实现
前端页面实现
项目工作流基本需求
页面能够绘制工作流（CRUD）页面能够执行工作流步奏（通过、拒绝）能够获取工作流及时状态图项目实现
使用前端bpmn.js插件或者flowable前端页面绘制流程图，导出bpmn格式文件；启动Flowable流程引擎服务（需要修改删除权限相关的验证）；将bpmn格式文件导入Flowable流程引擎服务，Flowable流程引擎进行流程的执行；以T2Admin项目开发工作流业务为例，T2Admin后端服务与Flowable交互，将操作及结果展现在T2Amin前端页面；Flowable交互设计实现
流程主要名词介绍
流程定义：创建完成一个流程（流程定义）并部署到flowable中就创建出一个持久化的流程定义（存储在数据库中）;流程实例：现在可以使用在流程定义中定义的id（参见XML中的process元素）启动新流程实例。请注意这个id在Flowable术语中被称作key。一个流程定义可以启动多个流程实例。
流程实例是动态的，流程定义是静态的。
事件：如开始事件、结束事件、边界事件、中间捕获事件任务：“用户任务（user task）”用于对需要人工执行的任务进行建模。当流程执行到达用户任务时，会为指派至该任务的用户或组的任务列表创建一个新任务。
flowable的安装部署修改部分就不讲解了，这里有一份现成的供参考
:T2Admin/api/common-flowable at master · tangzhangss/T2Admin · GitHub
1.流程部署API
将由前端创建好的.bpmn20.xml流程文件调用T2Admin的后端接口；
T2Admin的后端接口调用Flowable服务部署流程并获取流程定义部署完成的ID。
导入同样的流程会更新版本，以流程定义为主,flowable会根据tenantId和流程的key去区分流程的版本+1, 仅支持部署以.bpmn20.xml结尾的流程文件;
@PostMapping("/deploy_process")public Result deployProcess(@RequestParam(name = "file") MultipartFile file)
响应结果如下：【返回流程定义数据ProcessDefinition】
id为流程定义的Id，需要T2Admin记录该ID用于控制流程的执行，如：开始、结束、获取流程信息等；deploymentId为部署记录的Id,也可以记录同时可记录流程主要信息供T2Admin页面展示，如：name、resurceName、key、tenantId(对应T2Admin的clientId)id和key的区别是：id可以区别流程的版本，key可以作为同一个流程区分键
{"code": 200,"message": "OK","data": {"isInserted": false,"suspensionState": 1,"derivedVersion": 0,"isUpdated": false,"resourceName": "Holiday_Request2.bpmn20.xml","originalPersistentState": {"suspensionState": 1,"category": "/processdef"},"isGraphicalNotationDefined": true,"version": 7,"revision": 1,"isDeleted": false,"diagramResourceName": "Holiday_Request2.holidayRequest.png","deploymentId": "137501","name": "Holiday Request","tenantId": "-1","id": "holidayRequest:7:137504","category": "/processdef","hasStartFormKey": false,"key": "holidayRequest"}}
2.获取已经部署的流程API
@GetMapping("/get_all_process_list")public Result getAllProcessList()
响应结果如下：
{"code": 200,"message": "OK","data": [{"isInserted": false,"parentDeploymentId": "130001","isUpdated": false,"originalPersistentState": {"parentDeploymentId": "130001","tenantId": "-1"},"isNew": false,"isDeleted": false,"name": "Holiday_Request2","tenantId": "-1","id": "130001","deploymentTime": "-09-08T08:35:48.034+0800"}]}
3.获取已经部署的流程定义API
@ApiOperation("获取流程定义")@GetMapping("/get_all_process_definition_list")
响应结果如下：
{"code": 200,"message": "OK","data": [{"isInserted": false,"suspensionState": 1,"derivedVersion": 0,"isUpdated": false,"resourceName": "Holiday_Request2.bpmn20.xml","originalPersistentState": {"suspensionState": 1,"category": "/processdef"},"isGraphicalNotationDefined": true,"version": 1,"revision": 1,"isDeleted": false,"diagramResourceName": "Holiday_Request2.holidayRequest.png","deploymentId": "130001","name": "Holiday Request","tenantId": "-1","id": "holidayRequest:1:130004","category": "/processdef","hasStartFormKey": false,"key": "holidayRequest"}]}
4.获取流程图片API
通过“部署流程接口”返回的流程定义[processDefinition]的id可以获取流程图片，即流程图。
@GetMapping("/get_process_diagram/{id}")public void getProcessDiagram(@PathVariable("id") String id)
响应结果:
5.启动流程，获取实例API
/*** 启动流程* 返回流程实例的id*/@ApiOperation(value = "启动流程")@ApiImplicitParam(name = "variables",paramType = "body",dataType="json",value = "开始流程的启动参数,如:\n" +"{\n" +" \"employee\":\"tangzhangss\",\n" +" \"nrOfHolidays\":\"How many holidays do you want to request?\",\n" +" \"description\":\"Why do you need them?\"\n" +"}")@PutMapping("/start_process/{id}")public Result startProcess(@PathVariable("id")String id, @RequestBody HashMap<String,Object> variables)
响应结果：
返回的是流程实例的ID,T2Admin需要记录此ID,后续流程的执行状态操作都需要此ID
{"code": 200,"message": "OK","data": "137505"}
6.获取流程图片（运行时）API
@GetMapping(value = "/get_process_diagram_activity/{processInstanceId}")public Result getProcessDiagramActivity(@PathVariable("processInstanceId")String processInstanceId)
响应结果:
7.查询任务API
流程已经启动那么，再T2Admin系统中应有可以查询到自己的任务；
可以通过3个条件来查询任务，只会查询当前租户的任务信息，至于以下查询条件如何与flowable服务交互，依据业务而定。查询条件assignee和candidateGroup都是在流程配置中配置的（前端页面绘制流程图时设置）
@GetMapping("/find_task")public Result findTask(@RequestParam(required = false)String assignee,@RequestParam(required = false)String id,@RequestParam(required = false) String candidateGroup)
这里我们查询所有任务：
响应结果：
{"code": 200,"message": "OK","data": [{"queryIdentityLinks": [],"isInserted": false,"suspensionState": 1,"processInstanceId": "137505","processDefinitionId": "holidayRequest:7:137504","isCanceled": false,"isUpdated": false,"usedVariablesCache": {},"originalPersistentState": {"processInstanceId": "137505","processDefinitionId": "holidayRequest:7:137504","suspensionState": 1,"priority": 50,"executionId": "137510","taskDefinitionKey": "approveTask","subTaskCount": 0,"createTime": "-09-08T09:34:13.975+0800","name": "Approve or reject request","isCountEnabled": true,"variableCount": 0,"identityLinkCount": 1},"priority": 50,"revision": 1,"executionId": "137510","taskDefinitionKey": "approveTask","subTaskCount": 0,"isDeleted": false,"createTime": "-09-08T09:34:13.975+0800","name": "Approve or reject request","isCountEnabled": true,"variableCount": 0,"tenantId": "-1","identityLinkCount": 1,"id": "137514"}]}
8.完成任务API
如果上述任务是表单任务，获取需要页面的一些操作，这需要T2Admin自己定义相关的标识，弹出响应的任务输入框，将参数处理，传入完成任务接口；（处理任务这部分由T2Admin完成！）
@PutMapping("/complete_task/{id}")public Result completeTask(@PathVariable("id")String id, @RequestBody HashMap<String,Object> variables)
完成任务的接口非常简单;
任务的请求参数注意，需要根据流程配置传入，比如该任务是一个同意或者不同意；
响应结果：
{
"code": 200,
"message": "OK",
"data": "null"
}
执行完任务，再次查看流程图状态：
再次完成任务
9.其他API，删除，查询历史等
10.如何知道流程开始和结束，可以使用监听器实现
包括全局开始结束事件监听器。或者任务监听器。这部分比较复杂暂时未研究。
目前仅仅梳理如何集成到当前业务系统思路。
前端页面实现
前端页面实现目前想到两种方式；
我们只需要利用绘制.bpmn20.xml的工具绘制即可，其他的全部由T2Admin自定义实现；
使用vue bnpm.js实现，是否能实现还未研究使用flowable自带的前端页面实现，需要想办法集成到T2Admin中
这是可以实现的，稍微改造一下前端页面，然后将设计器页面以“远程菜单“的方式集成到T2Admin即可。
