npm - @alanwang-merit/meritdata-platform-skill-package - Versions diffs - 1.0.0 - Mend

@alanwang-merit/meritdata-platform-skill-package 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (359) hide show

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/.bak//345/272/224/347/224/250/345/274/200/345/217/221/345/271/263/345/217/260-/346/265/201/347/250/213/347/256/241/347/220/206-/344/275/277/347/224/250/346/224/273/347/225/245/357/274/210/344/270/200/357/274/211/357/274/232/346/265/201/347/250/213API/346/216/245/345/217/243.md ADDED Viewed

@@ -0,0 +1,2930 @@
+---
+title: 应用开发平台流程管理使用攻略（一）：流程API接口
+date: 2025.05.27
+categories:
+  - 开发攻略
+  - 6.13.2
+---
+# 应用开发平台流程管理使用攻略（一）：流程API接口
+## 前置条件
+        引入cloud-system-bpm-module-core包 版本为6.13.2
+## 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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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": "/bpm-demo/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": "/bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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": "/bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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": "/bpm-demo/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": "/bpm-demo/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": "/bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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": "/bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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\":\"/bpm-demo/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>/bpm-demo/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>/bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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测试样例:
+适用于前端直接调用
+案例使用
+127.0.0.1 IP
+8080 端口号
+cloud-system-bpm-demo 服务
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+案例使用
+127.0.0.1 IP
+8080 端口号
+cloud-system-bpm-demo 服务
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+案例使用
+127.0.0.1 IP
+8080 端口号
+cloud-system-bpm-demo 服务
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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": "/bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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测试样例：
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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>
+适用于前端直接调用
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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测试样例：
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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测试样例：
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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": "/bpm-demo/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测试样例：
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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": "/bpm-demo/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测试样例：
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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测试样例：
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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测试样例：
+http://127.0.0.1:8080/gateway/cloud-system-bpm-demo/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;
+    }
+```