@alanwang-merit/meritdata-platform-skill-package 1.0.9 → 1.0.10

package/skills/meritdata-platform-bpm/references/api-reference.md

@@ -0,0 +1,2779 @@
+## 适用版本与安全边界
+
+本文记录的是 `cloud-system-bpm-module-core` 6.13.2 的历史接口面。每次使用前都要从目标项目的依赖、已解析 JAR 或已部署接口确认实际方法签名、路径和返回值。
+
+所有 `/api/bpm` 调用必须使用目标平台的已认证用户会话或服务身份，并在服务端执行授权校验。示例中的主机、服务名、流程 ID、业务 ID 和表单路径均为占位语境，不能直接用于任何环境。
+
+## 前置条件
+
+目标项目已声明并解析与部署环境匹配的 BPM 依赖。
+
+## 目录
+
+- [适用版本与安全边界](#适用版本与安全边界)
+- [前置条件](#前置条件)
+- [1. 规则引擎初始化接口](#1-规则引擎初始化接口)
+- [2.  启动流程实例接口](#2-启动流程实例接口)
+- [3.  运行规则引擎](#3-运行规则引擎)
+- [4. 完成任务接口](#4-完成任务接口)
+- [5. 填写意见接口](#5-填写意见接口)
+- [6. 根据任务节点获取意见内容](#6-根据任务节点获取意见内容)
+- [7. 查看追踪接口](#7-查看追踪接口)
+- [8.  退回拟稿人接口](#8-退回拟稿人接口)
+- [9.  退回上一环节处理人接口](#9-退回上一环节处理人接口)
+- [10. 流程设计器列表查询](#10-流程设计器列表查询)
+- [11. 个人待办](#11-个人待办)
+- [12. 阅知](#12-阅知)
+- [13. 流程最新定义ID](#13-流程最新定义id)
+- [14. 业务相关接口](#14-业务相关接口)
+- [15. 流程分类相关](#15-流程分类相关)
+
+## 1. 规则引擎初始化接口
+ 说明：根据流程定义key查询符合条件的最新的流程按钮配置信息
+* method: `POST`
+* url: `http://IP:端口/gateway/服务名/api/bpm/core/ruleengine/init/{procDefKey}`
+* PathVariables
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procDefKey | String |是| 流程key   |  |
+* RequestParams
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procDefKey | String   | 是  |  流程key    ||
+    | 自定义流程参数|String | 否   | 自定义流程参数 | |
+* ResponseBody
+    返回数据类型：RuleEngine对象
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/ruleengine/init/Process_Demo1?procDefKey=Process_Demo1
+返回数据如下：
+```json
+{
+    "timestamp": 1614234886974,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/ruleengine/init/Process_Demo1",
+    "data": {
+        "runtime": {
+            "businessId": null,
+            "procDefKey": "Process_Demo1",
+            "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189",
+            "procInstId": null,
+            "taskId": null,
+            "taskDefKey": null,
+            "taskName": null,
+            "formLink": "/<frontend-base>/example/index.html#/formEdit?id=businessId",
+            "selUserWin": "no",
+            "opinionWin": "no",
+            //获取按钮信息
+            "bpmBtns": [
+                {
+                    "name": "保存",
+                    "id": "bpmSaveOrUpdateBtn",
+                    "procInstId": "",
+                    "type": "primary"
+                },
+                {
+                    "name": "填写意见",
+                    "id": "bpmOpinionBtn",
+                    "procInstId": "",
+                    "type": ""
+                },
+                {
+                    "name": "发送",
+                    "id": "bpmSendBtn",
+                    "procInstId": "",
+                    "type": ""
+                },
+                {
+                    "name": "特送",
+                    "id": "bpmJumpBtn",
+                    "procInstId": "",
+                    "type": "",
+                    "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189"
+                },
+                {
+                    "name": "管理特送",
+                    "id": "bpmJumpManagementBtn",
+                    "procInstId": "",
+                    "type": "",
+                    "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189"
+                },
+                {
+                    "name": "查看追踪",
+                    "id": "bpmProcTrackBtn",
+                    "procInstId": "",
+                    "type": "",
+                    "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189"
+                },
+                {
+                    "name": "关闭",
+                    "id": "bpmCloseBtn",
+                    "procInstId": "",
+                    "type": ""
+                }
+            ],
+            "nextNodes": null,
+            "mainForm": null
+        },
+        "formLink": {
+            "sort": "0",
+            "name": "部门审批",
+            "link": "/<frontend-base>/example/index.html#/formEdit?id=businessId"
+        },
+        "actors": [
+            {
+                "type": "1",
+                "ids": "drafterCode",
+                "codes": null,
+                "names": null,
+                "level": null,
+                "duty": null,
+                "dutyName": null,
+                "dutyCode": null,
+                "condition": null,
+                "customControllerName": null,
+                "customMethodsName": null
+            }
+        ],
+        "approve": {
+            "type": "onlyApprove"
+        },
+        "route": {
+            "type": "1",
+            "name": null,
+            "value": null,
+            "returnName": null,
+            "returnValue": null,
+            "operName": "发送",
+            "operImgPath": null
+        },
+        "opinion": {
+            "display": "1",
+            "type": "1",
+            "must": "1",
+            "regionName": null,
+            "regionSort": "0",
+            "opinionField": null,
+            "opinionYesNo": null,
+            "opinionDeptStatus": null,
+            "opinionListStatus": null,
+            "routeName": null,
+            "routeValue": null,
+            "routeOpiMust": null,
+            "routeCommentMust": null,
+            "opinionUserImgStatus": null,
+            "autoOpinion": null,
+            "autoOpiContent": null,
+            "isOpiDisplay": null,
+            "isOpiMust": null
+        },
+        "seluserwin": {
+            "display": "yes@@@@@【本环节需要选人】",
+            "noseluser": "no@@@@@【本环节不需要自动选人】"
+        },
+        "editStatus": {
+            "type": "1"
+        },
+        "activity": {
+            "id": "Activity_1el7wyo",
+            "name": "部门审批"
+        },
+        "formVars": [],
+        "sendRead": {
+            "actor": [],
+            "isSendRead": {
+                "type": "0"
+            }
+        },
+        "regainStatus": {
+            "type": null
+        },
+        "isRetprenode": {
+            "type": null
+        },
+        "isRetfirnode": {
+            "type": null
+        },
+        "retRandomNodeStatus": {
+            "type": null
+        },
+        "sign": null,
+        "completionCondition": null
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+    适用于后端调用
+    注入com.meritdata.cloud.bpm.core.BpmEngine类
+```java
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "规则引擎初始化", notes = "根据流程定义Key查询符合条件的最新的流程按钮配置信息")
+    @RequestMapping(value = "/ruleengine/init/{procDefKey}", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<RuleEngine> ruleEngineInit() {
+        String procDefKey = "Process_Demo1";
+        Map variables = new HashMap();
+        variables.put("procDefkey","Process_Demo1");
+        ResultBody<RuleEngine> ruleEngine = bpmEngine.ruleEngineInit(procDefKey, variables);
+        return ruleEngine;
+    }
+
+```
+## 2.  启动流程实例接口
+说明：创建一个流程实例,前置条件是先把业务数据保存后，获取业务数据的id,当作businessId的值
+* method: `POST`
+* url: `http://IP:端口/gateway/服务名/api/bpm/core/{procDefKey}/startprocess`
+* PathVariables
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procDefKey | String   | 是  |  流程key    ||
+* RequestParams
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procDefKey | String      |是       | 流程key   |      |
+    | businessId | String      |是       | 业务id   |      |
+    | bpmSubject | String      |否       | 待办标题   |      |
+    | bpmUrgent | String      |否       | 紧急程度   |      |
+    | bpmSecret | String      |否       | 密级程度   |      |
+* ResponseBody
+    返回数据类型：MainForm对象
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/Process_Demo1/startprocess?procDefKey=Process_Demo1&businessId=3f28824f77d7e9a60177d806daab0001
+```json
+   {
+       "procDefKey":"Process_Demo1"
+       "businessId":"3f28824f77d7e9a60177d806daab0001"
+   }
+```
+返回数据如下：
+```json
+    {
+    "timestamp": 1614237113004,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/Process_Demo1/startprocess",
+    "data": {
+        "tenantId": "",
+        "createTime": 1614237112863,
+        "updateTime": 1614237112973,
+        "creatorId": null,
+        "reviserId": null,
+        "id": "3f28824f77d7e9980177d8079a8d0005",
+        "appModuleName": "差旅费",
+        "appModuleId": "报销",
+        "appSystemId": "BPM",
+        "appSystemName": "BPM系统",
+        "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189",
+        "procInstId": "bc6fcf47-7738-11eb-8728-00d861edd189",
+        "procDefKey": "Process_Demo1",
+        "flowReaderIds": ",test1,",
+        "flowReaderNames": "测试1",
+        "flowAuthorIds": ",test1,",
+        "flowAuthorNames": "测试1",
+        "procDealStatus": "draft",
+        "drafterName": "测试1",
+        "drafterId": "test1",
+        "drafterDeptId": "yanfa",
+        "drafterDeptName": "技术研发部",
+        "subject": "Process_Demo1",
+        "urgent": null,
+        "secret": null,
+        "formLink": "/<frontend-base>/example/index.html#/formEdit?id=3f28824f77d7e9a60177d806daab0001",
+        "preActDealerId": "",
+        "preDealerId": "test1",
+        "preActId": "",
+        "nodeIds": "Activity_1el7wyo",
+        "nodeNames": "部门审批",
+        "lockUserId": null,
+        "lockUserName": null,
+        "lockStatus": null,
+        "bpmVersion": 0,
+        "businessId": "3f28824f77d7e9a60177d806daab0001",
+        "portalMode": "default",
+        "portalUrl": ""
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+注入com.meritdata.cloud.bpm.core.BpmEngine类
+```java
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "启动流程", notes = "根据流程定义Key和需要的流程变量businessId来启动流程，启动成功之后返回procInstId流程实例Id")
+    @RequestMapping(value = "/{procDefKey}/startprocess", method = RequestMethod.POST)
+    public ResultBody<MainFormDTO> startProcess() throws Exception {
+        String procDefKey ="Process_Demo1";
+        Map variables = new HashMap();
+        variables.put("procDefkey","Process_Demo1");
+        variables.put("businessId","3f28824f77d7e9a60177d8110b670002");
+        ResultBody<MainFormDTO> mainForm = bpmEngine.startProcess(procDefKey, variables);
+        return mainForm;
+    }
+```
+## 3.  运行规则引擎
+说明：根据业务id和流程定义key打开流程实例，获取流程实例详情
+情况一：只是打开流程表单数据，不做任何操作。获取不到下一节点的审批人员数据
+情况二：点击提供的流程按钮中的发送按钮，传入bpmOperName，bpmOperValue参数。获取当前节点的
+runtime[nextNode]表示:下一节点的审批人员数据和审批方式
+* method: `POST`
+* url: `http://IP:端口/gateway/服务名/api/bpm/core/ruleengine/run`
+* PathVariables
+    ```
+     无
+    ```
+* RequestParams
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procDefKey | String      |是       | 流程key   |      |
+    | businessId | String      |是       | 业务id   |      |
+    |bpmOperName|String|否|操作名称|如果想要获取当前节点的runtime[nextNode],传入该参数|
+    |bpmOperValue|String|否|操作值|如果想要获取当前节点的runtime[nextNode],传入该参数|
+    | 自定义流程参数|String | 否   | 自定义流程参数 | |
+* ResponseBody
+    返回数据类型：MainForm对象
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/ruleengine/run?procDefKey=Process_Demo1&businessId=3f28824f77d7e9a60177d802f61d0000
+```json
+   {
+       "procDefKey":"Process_Demo1"
+       "businessId":"3f28824f77d7e9a60177d802f61d0000"
+   }
+```
+返回数据如下：
+```json
+{
+    "timestamp": 1614242117951,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/ruleengine/run",
+    "data": {
+        "runtime": {
+            "businessId": null,
+            //流程定义key
+            "procDefKey": "Process_Demo1",
+            //流程定义id
+            "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189",
+            //流程实例id
+            "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+            //任务id
+            "taskId": "94c159ee-773a-11eb-930f-00d861edd189",
+            //任务key
+            "taskDefKey": "Activity_0vjczzn",
+            //任务名称
+            "taskName": "总监审批",
+            //表单地址
+            "formLink": "/<frontend-base>/example/index.html#/formRead?id=3f28824f77d7e9a60177d802f61d0000",
+            //是否人员选择
+            "selUserWin": "no",
+            //是否填写意见
+            "opinionWin": "no",
+            //操作按钮
+            "bpmBtns": [
+                {
+                    "name": "保存",
+                    "id": "bpmSaveOrUpdateBtn",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": "primary"
+                },
+                {
+                    "name": "填写意见",
+                    "id": "bpmOpinionBtn",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": ""
+                },
+                {
+                    "name": "发送",
+                    "id": "bpmSendBtn",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": ""
+                },
+                {
+                    "name": "流程终止",
+                    "id": "bpmJumpBtnEnd",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": "",
+                    "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189"
+                },
+                {
+                    "name": "特送",
+                    "id": "bpmJumpBtn",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": "",
+                    "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189"
+                },
+                {
+                    "name": "管理特送",
+                    "id": "bpmJumpManagementBtn",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": "",
+                    "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189"
+                },
+                {
+                    "name": "退回上一环节处理人",
+                    "id": "bpmRetprenodeBtn",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": ""
+                },
+                {
+                    "name": "退回拟稿人",
+                    "id": "bpmRetfirnodeBtn",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": ""
+                },
+                {
+                    "name": "退回任意环节",
+                    "id": "bpmRetRandomNodeStatusBtn",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": ""
+                },
+                {
+                    "name": "查看追踪",
+                    "id": "bpmProcTrackBtn",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": "",
+                    "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189"
+                },
+                {
+                    "name": "关闭",
+                    "id": "bpmCloseBtn",
+                    "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                    "type": ""
+                }
+            ],
+            //下一节点处理人和审批类型
+            "nextNodes": [],
+            "mainForm": {
+                "tenantId": "",
+                "createTime": 1614236908000,
+                "updateTime": 1614237905000,
+                "creatorId": null,
+                "reviserId": null,
+                "id": "3f28824f77d7e9980177d8047c920003",
+                //应用模块名称
+                "appModuleName": "差旅费",
+                //模块id
+                "appModuleId": "报销",
+                //所属系统id
+                "appSystemId": "BPM",
+                //所属系统
+                "appSystemName": "BPM系统",
+                //流程定义id
+                "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189",
+                //流程实例id
+                "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+                //流程定义key
+                "procDefKey": "Process_Demo1",
+                //流程读者id,按逗号拼接
+                "flowReaderIds": ",test1,",
+                //流程读者名称
+                "flowReaderNames": "测试1",
+                //流程作者id,即处理人
+                "flowAuthorIds": ",test1,",
+                //流程
+                "flowAuthorNames": "测试1",
+                //流程处理状态: draft草稿箱、track跟踪、over办结
+                "procDealStatus": "track",
+                //拟稿人名称
+                "drafterName": "测试1",
+                //拟稿人编码
+                "drafterId": "test1",
+                //拟稿部门编码
+                "drafterDeptId": "yanfa",
+                //拟稿部门名称
+                "drafterDeptName": "技术研发部",
+                //标题
+                "subject": "测试1_2021-02-25 00:00_出差报销",
+                //紧急程度
+                "urgent": "普通",
+                //密级
+                "secret": "高级",
+                //表单连接地址
+                "formLink": "/<frontend-base>/example/index.html#/formEdit?id=3f28824f77d7e9a60177d802f61d0000",
+                //上一活动处理人编码
+                "preActDealerId": "test1",
+                // 上一处理人编码
+                "preDealerId": "test1",
+                //上一活动Id
+                "preActId": "Activity_1el7wyo",
+                //当前处理节点Ids
+                "nodeIds": "Activity_0vjczzn",
+                //当前处理节点名
+                "nodeNames": "总监审批",
+                //锁定用户编码
+                "lockUserId": "test1",
+                //锁定用户名称
+                "lockUserName": "测试1",
+                //锁定是否启用，0：未启用，1：启用
+                "lockStatus": null,
+                //流程设计版本号
+                "bpmVersion": 1,
+                //业务id
+                "businessId": "3f28824f77d7e9a60177d802f61d0000",
+                //门户模式：默认模式default（无前缀）,固定模式fix（开发使用）,门户模式portal
+                "portalMode": "default",
+                //门户前缀
+                "portalUrl": ""
+            }
+        },
+        //表单连接地址
+        "formLink": {
+            "sort": "0",
+            "name": "总监审批",
+            "link": "/<frontend-base>/example/index.html#/formRead?id=businessId"
+        },
+        //当前节点候选处理人规则
+        "actors": [
+            {
+                "type": "1",
+                "ids": "drafterCode",
+                "codes": null,
+                "names": null,
+                "level": null,
+                "duty": null,
+                "dutyName": null,
+                "dutyCode": null,
+                "condition": null,
+                "customControllerName": null,
+                "customMethodsName": null
+            }
+        ],
+        //当前节点审批方式
+        "approve": {
+            "type": "onlyApprove"
+        },
+        //操作路由
+        "route": {
+            "type": "1",
+            "name": null,
+            "value": null,
+            "returnName": null,
+            "returnValue": null,
+            "operName": "发送",
+            "operImgPath": null
+        },
+        //意见
+        "opinion": {
+            "display": "1",
+            "type": "1",
+            "must": "1",
+            "regionName": null,
+            "regionSort": "0",
+            "opinionField": null,
+            "opinionYesNo": null,
+            "opinionDeptStatus": null,
+            "opinionListStatus": null,
+            "routeName": null,
+            "routeValue": null,
+            "routeOpiMust": null,
+            "routeCommentMust": null,
+            "opinionUserImgStatus": null,
+            "autoOpinion": null,
+            "autoOpiContent": null,
+            "isOpiDisplay": null,
+            "isOpiMust": null
+        },
+        //操作候选人员
+        "seluserwin": {
+            "display": "yes@@@@@【本环节需要选人】",
+            "noseluser": "no@@@@@【本环节不需要自动选人】"
+        },
+         // 表单是否可以编辑
+        "editStatus": {
+            "type": "1"
+        },
+        //当前活动节点信息
+        "activity": {
+            "id": "Activity_0vjczzn",
+            "name": "总监审批"
+        },
+        //当前节点变量
+        "formVars": [],
+        // 阅知
+        "sendRead": {
+            "actor": [],
+            "isSendRead": {
+                "type": "0"
+            }
+        },
+        // 允许收回
+        "regainStatus": {
+            "type": null
+        },
+        // 退回上一环节处理人
+        "isRetprenode": {
+            "type": "1"
+        },
+         // 退回拟稿人
+        "isRetfirnode": {
+            "type": "1"
+        },
+         // 返回任意环节
+        "retRandomNodeStatus": {
+            "type": "1"
+        },
+        // 转发
+        "sign": null,
+        "completionCondition": null
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+```java
+    @Autowired
+    BpmEngine bpmEngine;
+    @ApiOperation(value = "规则引擎执行", notes = "根据流程实例Id和流程所需要的变量，查询对应待办任务；" +
+            "结果1.存在待办：返回RuleEngine下的当前执行的任务Id、当前执行任务的规则信息，后续处理用户节点用户信息;" +
+            "结果2.不存在待办：返回空的RuleEngine实例化。")
+    @RequestMapping(value = "/ruleengine/run", method = RequestMethod.POST)
+    @ResponseBody
+    public ResultBody<RuleEngine> ruleEngineRun() {
+        Map variables = new HashMap();
+        variables.put("procDefkey","Process_Demo1");
+        variables.put("businessId","3f28824f77d7e9a60177d802f61d0000");
+
+        return bpmEngine.ruleEngineRun(variables);
+    }    
+```
+## 4. 完成任务接口
+说明: 完成当前节点，进入下一节点
+* method: `POST`
+* url: `http://IP:端口/gateway/服务名/api/bpm/core/task/{id}/complete`
+* PathVariables
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | id | String   | 是  |  任务id    ||
+* RequestParams
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | businessId | String      |是       | 业务id   |      |
+    |runtime[taskDefKey]|String|是|任务定义key||
+    |approve[type]|String|是|审批方式|审批方式 onlyApprove:单人审批,anyApproveList:任意一人审批,parApproveList:并行审批审批,seqApproveList:串行审批|
+    |bpmOperValue|String|是|操作值||
+    |bpmOperName|String|是|操作名称||
+    | bpmSubject | String      |否       | 待办标题   |      |
+    | bpmUrgent | String      |否       | 紧急程度   |      |
+    | bpmSecret | String      |否       | 密级程度   |      |
+    |下一节点的任务定义key_下一节点的审批方式|String|否|下一节点审批人员|当不传时：下一节点的审批人员为全部，当传参时：下一节点的审批人员为传入的人员。传入的值为人员编码。多个人员时，按逗号隔开，当设计器中设置为单人审批时，只能传入一个人员编码。例如：Activity_0vjczzn_anyApproveList："test1,test2",Activity_0vjczzn表示：下一节点的任务定义key,anyApproveList表示：下一节点的审批方式|
+    | 自定义流程参数|String | 否   | 自定义流程参数 | |
+* ResponseBody
+    返回数据类型：MainForm对象
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/task/94c159ee-773a-11eb-930f-00d861edd189/complete?businessId=3f28824f77d7e9a60177d802f61d0000&runtime[taskDefKey]=Activity_0vjczzn&approve[type]=onlyApprove&bpmOperValue=bpmSendBtn&bpmOperName=发送
+```json
+   {
+       "businessId":"3f28824f77d7e9a60177d802f61d0000",
+       "runtime[taskDefKey]":"Activity_0vjczzn",
+       "approve[type]":"onlyApprove",
+       "bpmOperValue":"bpmSendBtn",
+       "bpmOperName":"发送"
+   }
+```
+返回数据如下：
+```json
+    {
+    "timestamp": 1614307657500,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/task/94c159ee-773a-11eb-930f-00d861edd189/complete",
+    "data": {
+        "tenantId": "",
+        "createTime": 1614236908000,
+        "updateTime": 1614307657269,
+        "creatorId": null,
+        "reviserId": null,
+        "id": "3f28824f77d7e9980177d8047c920003",
+        "appModuleName": "差旅费",
+        "appModuleId": "报销",
+        "appSystemId": "BPM",
+        "appSystemName": "BPM系统",
+        "procDefId": "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189",
+        "procInstId": "42a93008-7738-11eb-8728-00d861edd189",
+        "procDefKey": "Process_Demo1",
+        "flowReaderIds": ",test1,",
+        "flowReaderNames": "测试1",
+        "flowAuthorIds": null,
+        "flowAuthorNames": "",
+        "procDealStatus": "over",
+        "drafterName": "测试1",
+        "drafterId": "test1",
+        "drafterDeptId": "yanfa",
+        "drafterDeptName": "技术研发部",
+        "subject": "测试1_2021-02-25 00:00_出差报销",
+        "urgent": "普通",
+        "secret": "高级",
+        "formLink": "/<frontend-base>/example/index.html#/formEdit?id=3f28824f77d7e9a60177d802f61d0000",
+        "preActDealerId": "test1",
+        "preDealerId": "test1",
+        "preActId": "Activity_0vjczzn",
+        "nodeIds": "over",
+        "nodeNames": "办结",
+        "lockUserId": "test1",
+        "lockUserName": "测试1",
+        "lockStatus": null,
+        "bpmVersion": 1,
+        "businessId": "3f28824f77d7e9a60177d802f61d0000",
+        "portalMode": "default",
+        "portalUrl": ""
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+```java
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "完成任务", notes = "根据任务id，完成任务")
+    @RequestMapping(value = "/task/complete", method = RequestMethod.POST)
+    public ResultBody<MainFormDTO> complete() {
+        // 任务id
+        String id = "9f2c6791-7748-11eb-90ec-00d861edd189";
+        Map variables = new HashMap();
+        variables.put("businessId","3f28824f77d7e9a60177d806daab0001");
+        variables.put("runtime[taskDefKey]","Activity_0vjczzn");
+        variables.put("approve[type]","onlyApprove");
+        variables.put("bpmOperValue","bpmSendBtn");
+        variables.put("bpmOperName","发送");
+        // 调用完成任务
+        ResultBody<MainFormDTO> mainFormVo = bpmEngine.complete(id,variables);
+        return mainFormVo;
+    }
+```
+## 5. 填写意见接口
+说明:某个流程实例中的某个节点需要填写意见
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/addOrUpdate`
+* PathVariables
+    ```
+    无
+    ```
+* RequestParams:
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procInstId | String |是| 流程实例id   | ruleEngine.runtime.procDefId |
+    | procDefId | String |是| 流程定义id   | ruleEngine.runtime.procInstId |
+    | taskId | String |是| 任务id   | ruleEngine.runtime.taskId |
+    | taskDefKey | String |是| 任务定义key   | ruleEngine.runtime.taskDefKey |
+    |content|String|是|意见内容||
+    |type|String|否|保存类型（save，publish）|save为保存不发布，publish直接会发布，不传默认为save|
+* ResponseBody
+    返回数据类型：Boolean
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/addOrUpdate?procInstId=db512fbe-7689-11eb-ac36-00d861edd189&procDefId=Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189&taskId=e58fdd9e-7689-11eb-ac36-00d861edd189&taskDefKey=Activity_0vjczzn&content=测试数据
+```json
+   {
+       "procInstId":"db512fbe-7689-11eb-ac36-00d861edd189"
+       "procDefId":"Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189"
+       "taskId":"e58fdd9e-7689-11eb-ac36-00d861edd189"
+       "taskDefKey":"Activity_0vjczzn"
+       "content":"测试数据"
+   }
+```
+返回数据如下:
+```json
+{
+    "timestamp": 1614222536939,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/addOrUpdate",
+    //保存成功
+    "data": true,
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+```java
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "填写意见", notes = "节点填写意见")
+    @RequestMapping(value = "/addOrUpdate", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<Boolean> addOrUpdate() {
+        Map variables = new HashMap();
+        variables.put("procDefId","Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189");
+        variables.put("procInstId","db512fbe-7689-11eb-ac36-00d861edd189");
+        variables.put("taskId","e58fdd9e-7689-11eb-ac36-00d861edd189");
+        variables.put("taskDefKey","Activity_0vjczzn");
+        variables.put("content","测试数据");
+        return  bpmEngine.addOrUpdate(variables);
+    }
+```
+## 6. 根据任务节点获取意见内容
+说明:某个流程实例中的某个节点获取此节点的意见列表
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/getContent`
+* PathVariables
+    ```
+    无
+    ```
+* RequestParams:
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procInstId | String |是| 流程实例id   | ruleEngine.runtime.procDefId |
+    | procDefId | String |是| 流程定义id   | ruleEngine.runtime.procInstId |
+    | taskId | String |是| 任务id   | ruleEngine.runtime.taskId |
+    | taskDefKey | String |是| 任务定义key   | ruleEngine.runtime.taskDefKey |
+* ResponseBody
+    返回数据类型：List<ProcOpinion>
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/getContent?procInstId=db512fbe-7689-11eb-ac36-00d861edd189&procDefId=Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189&taskId=e58fdd9e-7689-11eb-ac36-00d861edd189&taskDefKey=Activity_0vjczzn
+```json
+   {
+       "procInstId":"db512fbe-7689-11eb-ac36-00d861edd189"
+       "procDefId":"Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189"
+       "taskId":"e58fdd9e-7689-11eb-ac36-00d861edd189"
+       "taskDefKey":"Activity_0vjczzn"
+   }
+```
+返回数据如下:
+```json
+{
+"timestamp":1622605276497,
+"status":1,"message":"成功",
+"stackmessage":null,
+"path":"/api/engine/procopinion/getContent",
+"data":[
+{
+  "tenantId":"",
+ "secretCode":null,
+ "secretName":null,
+ "createTime":1622601734000,
+ "updateTime":1622601734000,
+ "creatorId":null,"reviserId":null,
+ "id":"3f28830b79ca97b30179ca9998e90000",
+ "procInstId":"49d368f2-c34a-11eb-8db9-70b5e84e90b6",
+ "procDefKey":"Process_Demo1",
+ "taskId":"5bf08f02-c34a-11eb-8db9-70b5e84e90b6",
+ "nodeId":"Activity_0adbx74","nodeName":"审批",
+ "wfMainFormId":"3f28830b79ca43e30179ca8d79e20014","content":"完成了35%","publishTime":1622601770000,"type":"1","regionName":null,
+ "regionSort":"0","userId":"zs","userName":"张三",
+ "deptId":"3f28830b799d87ab01799d8af628000b",
+ "deptName":"大数据",
+ "isApprove":null,
+ "opinionField":null,
+ "isBatchDeal":null,"undoIds":null,
+ "opinionDeptStatus":null,
+ "opinionListStatus":null,
+ "opinionUserImgStatus":null},
+{"tenantId":"",
+ "secretCode":null,
+ "secretName":null,
+ "createTime":1622601089000,
+ "updateTime":1622601089000,
+ "creatorId":null,
+ "reviserId":null,
+ "id":"3f28830b79ca43e30179ca8fc192001a",
+ "procInstId":"49d368f2-c34a-11eb-8db9-70b5e84e90b6",
+ "procDefKey":"Process_Demo1",
+ "taskId":"5bf08f02-c34a-11eb-8db9-70b5e84e90b6",
+ "nodeId":"Activity_0adbx74",
+ "nodeName":"审批",
+ "wfMainFormId":"3f28830b79ca43e30179ca8d79e20014",
+ "content":"完成任务25%",
+ "publishTime":1622601089000,
+ "type":"1","regionName":null,
+ "regionSort":"0",
+ "userId":"zs",
+ "userName":"张三",
+ "deptId":"3f28830b799d87ab01799d8af628000b",
+ "deptName":"大数据",
+ "isApprove":null,
+ "opinionField":null,
+ "isBatchDeal":null,"undoIds":null,
+ "opinionDeptStatus":null,"opinionListStatus":null,
+ "opinionUserImgStatus":null}
+],
+"extraInfo":{},
+"success":true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+```java
+
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "获取意见", notes = "获取某个节点的意见")
+    @RequestMapping(value = "/getContent", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<String> getContent() {
+        Map variables = new HashMap();
+        variables.put("procDefId","Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189");
+        variables.put("procInstId","db512fbe-7689-11eb-ac36-00d861edd189");
+        variables.put("taskId","e58fdd9e-7689-11eb-ac36-00d861edd189");
+        variables.put("taskDefKey","Activity_0vjczzn");
+        return  bpmEngine.getContent(variables);
+    }
+
+```
+## 7. 查看追踪接口
+说明：任务跟踪接口分为三部分内容
+文字追踪,图表追踪,审批意见
+### 7.1 文字追踪
+说明:查询某个流程实例的文字追踪数据
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/step`
+* PathVariables
+    ```
+    无
+    ```
+* RequestParams:
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procInstId | String |是| 流程实例id   |  |
+    |mainFormId|String|否|mainform的Id|不需要该参数|
+    |procDefId|String|否|流程定义id|不需要该参数|
+* ResponseBody
+    返回数据类型：ProcTrackDTO的集合对象
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/step?procInstId=da94441c-75a7-11eb-bf67-00d861edd189
+```json
+   {
+       "procInstId":"da94441c-75a7-11eb-bf67-00d861edd189"
+   }
+```
+返回数据如下:
+```json
+{
+    "timestamp": 1614145310290,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/step",
+    "data": [
+        {
+            "id": "3f28824f77cd8c4f0177cdc46e040007",
+            //流程实例id
+            "procInstId": "da94441c-75a7-11eb-bf67-00d861edd189",
+            //流程定义id
+            "procDefId": "Process_Demo1:1:00078c50-74b1-11eb-bd66-00d861edd189",
+            //流程key
+            "procDefKey": "Process_Demo1",
+            //任务id
+            "taskId": "da94445b-75a7-11eb-bf67-00d861edd189",
+            //发送节点id
+            "nodeId": "Activity_1el7wyo",
+            //发送节点名称
+            "nodeName": "部门审批",
+            //接收节点id,有可能是多个,按,拼接
+            "nextNodeIds": "Activity_0vjczzn",
+            //接收节点名称,有可能是多个,按,拼接
+            "nextNodeNames": "总监审批",
+            "mainFormId": "3f28824f77cd8c4f0177cdc462060005",
+            // 发送人id
+            "senderId": "test1",
+            //发送人名称
+            "senderName": "测试1",
+            //发送人所在部门id
+            "deptId": "3f28824f77c763dc0177c768b6ba0009",
+            //发送人所在部门名称
+            "deptName": "技术研发部",
+            //操作名称
+            "operate": "发送",
+            "receiveTime": 1614064935000,
+            "dealTime": 1614064938000,
+            //接收人id
+            "receiverIds": ",test1,",
+            //接收人名称
+            "receiverNames": "测试1",
+            "receiverDepts": null,
+            "x": "506",
+            "y": "293",
+            "width": "168",
+            "height": "55",
+            "superProcInstId": null
+        }
+    ],
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+ ```java
+
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "任务跟踪-文字追踪", notes = "任务跟踪-文字追踪")
+    @PostMapping(value = "/step")
+    @ResponseBody
+    public ResultBody<List<ProcTrackDTO>> getPage() {
+        String procInstId = "da94441c-75a7-11eb-bf67-00d861edd189";
+        // 调用 任务跟踪-文字追踪
+        return  bpmEngine.getPage(procInstId, null,null);
+    }
+
+ ```
+### 7.2 图表追踪
+说明:查询某个流程实例的文字追踪数据
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/graph`
+* PathVariables
+    ```
+    无
+    ```
+* RequestParams:
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procInstId | String |是| 流程实例id   |  |
+    |mainFormId|String|否|mainform的Id|不需要该参数|
+    |procDefId|String|是|流程定义id||
+* ResponseBody
+    返回数据类型：Map
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/graph?procInstId=da94441c-75a7-11eb-bf67-00d861edd189&procDefId=Process_Demo1:1:00078c50-74b1-11eb-bd66-00d861edd189
+```json
+   {
+       "procInstId":"da94441c-75a7-11eb-bf67-00d861edd189",
+       "procDefId":"Process_Demo1:1:00078c50-74b1-11eb-bd66-00d861edd189"
+   }
+```
+返回数据如下:
+```json
+    {
+    "timestamp": 1614147183892,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/graph",
+    "data": {
+        // 返回是每个节点的状态 //0正在处理 //1已处理 //2未处理
+        "taskDefKeys": {
+            "Activity_0vjczzn": "0",
+            "Activity_1el7wyo": "1"
+        },
+        // 返回流程文件
+        "bpmnXml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?><bpmn:definitions xmlns:bpmn=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" xmlns:bpmndi=\"http://www.omg.org/spec/BPMN/20100524/DI\" xmlns:di=\"http://www.omg.org/spec/DD/20100524/DI\" xmlns:dc=\"http://www.omg.org/spec/DD/20100524/DC\" xmlns:camunda=\"http://camunda.org/schema/1.0/bpmn\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" id=\"Definitions_02dbze3\" targetNamespace=\"http://bpmn.io/schema/bpmn\" exporter=\"Camunda Modeler\" exporterVersion=\"3.7.1\">  <bpmn:process id=\"Process_Demo1\" name=\"Process_Demo1\" isExecutable=\"true\">    <bpmn:documentation>{\"formLink\":\"/<frontend-base>/example/index.html#/formEdit?id=businessId\",\"appModuleName\":\"差旅费\",\"appModuleId\":\"报销\",\"appSystemName\":\"BPM系统\",\"appSystemId\":\"BPM\",\"portalMode\":\"default\",\"portalUrl\":\"\"}</bpmn:documentation>    <bpmn:startEvent id=\"Event_0e2d76k\" name=\"开始\">      <bpmn:outgoing>Flow_147uzda</bpmn:outgoing>    </bpmn:startEvent>    <bpmn:userTask id=\"Activity_1el7wyo\" name=\"部门审批\" camunda:assignee=\"${Activity_1el7wyo_onlyApprove}\">      <bpmn:extensionElements>        <camunda:meritdata>          <camunda:editStatus type=\"1\" />          <camunda:isretprenode type=\"\" />          <camunda:isretfirnode type=\"\" />          <camunda:regainStatus type=\"\" />          <camunda:retRandomNodeStatus type=\"\" />          <camunda:formLink name=\"部门审批\" sort=\"0\">            <camunda:link>/<frontend-base>/example/index.html#/formEdit?id=businessId</camunda:link>          </camunda:formLink>          <camunda:formVars />          <camunda:actors>            <camunda:actor type=\"1\" ids=\"drafterCode\" name=\"起草人\" />          </camunda:actors>          <camunda:sendRead>            <camunda:issendread type=\"0\" />          </camunda:sendRead>          <camunda:approve type=\"onlyApprove\" />          <camunda:route type=\"1\" operName=\"发送\" returnName=\"\" returnValue=\"\" operImgPath=\"\" />          <camunda:seluserwin display=\"yes@@@@@【本环节需要选人】\" noseluser=\"no@@@@@【本环节不需要自动选人】\" />          <camunda:opinion display=\"\" type=\"1\" must=\"\" isOpiDisplay=\"\" isOpiMust=\"\" regionName=\"\" regionSort=\"0\" opinionField=\"\" opinionYesNo=\"\" opinionDeptStatus=\"\" opinionUserImgStatus=\"\" autoOpinion=\"\" autoOpiContent=\"\" routeName=\"\" routeValue=\"\" routeOpiMust=\"\" routeCommentMust=\"\" />        </camunda:meritdata>        <camunda:taskListener delegateExpression=\"${userTaskListener}\" event=\"create\" />        <camunda:taskListener delegateExpression=\"${userTaskListener}\" event=\"assignment\" />        <camunda:taskListener delegateExpression=\"${userTaskListener}\" event=\"complete\" />        <camunda:taskListener delegateExpression=\"${userTaskListener}\" event=\"update\" />        <camunda:taskListener delegateExpression=\"${userTaskListener}\" event=\"delete\" />      </bpmn:extensionElements>      <bpmn:incoming>Flow_147uzda</bpmn:incoming>      <bpmn:outgoing>Flow_0u9dqba</bpmn:outgoing>    </bpmn:userTask>    <bpmn:userTask id=\"Activity_0vjczzn\" name=\"总监审批\" camunda:assignee=\"${Activity_0vjczzn_onlyApprove}\">      <bpmn:extensionElements>        <camunda:meritdata>          <camunda:editStatus type=\"1\" />          <camunda:isretprenode type=\"1\" />          <camunda:isretfirnode type=\"1\" />          <camunda:regainStatus type=\"\" />          <camunda:retRandomNodeStatus type=\"1\" />          <camunda:formLink name=\"总监审批\" sort=\"0\">            <camunda:link>/<frontend-base>/example/index.html#/formRead?id=businessId</camunda:link>          </camunda:formLink>          <camunda:formVars />          <camunda:actors>            <camunda:actor type=\"1\" ids=\"drafterCode\" name=\"起草人\" />          </camunda:actors>          <camunda:sendRead>            <camunda:issendread type=\"0\" />          </camunda:sendRead>          <camunda:approve type=\"onlyApprove\" />          <camunda:route type=\"1\" operName=\"发送\" returnName=\"\" returnValue=\"\" operImgPath=\"\" />          <camunda:seluserwin display=\"yes@@@@@【本环节需要选人】\" noseluser=\"no@@@@@【本环节不需要自动选人】\" />          <camunda:opinion display=\"\" type=\"1\" must=\"\" isOpiDisplay=\"\" isOpiMust=\"\" regionName=\"\" regionSort=\"0\" opinionField=\"\" opinionYesNo=\"\" opinionDeptStatus=\"\" opinionUserImgStatus=\"\" autoOpinion=\"\" autoOpiContent=\"\" routeName=\"\" routeValue=\"\" routeOpiMust=\"\" routeCommentMust=\"\" />        </camunda:meritdata>        <camunda:taskListener delegateExpression=\"${userTaskListener}\" event=\"create\" />        <camunda:taskListener delegateExpression=\"${userTaskListener}\" event=\"assignment\" />        <camunda:taskListener delegateExpression=\"${userTaskListener}\" event=\"complete\" />        <camunda:taskListener delegateExpression=\"${userTaskListener}\" event=\"update\" />        <camunda:taskListener delegateExpression=\"${userTaskListener}\" event=\"delete\" />      </bpmn:extensionElements>      <bpmn:incoming>Flow_0u9dqba</bpmn:incoming>      <bpmn:outgoing>Flow_1vp7uq3</bpmn:outgoing>    </bpmn:userTask>    <bpmn:endEvent id=\"Event_1f641s8\" name=\"结束\">      <bpmn:incoming>Flow_1vp7uq3</bpmn:incoming>    </bpmn:endEvent>    <bpmn:sequenceFlow id=\"Flow_147uzda\" sourceRef=\"Event_0e2d76k\" targetRef=\"Activity_1el7wyo\">      <bpmn:extensionElements>        <camunda:executionListener delegateExpression=\"${lineListener}\" event=\"take\" />      </bpmn:extensionElements>    </bpmn:sequenceFlow>    <bpmn:sequenceFlow id=\"Flow_0u9dqba\" sourceRef=\"Activity_1el7wyo\" targetRef=\"Activity_0vjczzn\">      <bpmn:extensionElements>        <camunda:executionListener delegateExpression=\"${lineListener}\" event=\"take\" />      </bpmn:extensionElements>    </bpmn:sequenceFlow>    <bpmn:sequenceFlow id=\"Flow_1vp7uq3\" sourceRef=\"Activity_0vjczzn\" targetRef=\"Event_1f641s8\">      <bpmn:extensionElements>        <camunda:executionListener delegateExpression=\"${lineListener}\" event=\"take\" />      </bpmn:extensionElements>    </bpmn:sequenceFlow>  </bpmn:process>  <bpmndi:BPMNDiagram id=\"BpmnDiagram_1\">    <bpmndi:BPMNPlane id=\"BpmnPlane_1\" bpmnElement=\"Process_Demo1\">      <bpmndi:BPMNEdge id=\"Flow_147uzda_di\" bpmnElement=\"Flow_147uzda\">        <di:waypoint x=\"369\" y=\"220\" />        <di:waypoint x=\"438\" y=\"220\" />        <di:waypoint x=\"438\" y=\"321\" />        <di:waypoint x=\"506\" y=\"321\" />      </bpmndi:BPMNEdge>      <bpmndi:BPMNEdge id=\"Flow_0u9dqba_di\" bpmnElement=\"Flow_0u9dqba\">        <di:waypoint x=\"674\" y=\"321\" />        <di:waypoint x=\"740\" y=\"321\" />        <di:waypoint x=\"740\" y=\"322\" />        <di:waypoint x=\"806\" y=\"322\" />      </bpmndi:BPMNEdge>      <bpmndi:BPMNEdge id=\"Flow_1vp7uq3_di\" bpmnElement=\"Flow_1vp7uq3\">        <di:waypoint x=\"974\" y=\"322\" />        <di:waypoint x=\"1133\" y=\"322\" />        <di:waypoint x=\"1133\" y=\"460\" />        <di:waypoint x=\"1291\" y=\"460\" />      </bpmndi:BPMNEdge>      <bpmndi:BPMNShape id=\"Event_0e2d76k_di\" bpmnElement=\"Event_0e2d76k\">        <dc:Bounds x=\"331\" y=\"201\" width=\"38\" height=\"38\" />        <bpmndi:BPMNLabel>          <dc:Bounds x=\"339\" y=\"242\" width=\"22\" height=\"14\" />        </bpmndi:BPMNLabel>      </bpmndi:BPMNShape>      <bpmndi:BPMNShape id=\"Activity_1el7wyo_di\" bpmnElement=\"Activity_1el7wyo\">        <dc:Bounds x=\"506\" y=\"293\" width=\"168\" height=\"55\" />      </bpmndi:BPMNShape>      <bpmndi:BPMNShape id=\"Activity_0vjczzn_di\" bpmnElement=\"Activity_0vjczzn\">        <dc:Bounds x=\"806\" y=\"294\" width=\"168\" height=\"55\" />      </bpmndi:BPMNShape>      <bpmndi:BPMNShape id=\"Event_1f641s8_di\" bpmnElement=\"Event_1f641s8\">        <dc:Bounds x=\"1291\" y=\"441\" width=\"38\" height=\"38\" />        <bpmndi:BPMNLabel>          <dc:Bounds x=\"1299\" y=\"482\" width=\"22\" height=\"14\" />        </bpmndi:BPMNLabel>      </bpmndi:BPMNShape>    </bpmndi:BPMNPlane>  </bpmndi:BPMNDiagram></bpmn:definitions>"
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+ ```java
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "任务跟踪-图表追踪", notes = "任务跟踪-图表追踪")
+    @PostMapping(value = "/graph")
+    @ResponseBody
+    public ResultBody<Map> getGraphTrack() {
+        String procInstId = "da94441c-75a7-11eb-bf67-00d861edd189";
+        String procDefId = "Process_Demo1:1:00078c50-74b1-11eb-bd66-00d861edd189";
+        // 任务跟踪-图表追踪
+        return  bpmEngine.getGraphTrack(procInstId,null,procDefId);
+    }
+ ```
+说明:图表追踪中点击某个节点，返回节点的提示信息。正在处理，已处理，未处理状态的人员
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/tip`
+* PathVariables
+    ```
+    无
+    ```
+* RequestParams:
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procInstId | String |是| 流程实例id   |  |
+    |mainFormId|String|否|mainform的Id|不需要该参数|
+    |taskDefKey|String|是|任务节点key||
+* ResponseBody
+    返回数据类型：List
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/tip?procInstId=7f050a06-7680-11eb-9b5e-00d861edd189&taskDefKey=Activity_0vjczzn
+```json
+   {
+       "procInstId":"7f050a06-7680-11eb-9b5e-00d861edd189",
+       "taskDefKey":"Activity_0vjczzn"
+   }
+```
+返回数据如下:
+```json
+{
+    "timestamp": 1614161060238,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/tip",
+    "data": [
+        //节点名称
+        "总监审批",
+        //已处理人
+        "已处理：",
+        //未处理人
+        "未处理：测试1",
+        //处理状态
+        "处理状态：正在处理"
+    ],
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+ ```java
+
+    @Autowired
+    BpmEngine bpmEngine;
+
+   @ApiOperation(value = "任务跟踪-图表追踪-节点提示信息", notes = "图表追踪中点击某个节点，返回节点的提示信息。正在处理，已处理，未处理状态的人员")
+    @PostMapping(value = "/tip")
+    @ResponseBody
+    public ResultBody<List> getNodeTip() {
+        String taskDefKey = "Activity_0vjczzn";
+        String procInstId = "7f050a06-7680-11eb-9b5e-00d861edd189";
+        //调用任务跟踪-图表追踪-节点提示信息
+        return  bpmEngine.getNodeTip(taskDefKey,procInstId,null);
+    }
+
+ ```
+### 7.3 审批意见
+说明:查询某个流程实例的所有审批意见信息
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/getOpinions`
+* PathVariables
+    ```
+    无
+    ```
+* RequestParams:
+    | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+    | ---------- |-------- |-------- | ----------- | ---- |
+    | procInstId | String |是| 流程实例id   |  |
+    | isContainsApprover | String |否| 是否是获取当前用户审批的意见 |默认1 自己的和其他人已发布的，0 自己填写的  |
+* ResponseBody
+    返回数据类型：ProcOpinionDTO的集合对象
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/getOpinions?procInstId=db512fbe-7689-11eb-ac36-00d861edd189
+```json
+   {
+       "procInstId":"db512fbe-7689-11eb-ac36-00d861edd189"
+   }
+```
+返回数据如下:
+```json
+{
+    "timestamp": 1614217620220,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/getOpinions",
+    "data": [
+        {
+            "tenantId": "",
+            "createTime": 1614162017000,
+            "updateTime": 1614162017000,
+            "creatorId": null,
+            "reviserId": null,
+            "id": "3f28824f77d386b00177d38dbd560003",
+            //流程实例id
+            "procInstId": "db512fbe-7689-11eb-ac36-00d861edd189",
+            //流程key
+            "procDefKey": "Process_Demo1",
+            //任务id
+            "taskId": "db559ccd-7689-11eb-ac36-00d861edd189",
+            //流程节点id
+            "nodeId": "Activity_1el7wyo",
+            //流程节点名称
+            "nodeName": "部门审批",
+            //流程主表id
+            "wfMainFormId": "3f28824f77d386b00177d38d84470002",
+            //意见内容
+            "content": "测试数据",
+            //发布时间，当前任务处理完成后，发布时间才有值
+            "publishTime": 1614162020000,
+            //意见类型：（新增的意见是覆盖，或者覆盖又新增，删除已发布意见）0、新增1、覆盖2、自动新增3
+            "type": "1",
+            //意见区域名称
+            "regionName": null,
+            //意见区域排序号
+            "regionSort": "0",
+            //填写意见人用户信息编码
+            "userId": "test1",
+            //填写意见人用户名称
+            "userName": "测试1",
+            //填写意见人部门编码
+            "deptId": "3f28824f77c763dc0177c768b6ba0009",
+            //填写意见人部门名称
+            "deptName": "技术研发部",
+            //是否同意：2同意、0不同意、1中立
+            "isApprove": null,
+            //意见域
+            "opinionField": null,
+            //临时变量【是否批量处理】
+            "isBatchDeal": null,
+            //临时变量【待办ids】
+            "undoIds": null,
+            //意见是否按部门分类显示
+            "opinionDeptStatus": null,
+            //意见列表是否显示
+            "opinionListStatus": null,
+            //意见展现中是否显示用户图像
+            "opinionUserImgStatus": null
+        }
+    ],
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+ ```java
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "任务跟踪-审批意见", notes = "任务跟踪-审批意见")
+    @RequestMapping(value = "/getOpinions", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<List<ProcOpinionDTO>> getOpinions() {
+        Map map = new HashMap();
+        map.put("procInstId","db512fbe-7689-11eb-ac36-00d861edd189");
+        return  bpmEngine.getOpinions(map);
+    }
+ ```
+### 7.4 获取端口
+说明:获取网页的端口 来自common.properties中的meritdata.cloud.web-server中的端口
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/port`
+* PathVariables
+  ```
+  无
+  ```
+* RequestParams:
+  无
+* ResponseBody
+  返回数据类型：String
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/port
+返回数据如下：
+```json
+{
+    "timestamp": 1629255129461,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/port",
+    "data": "8080",
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+```java
+  @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "获取端口", notes = "获取端口")
+    @RequestMapping(value = "/port", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<String> getPort() {
+        return  bpmEngine.getPort();
+    }
+```
+## 8.  退回拟稿人接口
+说明：退回拟稿人功能 当前任务实例退回到第一个任务节点，状态为起草状态
+子流程中暂不支持退回拟稿人
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/retfirnode/{businessId}`
+* PathVariables
+| 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+| ---------- |-------- |-------- | -----------| ---- |
+| businessId | String  |是       | 业务id      |      |
+* RequestParams:
+| 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+| ---------- |-------- |-------- | ----------- | ---- |
+| procInstId | String      |是       | 流程实例id   |      |
+| businessId | String      |是       | 业务id   |      |
+| bpmOperName |String      | 是      | 操作名称| 流程按钮name值 |
+| bpmOperValue| String    | 是       | 操作值 | 流程按钮id值 |
+| bpmSubject | String      |否       | 待办标题   |      |
+| bpmUrgent | String      |否       | 紧急程度   |      |
+| bpmSecret | String      |否       | 密级程度   |      |
+|runtime[taskId]|String|是|当前任务id|
+* ResponseBody
+    返回数据类型：String
+Postman测试样例:
+适用于前端直接调用
+案例使用 
+<gateway-host>
+<gateway-port>
+<service-name> 服务
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/retfirnode/3f28824f77c764f00177c774d8bb0000
+```json
+     {
+        "procInstId":"57f63abb-74b1-11eb-bd66-00d861edd189",
+        "businessId":"3f28824f77c764f00177c774d8bb0000",
+        "bpmOperName":"退回拟稿人",
+        "bpmOperValue":"bpmRetfirnodeBtn",
+        "runtime[taskId]":"ccec2073-8604-11eb-aa34-00d861edd189"
+    }
+```
+返回数据如下:
+```json
+{
+    "timestamp": 1613972972863,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/retfirnode/3f28824f77c764f00177c774d8bb0000",
+    "data": "退回拟稿人成功",
+    "extraInfo": {},
+    "success": true
+}
+```
+java 样例
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+ ```java
+
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "退回拟稿人", notes = "退回拟稿人")
+    @RequestMapping(value = "/retfirnode",method = RequestMethod.POST)
+    public ResultBody<String> processRetfirnode() {
+        String businessId = "3f28824f77c764f00177c774d8bb0000";
+        Map map = new HashMap();
+        map.put("procInstId","57f63abb-74b1-11eb-bd66-00d861edd189");
+        map.put("businessId","3f28824f77c764f00177c774d8bb0000");
+        map.put("bpmOperName","退回拟稿人");
+        map.put("bpmOperValue","bpmRetfirnodeBtn");
+        map.put("runtime[taskId]","ccec2073-8604-11eb-aa34-00d861edd189");
+        // 调用退回拟稿人方法
+        return bpmEngine.processRetfirnode(businessId,map);
+    }
+
+ ```
+## 9.  退回上一环节处理人接口
+说明：退回上一环节处理人功能 当前任务实例退回到上一个任务节点
+子流程中暂不支持退回上一环节处理人
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/retprenode/{businessId}`
+* PathVariables
+| 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+| ---------- |-------- |-------- | -----------| ---- |
+| businessId | String  |是       | 业务id      |      |
+* RequestParams:
+| 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+| ---------- |-------- |-------- | ----------- | ---- |
+| procInstId | String      |是       | 流程实例id   |      |
+| businessId | String      |是       | 业务id   |      |
+| bpmOperName |String      | 是      | 操作名称| 流程按钮name值|
+| bpmOperValue| String    | 是       | 操作值 | 流程按钮id值|
+| bpmSubject | String      |否       | 待办标题   |      |
+| bpmUrgent | String      |否       | 紧急程度   |      |
+| bpmSecret | String      |否       | 密级程度   |      |
+* ResponseBody
+    返回数据类型：String
+<b>Postman测试样例：</b>
+适用于前端直接调用
+案例使用 
+<gateway-host>
+<gateway-port>
+<service-name> 服务
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/retprenode/3f28824f77c764f00177c774d8bb0000
+```json
+    {
+        "procInstId":"57f63abb-74b1-11eb-bd66-00d861edd189",
+        "businessId":"3f28824f77c764f00177c774d8bb0000",
+        "bpmOperName":"退回上一环节处理人",
+        "bpmOperValue":"bpmRetprenodeBtn"
+    }
+```
+返回数据如下:
+```json
+{
+    "timestamp": 1613977993337,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/retprenode/3f28824f77c764f00177c774d8bb0000",
+    "data": "退回上一环节处理人成功",
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java 样例</b>
+适用于后端调用
+注入com.meritdata.cloud.bpm.core.BpmEngine类
+```java
+
+    @Autowired
+    BpmEngine bpmEngine;
+
+     /**
+     * 退回上一环节
+     */
+    @ApiOperation(value = "退回上一环节处理人", notes = "退回上一环节处理人")
+    @RequestMapping(value = "/retprenode",method = RequestMethod.POST)
+    public ResultBody<String> processRetprenode() {
+        String businessId = "3f28824f77c764f00177c774d8bb0000";
+        Map map = new HashMap();
+        map.put("procInstId","57f63abb-74b1-11eb-bd66-00d861edd189");
+        map.put("businessId","3f28824f77c764f00177c774d8bb0000");
+        map.put("bpmOperName","退回上一环节处理人");
+        map.put("bpmOperValue","bpmRetprenodeBtn");
+        // 调用退回上一环节
+        return bpmEngine.processRetprenode(businessId,map);
+    }
+
+```
+## 10. 流程设计器列表查询
+说明：获取流程设计，根据查询条件获取 全部(全部版本的流程)，已发布(已发布版本的流程)，
+未发布(未发布版本的流程)，最高版本(最高版本的流程)，默认(最高版本的流程+已发布版本的流程)
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/page`
+* PathVariables
+    ```
+    无
+    ```
+* RequestParams:
+| 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+| ---------- |-------- |-------- | ----------- | ---- |
+| procTypeId | String      |是       | 流程实例类型id   |    默认为-1  |
+| keyword | String      |是       | 流程名称或者ID   |      |
+| publishStatus |String      | 是      | 版本状态| versionType:value=""   全部        ----  全部(全部版本的流程)，value="1"  已发布      ----- 已发布(已发布版本的流程)，value="0"  未发布      ----- 未发布(未发布版本的流程)，value="2"  最高版本    ----- 最高版本(最高版本的流程)，value="3"  默认        ----- 默认(最高版本的流程+已发布版本的流程)|
+| page| String    | 是       | 页数 | |
+| rows | String      |是       | 条数   |      |
+* ResponseBody
+    返回数据类型：ProcItemDTO
+<b>Postman测试样例：</b>
+适用于前端直接调用
+案例使用 
+<gateway-host>
+<gateway-port>
+<service-name> 服务
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/page
+```json
+    {
+        "body":"{"procTypeId":"-1","keyword":"","publishStatus":"3","page":1,"rows":10}"
+    }
+```
+返回数据如下:
+```json
+        "timestamp": 1615001022990,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/page",
+    "data": {
+        "rows": [
+            {
+                "page": null,
+                "rows": null,
+                "order": null,
+                "sort": null,
+                "id": "3f28824f780535ca0178056766730002",
+                //流程名称
+                "procName": "fsfsd",
+                // 流程ID
+                "procId": "fsdfsdf",
+                "moduleId": null,
+                //流程类型名称
+                "moduleName": "aaa",
+                //显示流程名称
+                "displayName": "fsfsd",
+                "sortNo": 1,
+                //树的父节点ID
+                "parentId": "3f28824f780535ca0178056749d10000",
+                "type": "item",
+                "fileName": "fsfsd.bpmn20.xml",
+                "procTypeId": null,
+                "procTypeName": "aaa",
+                //版本
+                "version": 0,
+                "publishStatus": "0",
+                "procTypeCode": null,
+                "keyword": null,
+                "configDTO": null,
+                "procDefByteDTOs": [
+                    {
+                        "id": "3f28824f780535ca01780567664a0001",
+                        "activeStatus": 0,
+                        "bpmnFile": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<bpmn:definitions xmlns:bpmn=\"http://www.omg.org/spec/BPMN/20100524/MODEL\" xmlns:bpmndi=\"http://www.omg.org/spec/BPMN/20100524/DI\" xmlns:di=\"http://www.omg.org/spec/DD/20100524/DI\" xmlns:dc=\"http://www.omg.org/spec/DD/20100524/DC\" xmlns:camunda=\"http://camunda.org/schema/1.0/bpmn\" xmlns:xsi=\"http://www.w3.org/2001/XMLSchema-instance\" id=\"Definitions_02dbze3\" targetNamespace=\"http://bpmn.io/schema/bpmn\" exporter=\"Camunda Modeler\" exporterVersion=\"3.7.1\">\n<bpmn:process id=\"fsdfsdf\" name=\"fsfsd\" isExecutable=\"true\">\n    <bpmn:documentation>{\"formLink\":\"/bpm/example/index.html#/form?id=businessId\",\"appModuleName\":\"aaa\",\"appModuleId\":\"aaaaa\",\"appSystemName\":\"BPM系统\",\"appSystemId\":\"BPM\"}</bpmn:documentation>\n  </bpmn:process>\n  <bpmndi:BPMNDiagram id=\"BpmnDiagram_1\">\n    <bpmndi:BPMNPlane id=\"BpmnPlane_1\" bpmnElement=\"fsdfsdf\">\n    </bpmndi:BPMNPlane>\n  </bpmndi:BPMNDiagram>\n</bpmn:definitions>",
+                        "fileName": "fsfsd.bpmn20.xml",
+                        "modifyTime": null,
+                        "moduleName": "aaa",
+                        "processId": "fsdfsdf",
+                        "processName": "fsfsd",
+                        "version": 0,
+                        "procTypeId": "3f28824f780535ca0178056749d10000"
+                    }
+                ],
+                "orgReadConfigDTO": null,
+                "deptReadConfigDTO": null,
+                "deptPartConfigDTO": null
+            },
+            {
+                "page": null,
+                "rows": null,
+                "order": null,
+                "sort": null,
+                "id": "3f28824f77c764dc0177c76fc3ad0002",
+                "procName": "Process_Demo1",
+                "procId": "Process_Demo1",
+                "moduleId": null,
+                "moduleName": "差旅费",
+                "displayName": "Process_Demo1",
+                "sortNo": 1,
+                "parentId": "3f28824f77c764dc0177c76f63ca0000",
+                "type": "item",
+                "fileName": "Process_Demo1.bpmn20.xml",
+                "procTypeId": null,
+                "procTypeName": "差旅费",
+                "version": 13,
+                "publishStatus": "1",
+                "procTypeCode": null,
+                "keyword": null,
+                "configDTO": null,
+                "procDefByteDTOs": [
+                    {
+                        "id": "3f28824f78018e07017801d8ffc40008",
+                        "activeStatus": 1,
+                        "bpmnFile": "",
+                        "fileName": "Process_Demo1.bpmn20.xml",
+                        "modifyTime": null,
+                        "moduleName": "差旅费",
+                        "processId": "Process_Demo1",
+                        "processName": "Process_Demo1",
+                        "version": 13,
+                        "procTypeId": "3f28824f77c764dc0177c76f63ca0000"
+                    }
+                ],
+                "orgReadConfigDTO": null,
+                "deptReadConfigDTO": null,
+                "deptPartConfigDTO": null
+            },
+            {
+                "page": null,
+                "rows": null,
+                "order": null,
+                "sort": null,
+                "id": "3f28824f77f075060177f17a2e070003",
+                "procName": "travel_expense",
+                "procId": "travel_expense",
+                "moduleId": null,
+                "moduleName": "差旅费",
+                "displayName": "travel_expense",
+                "sortNo": 1,
+                "parentId": "3f28824f77c764dc0177c76f63ca0000",
+                "type": "item",
+                "fileName": "travel_expense.bpmn20.xml",
+                "procTypeId": null,
+                "procTypeName": "差旅费",
+                "version": 0,
+                "publishStatus": "1",
+                "procTypeCode": null,
+                "keyword": null,
+                "configDTO": null,
+                "procDefByteDTOs": [
+                    {
+                        "id": "3f28824f77f075060177f17a2de30002",
+                        "activeStatus": 1,
+                        "bpmnFile": "",
+                        "fileName": "travel_expense.bpmn20.xml",
+                        "modifyTime": null,
+                        "moduleName": "差旅费",
+                        "processId": "travel_expense",
+                        "processName": "travel_expense",
+                        "version": 0,
+                        "procTypeId": "3f28824f77c764dc0177c76f63ca0000"
+                    }
+                ],
+                "orgReadConfigDTO": null,
+                "deptReadConfigDTO": null,
+                "deptPartConfigDTO": null
+            }
+        ],
+        "total": 3,
+        "pageSize": 0,
+        "pageNumber": 0,
+        "totalPages": 0,
+        "records": 0
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java 样例</b>
+适用于后端调用
+注入com.meritdata.cloud.bpm.core.BpmEngine类
+```java
+
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "流程列表", notes = "获取流程列表")
+    @RequestMapping(value = "/page", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<GridView<ProcItemDTO>> getProcItemPage(){
+        Map variables = new HashMap();
+        variables.put("body","{\"procTypeId\":\"-1\",\"keyword\":\"\",\"publishStatus\":\"3\",\"page\":1,\"rows\":10}");
+        return  bpmEngine.getPage(variables);
+    }
+
+```
+## 11. 个人待办
+说明：获取当前登录用户的待办列表
+* method : `POST`
+* url : `http://IP:端口号/gateway/服务名/api/bpm/core/undoPage`
+* RequestParams：
+| 参数        | 是否必须 | 释义       | 备注 |
+| ----------- | -------- | ---------- | ---- |
+| page | 否       | 页数 |  默认 1    |
+| rows | 否       | 行数 |  默认 10    |
+|subject|否|标题||
+|dealStatus|否|处理状态|默认是 2  ,未办理0、已办理1、 全部2|
+|isContainsDrafter|否|是否包含起草状态|默认 0  包含|
+|drafterName|否|拟稿人||
+|procDefKey|否|流程定义key|多值，按逗号拼接|
+|taskName|否|任务名称|过滤该任务名称|
+|createTimeSort|否|是否根据申请时间倒序|默认是根据处理时间倒序|
+|userName|否|用户名|不传查询当前登录用户|
+* PathVariables
+```json
+无
+```
+* RequestBody
+```json
+无
+```
+* ResponseBody
+  返回数据类型：UndoDTO对象
+<b>Postman测试样例：</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/undoPage
+```json
+    "page":"1"
+    "rows":"10"
+```
+返回数据如下:
+```json
+{
+    "timestamp": 1615173114083,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/undoPage",
+    "data": {
+        "rows": [
+            {
+                "id": "3f28824f780fcfe701780fd192bf0002",
+                //应用模块名称
+                "appModuleName": "差旅费",
+                // 应用模块编码
+                "appModuleId": "报销",
+                //所属系统id
+                "appSystemId": "BPM",
+                //业务id
+                "businessId": "3f28824f780fcff601780fd185b50000",
+                //所属系统名称
+                "appSystemName": "BPM系统",
+                //表单链接名称
+                "formName": "总监审批",
+                //表单链接地址
+                "formLink": "/<frontend-base>/example/index.html#/formRead?id=3f28824f780fcff601780fd185b50000",
+                //密级
+                "secret": "高级",
+                //待办标题
+                "subject": "测试1_2021-03-08 11:11_出差报销",
+                //紧急程度
+                "urgent": "普通",
+                //任务id
+                "taskId": "fdf4e8cd-7fbb-11eb-ad25-00d861edd189",
+                //任务名称
+                "taskName": "总监审批",
+                //任务编码
+                "taskDefKey": "Activity_0vjczzn",
+                //流程定义id
+                "procDefId": "Process_Demo1:14:400be900-7d9a-11eb-85a6-00d861edd189",
+                //流程定义Key
+                "procDefKey": "Process_Demo1",
+                //流程实例Id
+                "procInstId": "fc0f1229-7fbb-11eb-ad25-00d861edd189",
+                //待办发送人
+                "senderId": "test1",
+                //待办发送人
+                "senderName": "测试1",
+                //接收人id
+                "receiverId": "test1",
+                //接收人名字
+                "receiverName": "测试1",
+                //待办已处理人(接收人和处理人不一定相同，比例任意一人审批)
+                "dealerId": null,
+                //待办已处理人
+                "dealerName": null,
+                //流程中处理1，流程外阅知2,外出代理3
+                "undoType": "1",
+                //被代理人用户（单值）
+                "principalUserName": null,
+                //被代理人用户id（单值）
+                "principalUserId": null,
+                //处理状态：未办理0、已办理1
+                "dealStatus": "0",
+                "synStatus": null,
+                "synRTXStatus": null,
+                "isRead": null,
+                //拟稿人
+                "drafterName": "测试1",
+                //创建时间
+                "createTime": 1615456366000,
+                //审批时间
+                "updateTime": 1615456366000,
+                // 申请时间
+                "mainFormCreateTime": 1615864071000,
+                //操作类型 1 表示驳回
+                "operationType":"1"
+            }
+        ],
+        "total": 1,
+        "pageSize": 0,
+        "pageNumber": 0,
+        "totalPages": 0,
+        "records": 0
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+ ```java
+
+    @Autowired
+    BpmEngine bpmEngine;
+
+    @ApiOperation(value = "个人待办列表", notes = "个人待办列表")
+    @RequestMapping(value = "/undoPage", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<GridView<UndoDTO>> getUndoPage(){
+        Map variables = new HashMap();
+        variables.put("rows","10");
+        variables.put("page","1");
+        return bpmEngine.getUndoPage(variables);
+    }
+
+ ```
+## 12. 阅知
+### 12.1 获取送阅知候选人列表
+说明：获取当前任务节点送阅知候选人列表
+* method : `POST`
+* url : `http://IP:端口号/gateway/服务名/api/bpm/core/process/getSendReadUsers/{taskId}`
+* PathVariables
+  | 参数   | 参数类型 | 是否必须 | 释义   | 备注 |
+  | ------ | -------- | -------- | ------ | ---- |
+  | taskId | String   | 是       | 任务id |      |
+* RequestParams
+  | 参数                              | 参数类型 | 是否必须 | 释义         | 备注                                                         |
+  | --------------------------------- | -------- | -------- | ------------ | ------------------------------------------------------------ |
+  | procInstId                        | String   | 是       | 流程实例id   |                                                              |
+  | bpmDrafterId                      | String   | 否       | 起草人id     |                                                              |
+  | runtime\[mainForm\]\[procInstId\] | String   | 否       | 主流程实例id | 当前流程为子流程时，procInstId 为子流程实例id，需取runtime\[mainForm\]\[procInstId\]获取主流程id,所以当前为子流程的任务节点时需要传此参数 |
+  | businessId                        | String   | 否       | 业务Id       |                                                              |
+RequestBody
+返回数据类型：List<BpmUser>
+<b>Postman测试样例：</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/process/getSendReadUsers/2d9ad75d-99d8-11eb-9638-70b5e84e90b6?procInstId=2b722b36-99d8-11eb-9638-70b5e84e90b6
+返回数据如下：
+```json
+{
+    "timestamp": 1618046381953,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/process/getSendReadUsers/2d9ad75d-99d8-11eb-9638-70b5e84e90b6",
+    "data": [
+        {
+            "code": "testUserCode",
+            "name": "testUserName",
+            "sex": null,
+            "email": null,
+            "telPhone": null,
+            "deptCode": "merit",
+            "deptName": "美林数据",
+            "dLevel": null,
+            "hSort": 0,
+            "mSort": 0,
+            "lSort": 0,
+            "isMainDept": 0,
+            "workGroupId": null,
+            "workGroupName": null,
+            "roleId": null,
+            "roleName": null
+        },
+        {
+            "code": "test1",
+            "name": "测试1",
+            "sex": null,
+            "email": null,
+            "telPhone": null,
+            "deptCode": "merit",
+            "deptName": "美林数据",
+            "dLevel": null,
+            "hSort": 0,
+            "mSort": 0,
+            "lSort": 0,
+            "isMainDept": 0,
+            "workGroupId": null,
+            "workGroupName": null,
+            "roleId": null,
+            "roleName": null
+        }
+    ],
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+    适用于后端调用
+    注入com.meritdata.cloud.bpm.core.BpmEngine类
+- ```java
+  	@Autowired
+      BpmEngine bpmEngine;
+      @ApiOperation(value = "获取送阅知候选人", notes = "获取送阅知候选人")
+      @RequestMapping(value = "/process/getSendReadUsers/{taskId}", method = RequestMethod.POST)
+      public @ResponseBody
+      ResultBody<List<BpmUser>> getSendReadUsers() {
+          String taskId = "2d9ad75d-99d8-11eb-9638-70b5e84e90b6";
+          Map variables = new HashMap();
+          variables.put("procInstId","2b722b36-99d8-11eb-9638-70b5e84e90b6");
+          ResultBody<List<BpmUser>> sendReadUsers = (List<BpmUser>) bpmEngine.getSendReadUsers(taskId, 		variables).getData.get("sendReadUsers");
+          return sendReadUsers;
+      }
+  ```
+
+
+### 12.2 发送阅知
+
+说明：发送阅知
+
+- method : `POST`
+
+- url : `http://IP:端口号/gateway/服务名/api/bpm/core/process/sendingRead/{procInstId}`
+
+- PathVariables
+
+
+| 参数       | 参数类型 | 是否必须 | 释义   | 备注 |
+| ---------- | -------- | -------- | ------ | ---- |
+| procInstId | String   | 是       | 实例id |      |
+
+- RequestParams
+
+
+| 参数      | 参数类型           | 是否必须 | 释义                                                         | 备注 |
+| --------- | ------------------ | -------- | ------------------------------------------------------------ | ---- |
+| userCodes | Map<String,Object> | 是       | {用户编码：用户名 }  （key为用户编码，value为用户名的map集合） |      |
+
+- RequestBody
+
+返回数据类型：String
+
+<b>Postman测试样例：</b>
+适用于前端直接调用
+
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/process/sendingRead/6a27d1d1-9b2d-11eb-bc6b-70b5e84e90b6?testUserCode=testUserName
+
+返回数据如下：
+
+```json
+{
+    "timestamp": 1618194127989,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/process/sendingRead/6a27d1d1-9b2d-11eb-bc6b-70b5e84e90b6",
+    "data": "发送阅知成功",
+    "extraInfo": {},
+    "success": true
+}
+```
+
+**java测试样例:**
+    适用于后端调用
+    注入com.meritdata.cloud.bpm.core.BpmEngine类
+
+```java
+	@Autowired
+    BpmEngine bpmEngine;
+    @ApiOperation(value = "发送阅知", notes = "发送阅知")
+    @RequestMapping(value = "/process/sendingRead/{procInstId}", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<String> getSendReadUsers() {
+        String procInstId = "a27d1d1-9b2d-11eb-bc6b-70b5e84e90b6";
+        Map userCodes = new HashMap();
+        userCodes.put("testUserCode","testUserName");
+        userCodes.put("testUserCode1","testUserName2");
+        ResultBody<String> result = bpmEngine.sendingRead(procInstId, userCodes);
+        return result;
+    }
+```
+
+### 12.3 阅知完毕
+
+说明：阅知完毕 
+
+- method: `POST`
+
+- url: `http://IP:端口/gateway/服务名/api/bpm/core/process/sendReadEnd/{procInstId}`
+
+- PathVariables
+
+| 参数       | 参数类型 | 是否必须 | 释义       | 备注 |
+| ---------- | -------- | -------- | ---------- | ---- |
+| procInstId | String   | 是       | 流程实例id |      |
+
+- RequestParams
+
+```
+无
+```
+
+- ResponseBody
+  返回数据类型：String
+
+<b>Postman样例:</b>
+适用于前端直接调用
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/process/sendReadEnd/6a27d1d1-9b2d-11eb-bc6b-70b5e84e90b6
+
+```json
+{
+    "timestamp": 1618196627424,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/process/sendReadEnd/6a27d1d1-9b2d-11eb-bc6b-70b5e84e90b6",
+    "data": "阅知完毕",
+    "extraInfo": {},
+    "success": true
+}
+```
+
+**java测试样例:**
+    适用于后端调用
+    注入com.meritdata.cloud.bpm.core.BpmEngine类
+
+```java
+@Autowired
+    BpmEngine bpmEngine;
+    @ApiOperation(value = "阅知完毕", notes = "阅知完毕")
+    @RequestMapping(value = "/process/sendReadEnd/{procInstId}", method = RequestMethod.POST)
+    public @ResponseBody
+    ResultBody<String> sendReadEnd() {
+        String procInstId = "a27d1d1-9b2d-11eb-bc6b-70b5e84e90b6";
+        ResultBody<String> result = bpmEngine.sendReadEnd(procInstId);
+        return result;
+    }
+```
+
+## 13. 流程最新定义ID
+
+说明: 查询流程分类编码
+
+- method : POST
+
+- url : `http://IP:端口/gateway/服务名/api/bpm/core/ruleengine/{procDefKey}`
+
+- RequestParams：
+
+  无
+
+- PathVariables
+
+| 参数       | 参数类型 | 是否必须 | 释义    | 备注 |
+| ---------- | -------- | -------- | ------- | ---- |
+| procDefKey | String   | 是       | 流程key |      |
+
+- RequestBody
+
+```json
+无
+```
+
+- ResponseBody
+
+返回数据类型：String对象     流程定义ID
+
+Postman测试样例：
+
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/ruleengine/Process_Demo1
+
+```json
+{
+    "timestamp": 1630131273084,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/ruleengine/Process_Demo1",
+    "data": "Process_Demo1:63:067e2222-0720-11ec-846e-70b5e84e90b6",
+    "extraInfo": {},
+    "success": true
+}
+```
+
+<b>java样例</b>
+适用于后端调用,结合业务数据筛选使用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+
+```java
+@Autowired
+    BpmEngine bpmEngine;
+    @ApiOperation(value = "获取流程最新定义ID", notes = "根据流程定义Key查询最新的流程定义ID")
+    @RequestMapping(value = "/get/{procDefKey}", method = RequestMethod.POST)
+    public @ResponseBody ResultBody<String> getLatestProcDefId(@PathVariable("procDefKey") String procDefKey) {
+        // 调用查询流程实例
+        ResultBody<String> procDefId = bpmEngine.getLatestProcDefId(procDefKey);
+        return procDefId.getData();
+    }
+```
+
+
+## 14. 业务相关接口
+
+### 14.1 删除流程实例接口
+说明：该接口只会删除流程实例数据,结合删除业务数据使用。
+* method : `POST`
+* url : `http://IP:端口号/gateway/服务名/api/bpm/core/api/engine/bpm/delete/procinsts`
+* RequestParams：
+
+```json
+无
+```
+
+* PathVariables
+
+```json
+无
+```
+
+* RequestBody
+
+| 参数        | 是否必须 | 释义       | 备注 |
+| ----------- | -------- | ---------- | ---- |
+| businessIds | 是       | 业务id集合 |      |
+
+* ResponseBody
+  返回数据类型：Boolean
+
+<b>Postman测试样例：</b>
+适用于前端直接调用
+
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/api/engine/bpm/delete/procinsts
+
+```json
+    ["3f28824f77c764f00177c8e789e20003","3f28824f77c764f00177c8e7722a0002"]
+```
+返回数据如下:
+```json
+{
+    "timestamp": 1613984939628,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/api/engine/bpm/delete/procinsts",
+    "data": true,
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java测试样例:</b>
+适用于后端调用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+ ```java
+    @Autowired
+    BpmEngine bpmEngine;
+     /**
+     * 删除流程实例
+     */
+    @ApiOperation(value = "删除流程实例", notes = "根据流程实例Ids删除流程实例")
+    @RequestMapping(value = "/delete/procinsts", method = RequestMethod.POST)
+    public ResultBody<Boolean> deleteProcInsts(){
+        List<String> businessIds = new ArrayList<>();
+        businessIds.add("3f28824f77cd7c0a0177cd89902a0001");
+        businessIds.add("3f28824f77cd7c0a0177cd89591d0000");
+        // 删除流程实例
+        return bpmEngine.deleteProcInsts(businessIds);
+    }
+ ```
+
+### 14.2 查询流程实例接口
+说明: 根据流程状态获取流程实例数据和业务数据结合使用
+
+* method : `POST`
+* url : `http://IP:端口/gateway/服务名/api/bpm/core/query/mainforms`
+* RequestParams：
+  
+  | 参数       | 参数类型 | 是否必须 | 释义        | 备注 |
+  | ---------- |-------- |-------- | ----------- | ---- |
+  | mainFormQueryDtoJson | String      |是       | 参数   |   {"subject":"标题模糊查询","bpmStatus":"all","orderFields":[{"desc":true,"field":"updateTime"}]}   |
+  | procDefKey | String      |是       | 流程key   |      |
+  | page |Long      | 否      | 页数| 默认是0|
+  | rows| Long    | 否       | 行数 | 默认是20|
+
+  |bpmStatus 状态| 说明|
+  |-------------|-----|
+  |my|我的工作（所有自己起草的流程和当前处理人是自己的,包含跟踪，拟稿，办结）|
+  |myAllDraft|所有我发起的流程|
+  |mydraft|我的拟稿 只查询自己起草的拟稿状态|
+  |mytrack|我的跟踪 只查询自己起草的跟踪状态|
+  |myover|我的办结 只查询自己起草的办结状态|
+  |all|所有工作（根据权限情况。包含跟踪，拟稿，办结）|
+  |alltrack|所有跟踪 根据权限情况，查询所有跟踪状态|
+|allover|所有办结 根据权限情况，查询所有办结状态|
+  
+* PathVariables
+
+  ```json
+  无
+  ```
+
+* RequestBody
+
+  ```json
+  无
+  ```
+
+* ResponseBody
+  返回数据类型：MainFormDTO对象
+
+Postman测试样例：
+
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/query/mainforms
+
+```json
+    {
+        "mainFormQueryDtoJson":"{"bpmStatus":"all","orderFields":[{"desc":true,"field":"updateTime"}]}",
+        "procDefKey":"Process_Demo1"
+    }
+```
+返回数据如下:
+```json
+{
+    "timestamp": 1614066616047,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/query/mainforms",
+    "data": {
+        "rows": [
+            {
+                "page": null,
+                "rows": null,
+                "order": null,
+                "sort": null,
+                "id": "3f28824f77cd8c4f0177cdc462060005",
+                //应用模块名称
+                "appModuleName": "差旅费",
+                //所属系统
+                "appSystemName": "BPM系统",
+                //流程定义id
+                "procDefId": "Process_Demo1:1:00078c50-74b1-11eb-bd66-00d861edd189",
+                //流程实例Id
+                "procInstId": "da94441c-75a7-11eb-bf67-00d861edd189",
+                //流程定义key
+                "procDefKey": "Process_Demo1",
+                //流程读者名称
+                "flowReaderNames": "测试1",
+                //流程作者名称，即流程处理人
+                "flowAuthorNames": "测试1",
+                //流程处理状态: draft草稿箱、track跟踪、over办结
+                "procDealStatus": "track",
+                //拟稿人名称
+                "drafterName": "测试1",
+                //拟稿部门名称
+                "drafterDeptName": "技术研发部",
+                //标题
+                "subject": "测试1_2021-02-23 15:22_出差报销",
+                //紧急程度
+                "urgent": "普通",
+                //密级
+                "secret": "高级",
+                //当前处理节点名
+                "nodeNames": "总监审批",
+                //锁定用户名称
+                "lockUserName": "测试1",
+                //锁定是否启用 1：启用
+                "lockStatus": null,
+                //流程设计版本号
+                "version": 0,
+                //业务id
+                "businessId": "3f28824f77cd8c600177cdc460940001",
+                "createTime": 1614064935000,
+                "updateTime": 1614236639000,
+                //操作类型 1 表示驳回
+                "operationType":"1"
+            }
+        ],
+        //总共条数
+        "total": 1,
+        "pageSize": 0,
+        "pageNumber": 0,
+        "totalPages": 0,
+        "records": 0
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+<b>java样例</b>
+适用于后端调用,结合业务数据筛选使用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+ ```java
+    @Autowired
+    BpmEngine bpmEngine;
+    @ApiOperation(value = "流程实例获取", notes = "根据流程key和人员编码，获取所有流程实例")
+    @RequestMapping(value = "/query/mainforms", method = RequestMethod.POST)
+    public @ResponseBody ResultBody<GridView> queryMainForms() {
+        MainFormQueryDTO formQuery = new MainFormQueryDTO();
+        // 流程状态
+        formQuery.setBpmStatus("all");
+        formQuery.setOrderFields(Lists.newArrayList(formQuery.new Field(MainFormQueryDTO.SORT_BY_UPDATE_TIME, true)));
+        String mainFormQueryDtoJson = JSON.toJSONString(formQuery);
+        String procDefKey = "Process_Demo1";
+        Long page = Long.parseLong("0");
+        Long rows = Long.parseLong("10");
+        // 调用查询流程实例
+        ResultBody<GridView> processInstanceVos = bpmEngine.queryMainForms(mainFormQueryDtoJson, procDefKey, page, rows);
+        return processInstanceVos;
+    }
+ ```
+
+### 14.3 查询我的申请实例接口
+
+说明: 根据流程状态获取流程实例数据和业务数据结合使用
+
+- method : `POST`
+
+- url : `http://IP:端口/gateway/服务名/api/bpm/core/query/my-apply`
+
+- RequestParams：
+
+  | 参数                 | 参数类型 | 是否必须 | 释义    | 备注                                                         |
+  | -------------------- | -------- | -------- | ------- | ------------------------------------------------------------ |
+  | mainFormQueryDtoJson | String   | 是       | 参数    | {"subject":"标题模糊查询","bpmStatus":"all","orderFields":[{"desc":true,"field":"updateTime"}]} |
+  | procDefKey           | String   | 是       | 流程key |                                                              |
+  | page                 | Long     | 否       | 页数    | 默认是0                                                      |
+  | rows                 | Long     | 否       | 行数    | 默认是20                                                     |
+
+  | bpmStatus 状态 | 说明                                                 |
+  | -------------- | ---------------------------------------------------- |
+  | all            | 我的工作（所有自己起草的流程。包含跟踪，拟稿，办结） |
+  | draft          | 拟稿 只查询自己起草的拟稿状态不包含退回的拟稿状态    |
+  | track          | 审批中 只查询自己起草的跟踪状态                      |
+  | over           | 我的办结 只查询自己起草的办结状态                    |
+  | reject         | 驳回 自己起草的被退回的                              |
+
+- PathVariables
+
+```json
+无
+```
+
+- RequestBody
+
+```json
+无
+```
+
+- ResponseBody
+
+返回数据类型：MainFormDTO对象
+
+Postman测试样例：
+
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/query/my-apply
+
+```json
+{
+    "mainFormQueryDtoJson":"{"bpmStatus":"all","orderFields":[{"desc":true,"field":"updateTime"}]}",
+    "procDefKey":"Process_Demo1"
+ }
+```
+
+返回数据如下:
+
+```json
+{
+    "timestamp": 1622103221862,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/query/my-apply",
+    "data": {
+        "rows": [
+            {
+                "page": null,
+                "rows": null,
+                "order": null,
+                "sort": null,
+                "id": "3f28830b79ac8c780179ac9830610014",
+                "appModuleName": "demo",
+                "appModuleId": "demo",
+                "appSystemId": "BPM",
+                "appSystemName": "BPM系统",
+                "procDefId": "Process_Demo1:9:fadf49cb-beb4-11eb-8ed4-70b5e84e90b6",
+                "procInstId": "0c4e4d28-beb8-11eb-aae4-70b5e84e90b6",
+                "procDefKey": "Process_Demo1",
+                "flowReaderIds": ",lisi,",
+                "flowReaderNames": "李四",
+                "flowAuthorIds": ",zs,",
+                "flowAuthorNames": "张三",
+                "procDealStatus": "draft",
+                "drafterName": "李四",
+                "drafterId": "lisi",
+                "drafterDeptId": "dashuju",
+                "drafterDeptName": "大数据",
+                "subject": "张三_2021-05-27 14:52_出差报销",
+                "urgent": "普通",
+                "secret": "高级",
+                "formLink": "/<frontend-base>/example/index.html#/formEdit?id=3f28830b79ac8cb80179ac982f790003",
+                "preActDealerId": "",
+                "preDealerId": "ohh",
+                "preActId": "",
+                "nodeIds": "Activity_01y0xh8",
+                "nodeNames": "起草",
+                "lockUserName": "张三",
+                "lockStatus": null,
+                "version": 0,
+                "businessId": "3f28830b79ac8cb80179ac982f790003",
+                "bpmVersion": 2,
+                "portalMode": "default",
+                "portalUrl": "",
+                "createTime": 1622098325000,
+                "updateTime": 1622098325000,
+                "operationType": null,
+                "approveUserIds": null,
+                "rejectUserId": null
+            }],
+        "total": 1,
+        "pageSize": 0,
+        "pageNumber": 0,
+        "totalPages": 0,
+        "records": 0
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+
+<b>java样例</b>
+适用于后端调用,结合业务数据筛选使用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+
+```java
+    @Autowired
+    BpmEngine bpmEngine;
+    @ApiOperation(value = "流程实例获取", notes = "根据流程key和人员编码，获取所有流程实例")
+    @RequestMapping(value = "/query/mainforms", method = RequestMethod.POST)
+    public @ResponseBody ResultBody<GridView> queryMainForms() {
+        MainFormQueryDTO formQuery = new MainFormQueryDTO();
+        // 流程状态
+        formQuery.setBpmStatus("all");
+        formQuery.setOrderFields(Lists.newArrayList(formQuery.new Field(MainFormQueryDTO.SORT_BY_UPDATE_TIME, true)));
+        String mainFormQueryDtoJson = JSON.toJSONString(formQuery);
+        String procDefKey = "Process_Demo1";
+        Long page = Long.parseLong("1");
+        Long rows = Long.parseLong("10");
+        // 调用查询流程实例
+        ResultBody<GridView> processInstanceVos = bpmEngine.queryMyApply(mainFormQueryDtoJson, procDefKey, page, rows);
+        return processInstanceVos;
+    }
+```
+
+### 14.4 查询我的审核实例接口
+
+说明: 根据流程状态获取流程实例数据和业务数据结合使用
+
+- method : `POST`
+
+- url : `http://IP:端口/gateway/服务名/api/bpm/core/query/my-approve`
+
+- RequestParams：
+
+  | 参数                 | 参数类型 | 是否必须 | 释义    | 备注                                                         |
+  | -------------------- | -------- | -------- | ------- | ------------------------------------------------------------ |
+  | mainFormQueryDtoJson | String   | 是       | 参数    | {"subject":"标题模糊查询","bpmStatus":"all","orderFields":[{"desc":true,"field":"updateTime"}]} |
+  | procDefKey           | String   | 是       | 流程key |                                                              |
+  | page                 | Long     | 否       | 页数    | 默认是0                                                      |
+  | rows                 | Long     | 否       | 行数    | 默认是20                                                     |
+
+  | bpmStatus 状态 | 说明                                                  |
+  | -------------- | ----------------------------------------------------- |
+  | all            | 我的工作（所有自己参与的审核包括待办，已办，驳回）    |
+  | approving      | 待审核                                                |
+  | approved       | 已审核通过的                                          |
+  | reject         | 驳回 （退回拟稿人的，退回上一节点的，退回任意节点的） |
+
+- PathVariables
+
+```json
+无
+```
+
+- RequestBody
+
+```json
+无
+```
+
+- ResponseBody
+
+返回数据类型：MainFormDTO对象
+
+Postman测试样例：
+
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/query/my-approve
+
+```json
+{
+    "mainFormQueryDtoJson":"{"bpmStatus":"all","orderFields":[{"desc":true,"field":"updateTime"}]}",
+    "procDefKey":"Process_Demo1"
+ }
+```
+
+返回数据如下:
+
+```json
+{
+    "timestamp": 1622103221862,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/query/my-apply",
+    "data": {
+        "rows": [
+            {
+                "page": null,
+                "rows": null,
+                "order": null,
+                "sort": null,
+                "id": "3f28830b79ac8c780179ac9830610014",
+                "appModuleName": "demo",
+                "appModuleId": "demo",
+                "appSystemId": "BPM",
+                "appSystemName": "BPM系统",
+                "procDefId": "Process_Demo1:9:fadf49cb-beb4-11eb-8ed4-70b5e84e90b6",
+                "procInstId": "0c4e4d28-beb8-11eb-aae4-70b5e84e90b6",
+                "procDefKey": "Process_Demo1",
+                "flowReaderIds": ",lisi,",
+                "flowReaderNames": "李四",
+                "flowAuthorIds": ",zs,",
+                "flowAuthorNames": "张三",
+                "procDealStatus": "draft",
+                "drafterName": "李四",
+                "drafterId": "lisi",
+                "drafterDeptId": "dashuju",
+                "drafterDeptName": "大数据",
+                "subject": "张三_2021-05-27 14:52_出差报销",
+                "urgent": "普通",
+                "secret": "高级",
+                "formLink": "/<frontend-base>/example/index.html#/formEdit?id=3f28830b79ac8cb80179ac982f790003",
+                "preActDealerId": "",
+                "preDealerId": "ohh",
+                "preActId": "",
+                "nodeIds": "Activity_01y0xh8",
+                "nodeNames": "起草",
+                "lockUserName": "张三",
+                "lockStatus": null,
+                "version": 0,
+                "businessId": "3f28830b79ac8cb80179ac982f790003",
+                "bpmVersion": 2,
+                "portalMode": "default",
+                "portalUrl": "",
+                "createTime": 1622098325000,
+                "updateTime": 1622098325000,
+                "operationType": null,
+                "approveUserIds": null,
+                "rejectUserId": null
+            }],
+        "total": 1,
+        "pageSize": 0,
+        "pageNumber": 0,
+        "totalPages": 0,
+        "records": 0
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+
+<b>java样例</b>
+适用于后端调用,结合业务数据筛选使用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+
+```java
+    @Autowired
+    BpmEngine bpmEngine;
+    @ApiOperation(value = "流程实例获取", notes = "根据流程key和人员编码，获取所有流程实例")
+    @RequestMapping(value = "/query/mainforms", method = RequestMethod.POST)
+    public @ResponseBody ResultBody<GridView> queryMainForms() {
+        MainFormQueryDTO formQuery = new MainFormQueryDTO();
+        // 流程状态
+        formQuery.setBpmStatus("all");
+        formQuery.setOrderFields(Lists.newArrayList(formQuery.new Field(MainFormQueryDTO.SORT_BY_UPDATE_TIME, true)));
+        String mainFormQueryDtoJson = JSON.toJSONString(formQuery);
+        String procDefKey = "Process_Demo1";
+        Long page = Long.parseLong("1");
+        Long rows = Long.parseLong("10");
+        // 调用查询流程实例
+        ResultBody<GridView> processInstanceVos = bpmEngine.queryMyApprove(mainFormQueryDtoJson, procDefKey, page, rows);
+        return processInstanceVos;
+    }
+```
+
+### 14.5 通过业务id获取流程实例
+
+说明: 根据业务id获取流程实例
+
+- method : `POST`
+
+- url : `http://IP:端口/gateway/服务名/api/bpm/core/query/mainform`
+
+- RequestParams：
+
+  | 参数       | 参数类型 | 是否必须 | 释义       | 备注 |
+  | ---------- | -------- | -------- | ---------- | ---- |
+  | businessId | String   | 是       | 业务表单Id |      |
+
+- PathVariables
+
+```json
+无
+```
+
+- RequestBody
+
+```json
+无
+```
+
+- ResponseBody
+
+返回数据类型：MainFormDTO对象
+
+Postman测试样例：
+
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/query/mainform
+
+```json
+{
+    "businessId": '3f28830b7b3d4163017b3d688eb00000'
+ }
+```
+
+返回数据如下:
+
+```json
+{
+    "timestamp": 1629254481659,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/query/mainform",
+    "data": {
+        "procDefId": "Process_Demo1:57:d2cda2b0-fbe0-11eb-b6c0-70b5e84e90b6",
+        "procInstId": "d7de05b1-fbe0-11eb-b6c0-70b5e84e90b6",
+        "procDefKey": null
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+
+<b>java样例</b>
+适用于后端调用,结合业务数据筛选使用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+
+```java
+ @Autowired
+    BpmEngine bpmEngine;
+    @ApiOperation(value = "通过业务id获取实例", notes = "通过业务id获取实例")
+    @RequestMapping(value = "/query/mainforms", method = RequestMethod.POST)
+    public @ResponseBody ResultBody<MainFormDTO> queryMainForm(@RequestParam String businessId) {
+        // 调用查询流程实例
+        ResultBody<MainFormDTO> mainformDTO = bpmEngine.queryMainFormsByBusinessId(businessId);
+        return mainformDTO;
+    }
+```
+
+## 15. 流程分类相关
+
+### 15.1 查询流程分类编码
+
+说明: 查询流程分类编码
+
+- method : GET
+
+- url : `http://IP:端口/gateway/服务名/api/bpm/core/query/proctypes`
+
+- RequestParams：
+
+  无
+
+- PathVariables
+
+```json
+无
+```
+
+- RequestBody
+
+```json
+无
+```
+
+- ResponseBody
+
+返回数据类型：Map<String，String>对象      key 分类编码     value  分类名称
+
+Postman测试样例：
+
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/query/proctypes
+
+```json
+{
+    "timestamp": 1629941964744,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/query/proctypes",
+    "data": {
+        "apply": "请假",
+        "travel": "差旅"  
+    },
+    "extraInfo": {},
+    "success": true
+}
+```
+
+<b>java样例</b>
+适用于后端调用,结合业务数据筛选使用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+
+```java
+@Autowired
+    BpmEngine bpmEngine;
+    @ApiOperation(value = "查询流程分类", notes = "查询流程分类")
+    @RequestMapping(value = "/query/proctypes", method = RequestMethod.GET)
+    public @ResponseBody ResultBody<Map<String,String>> queryProcTypes() {
+        // 调用查询流程实例
+        ResultBody<Map<String, String>> procTypes = bpmEngine.getProcTypes();
+        return procTypes;
+    }
+```
+
+### 15.2 添加表单地址
+
+说明: 查询流程分类编码
+
+- method : POST
+
+- url : `http://IP:端口/gateway/服务名/api/bpm/core/add/formaddress`
+
+- RequestParams：
+
+  | 参数     | 参数类型 | 是否必须 | 释义     | 备注 |
+  | -------- | -------- | -------- | -------- | ---- |
+  | name     | String   | 是       | 表单名称 |      |
+  | address  | String   | 是       | 表单地址 |      |
+  | sort     | Integer  | 否       | 排序号   |      |
+  | typecode | String   | 是       | 分类编码 |      |
+
+- PathVariables
+
+```json
+无
+```
+
+- RequestBody
+
+```json
+无
+```
+
+- ResponseBody
+
+返回数据类型：Boolean  
+
+Postman测试样例：
+
+https://<gateway-host>/<gateway-prefix>/<service-name>/api/bpm/core/add/formaddress
+
+```json
+{
+    "timestamp": 1629942567618,
+    "status": 1,
+    "message": "成功",
+    "stackmessage": null,
+    "path": "/api/bpm/core/add/formaddress",
+    "data": true,
+    "extraInfo": {},
+    "success": true
+}
+```
+
+<b>java样例</b>
+适用于后端调用,结合业务数据筛选使用
+ 注入com.meritdata.cloud.bpm.core.BpmEngine类
+
+```java
+@Autowired
+    BpmEngine bpmEngine;
+    @ApiOperation(value = "添加表单地址", notes = "添加表单地址")
+    @RequestMapping(value = "/add/formaddress", method = RequestMethod.POST)
+    public @ResponseBody ResultBody<Boolean> addFormAddress() {
+		String name = "测试表单地址";
+        String address = "/index.html";
+        Integer sort = 99;
+        String typecode = "apply";
+        // 调用查询流程实例
+        ResultBody<Boolean> result = bpmEngine.addFormAddress(name,address, sort, typecode);
+        return result;
+    }
+```