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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-01-/346/265/201/347/250/213API-/347/253/240/350/212/20210_/351/200/200/345/233/236/344/270/212/344/270/200/347/216/257/350/212/202/345/244/204/347/220/206/344/272/272/346/216/245/345/217/243.md

@@ -0,0 +1,183 @@
+---
+name: 攻略-01-流程API-章节10_退回上一环节处理人接口
+description: 退回上一环节处理人接口 — 美林平台 BPM 流程 HTTP API 接口全集（启动流程、完成任务、追踪、阅知、退回等）
+keywords: [BPM, 流程API, 工作流, 启动流程, 完成任务, 追踪, 退回, 阅知, Camunda, 退回上一环节处理人接口]
+use-cases: [BPM 流程 API 调用, 流程审批集成, 流程追踪, 流程退回]
+source-section: 9. 退回上一环节处理人接口
+source-file: 应用开发平台-流程管理-使用攻略（一）：流程API接口.md
+---
+
+# 9.  退回上一环节处理人接口
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "retprenode",
+  "method": "POST",
+  "urlPattern": "/api/bpm/core/retprenode/{businessId}",
+  "signature": "Result processRetprenode()",
+  "functionDesc": "退回上一环节处理人功能 当前任务实例退回到上一个任务节点",
+  "module": "bpm.process",
+  "pathParameters": [
+    {
+      "name": "businessId",
+      "type": "String",
+      "required": true,
+      "desc": "业务id",
+      "constraint": "非空字符串"
+    }
+  ],
+  "requestParameters": [
+    {
+      "name": "procInstId",
+      "type": "String",
+      "required": true,
+      "desc": "流程实例id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "businessId",
+      "type": "String",
+      "required": true,
+      "desc": "业务id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "bpmOperName",
+      "type": "String",
+      "required": true,
+      "desc": "操作名称",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "bpmOperValue",
+      "type": "String",
+      "required": true,
+      "desc": "操作值",
+      "constraint": "字符串"
+    },
+    {
+      "name": "bpmSubject",
+      "type": "String",
+      "required": false,
+      "desc": "待办标题",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "bpmUrgent",
+      "type": "String",
+      "required": false,
+      "desc": "紧急程度",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "bpmSecret",
+      "type": "String",
+      "required": false,
+      "desc": "密级程度",
+      "constraint": "非空，加密字符串"
+    }
+  ],
+  "returnType": "String",
+  "returnFields": [
+    "timestamp",
+    "status",
+    "message",
+    "data",
+    "success"
+  ],
+  "exceptionList": [
+    "BusinessException",
+    "SystemException"
+  ],
+  "exampleCall": "bpmEngine.processRetprenode(...)",
+  "bestPractice": "子流程中暂不支持"
+}
+```
+
+说明：退回上一环节处理人功能 当前任务实例退回到上一个任务节点
+子流程中暂不支持退回上一环节处理人
+
+* 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);
+    }
+
+```

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-01-/346/265/201/347/250/213API-/347/253/240/350/212/20211_/346/265/201/347/250/213/350/256/276/350/256/241/345/231/250/345/210/227/350/241/250/346/237/245/350/257/242.md

@@ -0,0 +1,314 @@
+---
+name: 攻略-01-流程API-章节11_流程设计器列表查询
+description: 流程设计器列表查询 — 美林平台 BPM 流程 HTTP API 接口全集（启动流程、完成任务、追踪、阅知、退回等）
+keywords: [BPM, 流程API, 工作流, 启动流程, 完成任务, 追踪, 退回, 阅知, Camunda, 流程设计器列表查询]
+use-cases: [BPM 流程 API 调用, 流程审批集成, 流程追踪, 流程退回]
+source-section: 10. 流程设计器列表查询
+source-file: 应用开发平台-流程管理-使用攻略（一）：流程API接口.md
+---
+
+# 10. 流程设计器列表查询
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "page",
+  "method": "POST",
+  "urlPattern": "/api/bpm/core/page",
+  "signature": "ProcItemDTO page(procTypeId: string, keyword: string, publishStatus: string, page: string, rows: string, procTypeId: string, keyword: string, publishStatus: string, page: string, rows: string)",
+  "functionDesc": "获取流程设计，根据查询条件获取 全部(全部版本的流程)，已发布(已发布版本的流程)，",
+  "module": "bpm.process",
+  "pathParameters": [
+    {
+      "name": "procTypeId",
+      "type": "String",
+      "required": true,
+      "desc": "流程实例类型id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "keyword",
+      "type": "String",
+      "required": true,
+      "desc": "流程名称或者ID",
+      "constraint": "非空"
+    },
+    {
+      "name": "publishStatus",
+      "type": "String",
+      "required": true,
+      "desc": "版本状态",
+      "constraint": "字符串"
+    },
+    {
+      "name": "page",
+      "type": "String",
+      "required": true,
+      "desc": "页数",
+      "constraint": "≥ 1"
+    },
+    {
+      "name": "rows",
+      "type": "String",
+      "required": true,
+      "desc": "条数",
+      "constraint": "≥ 1"
+    }
+  ],
+  "requestParameters": [
+    {
+      "name": "procTypeId",
+      "type": "String",
+      "required": true,
+      "desc": "流程实例类型id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "keyword",
+      "type": "String",
+      "required": true,
+      "desc": "流程名称或者ID",
+      "constraint": "非空"
+    },
+    {
+      "name": "publishStatus",
+      "type": "String",
+      "required": true,
+      "desc": "版本状态",
+      "constraint": "字符串"
+    },
+    {
+      "name": "page",
+      "type": "String",
+      "required": true,
+      "desc": "页数",
+      "constraint": "≥ 1"
+    },
+    {
+      "name": "rows",
+      "type": "String",
+      "required": true,
+      "desc": "条数",
+      "constraint": "≥ 1"
+    }
+  ],
+  "returnType": "ProcItemDTO",
+  "returnFields": [
+    "timestamp",
+    "status",
+    "message",
+    "data",
+    "success"
+  ],
+  "exceptionList": [
+    "BusinessException",
+    "SystemException"
+  ],
+  "exampleCall": "bpmEngine.getPage(...)",
+  "bestPractice": "传入 bpmOperName 和 bpmOperValue 必须匹配流程定义中的按钮配置"
+}
+```
+说明：获取流程设计，根据查询条件获取 全部(全部版本的流程)，已发布(已发布版本的流程)，
+未发布(未发布版本的流程)，最高版本(最高版本的流程)，默认(最高版本的流程+已发布版本的流程)
+
+* 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);
+    }
+
+```