@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/20206_/345/241/253/345/206/231/346/204/217/350/247/201/346/216/245/345/217/243.md

@@ -0,0 +1,192 @@
+---
+name: 攻略-01-流程API-章节06_填写意见接口
+description: 填写意见接口 — 美林平台 BPM 流程 HTTP API 接口全集（启动流程、完成任务、追踪、阅知、退回等）
+keywords: [BPM, 流程API, 工作流, 启动流程, 完成任务, 追踪, 退回, 阅知, Camunda, 填写意见接口]
+use-cases: [BPM 流程 API 调用, 流程审批集成, 流程追踪, 流程退回]
+source-section: 5. 填写意见接口
+source-file: 应用开发平台-流程管理-使用攻略（一）：流程API接口.md
+---
+
+# 5. 填写意见接口
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "addOrUpdate",
+  "method": "POST",
+  "urlPattern": "/api/bpm/core/addOrUpdate",
+  "signature": "Result addOrUpdate()",
+  "functionDesc": "某个流程实例中的某个节点需要填写意见",
+  "module": "bpm.process",
+  "pathParameters": [
+    {
+      "name": "procInstId",
+      "type": "String",
+      "required": true,
+      "desc": "流程实例id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "procDefId",
+      "type": "String",
+      "required": true,
+      "desc": "流程定义id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "taskId",
+      "type": "String",
+      "required": true,
+      "desc": "任务id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "taskDefKey",
+      "type": "String",
+      "required": true,
+      "desc": "任务定义key",
+      "constraint": "非空"
+    },
+    {
+      "name": "content",
+      "type": "String",
+      "required": true,
+      "desc": "意见内容",
+      "constraint": "字符串"
+    },
+    {
+      "name": "type",
+      "type": "String",
+      "required": false,
+      "desc": "保存类型（save，publish）",
+      "constraint": "字符串"
+    }
+  ],
+  "requestParameters": [
+    {
+      "name": "procInstId",
+      "type": "String",
+      "required": true,
+      "desc": "流程实例id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "procDefId",
+      "type": "String",
+      "required": true,
+      "desc": "流程定义id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "taskId",
+      "type": "String",
+      "required": true,
+      "desc": "任务id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "taskDefKey",
+      "type": "String",
+      "required": true,
+      "desc": "任务定义key",
+      "constraint": "非空"
+    },
+    {
+      "name": "content",
+      "type": "String",
+      "required": true,
+      "desc": "意见内容",
+      "constraint": "字符串"
+    },
+    {
+      "name": "type",
+      "type": "String",
+      "required": false,
+      "desc": "保存类型（save，publish）",
+      "constraint": "字符串"
+    }
+  ],
+  "returnType": "Boolean",
+  "returnFields": [
+    "timestamp",
+    "status",
+    "message",
+    "data",
+    "success"
+  ],
+  "exceptionList": [
+    "BusinessException",
+    "SystemException"
+  ],
+  "exampleCall": "bpmEngine.addOrUpdate(...)",
+  "bestPractice": "传入 bpmOperName 和 bpmOperValue 必须匹配流程定义中的按钮配置"
+}
+```
+说明:某个流程实例中的某个节点需要填写意见
+
+* 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);
+    }
+```

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/20207_/346/240/271/346/215/256/344/273/273/345/212/241/350/212/202/347/202/271/350/216/267/345/217/226/346/204/217/350/247/201/345/206/205/345/256/271.md

@@ -0,0 +1,212 @@
+---
+name: 攻略-01-流程API-章节07_根据任务节点获取意见内容
+description: 根据任务节点获取意见内容 — 美林平台 BPM 流程 HTTP API 接口全集（启动流程、完成任务、追踪、阅知、退回等）
+keywords: [BPM, 流程API, 工作流, 启动流程, 完成任务, 追踪, 退回, 阅知, Camunda, 根据任务节点获取意见内容]
+use-cases: [BPM 流程 API 调用, 流程审批集成, 流程追踪, 流程退回]
+source-section: 6. 根据任务节点获取意见内容
+source-file: 应用开发平台-流程管理-使用攻略（一）：流程API接口.md
+---
+
+# 6. 根据任务节点获取意见内容
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "getContent",
+  "method": "POST",
+  "urlPattern": "/api/bpm/core/getContent",
+  "signature": "Result getContent()",
+  "functionDesc": "某个流程实例中的某个节点获取此节点的意见列表",
+  "module": "bpm.process",
+  "pathParameters": [
+    {
+      "name": "procInstId",
+      "type": "String",
+      "required": true,
+      "desc": "流程实例id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "procDefId",
+      "type": "String",
+      "required": true,
+      "desc": "流程定义id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "taskId",
+      "type": "String",
+      "required": true,
+      "desc": "任务id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "taskDefKey",
+      "type": "String",
+      "required": true,
+      "desc": "任务定义key",
+      "constraint": "非空"
+    }
+  ],
+  "requestParameters": [
+    {
+      "name": "procInstId",
+      "type": "String",
+      "required": true,
+      "desc": "流程实例id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "procDefId",
+      "type": "String",
+      "required": true,
+      "desc": "流程定义id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "taskId",
+      "type": "String",
+      "required": true,
+      "desc": "任务id",
+      "constraint": "非空字符串"
+    },
+    {
+      "name": "taskDefKey",
+      "type": "String",
+      "required": true,
+      "desc": "任务定义key",
+      "constraint": "非空"
+    }
+  ],
+  "returnType": "List<ProcOpinion>",
+  "returnFields": [
+    "timestamp",
+    "status",
+    "message",
+    "data",
+    "success"
+  ],
+  "exceptionList": [
+    "BusinessException",
+    "SystemException"
+  ],
+  "exampleCall": "bpmEngine.getContent(...)",
+  "bestPractice": "传入 bpmOperName 和 bpmOperValue 必须匹配流程定义中的按钮配置"
+}
+```
+
+说明:某个流程实例中的某个节点获取此节点的意见列表
+
+* 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);
+    }
+
+```