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

package/skills/meritdata-platform-bpm/references/bpm-engine-complete-methods.md

@@ -0,0 +1,150 @@
+# BpmEngine 完整方法清单（基于源码实测）
+
+> **来源**：`com.meritdata.cloud.bpm.core.BpmEngine.java`（位于 `cloud-system-bpm-module-core` 模块）
+> **类注解**：@RestController + @RequestMapping("/api/bpm/core")
+> **核实日期**：2026-09-10
+> **重要**：本文档基于源码实测，包含全部 **35 个方法**（skill 中此前只声明 13 个）
+> **关系**：本文档是 `api-reference.md` 的**完整补充**——后者是详细接口契约（2272 行），本文档是**方法索引**
+
+---
+
+## 一、13 个原方法（skill 历史声明）
+
+> ✅ **全部 13 个方法名与源码一致**（2026-09-10 核实通过）
+
+| # | 方法名 | URL | 返回类型 | 入参 | 备注 |
+|---|--------|-----|---------|------|------|
+| 1 | `ruleEngineInit` | `/ruleengine/init/{procDefKey}` | `ResultBody<RuleEngine>` | procDefKey: String, variables: Map | 规则引擎初始化 |
+| 2 | `ruleEngineRun` | `/ruleengine/run` | `ResultBody<RuleEngine>` | variables: Map | 规则引擎运行 |
+| 3 | `queryMainForms` | `/query/mainforms` | `ResultBody<GridView>` | mainFormQueryDtoJson: String, procDefKey: String, page: Long (0), rows: Long (20) | 流程实例分页查询 |
+| 4 | `startProcess` | `/{procDefKey}/startprocess` | `ResultBody<MainFormDTO>` | procDefKey: String, variables: Map | **唯一 throws Exception** |
+| 5 | `complete` | `/task/{id}/complete` | `ResultBody<MainFormDTO>` | id: String, variables: Map | 完成任务 |
+| 6 | `deleteProcInsts` | `/api/engine/bpm/delete/procinsts` | `ResultBody<Boolean>` | businessIds: List<String> (@RequestBody) | 删除流程实例 |
+| 7 | `processRetfirnode` | `/retfirnode/{businessId}` | `ResultBody<String>` | businessId: String, variables: Map | **注意拼写**（源码原样）|
+| 8 | `processRetprenode` | `/retprenode/{businessId}` | `ResultBody<String>` | businessId: String, variables: Map | **注意拼写**（源码原样）|
+| 9 | `getPage`（文字追踪重载）| `/step` | `ResultBody<List<ProcTrackDTO>>` | procInstId: String, mainFormId: String?, procDefId: String? | 流程文字追踪 |
+| 10 | `getGraphTrack` | `/graph` | `ResultBody<Map>` | procInstId: String, mainFormId: String?, procDefId: String? | 流程图形追踪 |
+| 11 | `getOpinions` | `/getOpinions` | `ResultBody<List<ProcOpinionDTO>>` | variables: Map | 获取审批意见 |
+| 12 | `addOrUpdate` | `/addOrUpdate` | `ResultBody<Boolean>` | variables: Map | 填写意见 |
+| 13 | `getUndoPage` | `/undoPage` | `ResultBody<GridView<UndoDTO>>` | variables: Map | 个人待办列表 |
+
+**重要提示**：`processRetfirnode` / `processRetprenode` 的非常规拼写在源码和 URL 注解中**完全一致**——并非 skill 笔误，是源码本身如此，**不应"修正"**。
+
+---
+
+## 二、补充的 22 个方法（skill 此前缺失）
+
+> **基于 2026-09-10 源码实测补充**——这些方法在 skill 中完全缺失
+
+### 2.1 流程实例查询（6 个）
+
+| # | 方法名 | URL | 返回类型 | 入参 |
+|---|--------|-----|---------|------|
+| 14 | `create` | `/deployment/create` (multipart) | `DeploymentWithDefinitionsVo` | upload: MultipartFile |
+| 15 | `queryMainFormsByBusinessId` | `/query/mainform` | `ResultBody<MainFormDTO>` | businessId: String |
+| 16 | `queryMainFormsByBusinessIds` | `/query/mainforms-businessIds` | `ResultBody<List<MainFormDTO>>` | businessIds: String |
+| 17 | `queryMainFormByProcDefKeys` | `/query/mainforms-procDefKeys` | `ResultBody<List<MainFormDTO>>` | procDefKeys: String |
+| 18 | `queryMyApply` | `/query/my-apply` | `ResultBody<GridView>` | mainFormQueryDtoJson, procDefKey, page, rows |
+| 19 | `queryMyApprove` | `/query/my-approve` | `ResultBody<GridView>` | mainFormQueryDtoJson, procDefKey, page, rows |
+
+### 2.2 流程操作辅助（8 个）
+
+| # | 方法名 | URL | 返回类型 | 入参 |
+|---|--------|-----|---------|------|
+| 20 | `validatePermit` | `/{procDefKey}/validate/permit` | `ResultBody<ProcPermitDTO>` | procDefKey: String |
+| 21 | `processRetRandomNodeStatus` | `/RetRandomNodeStatus/{businessId}/{toTaskDefKey}/{receiver}` | `ResultBody<String>` | businessId, toTaskDefKey, receiver, variables |
+| 22 | `getNodeTip` | `/tip` | `ResultBody<List>` | taskDefKey, procInstId?, mainFormId? |
+| 23 | `getPort` | `/port` | `ResultBody<String>` | 无 |
+| 24 | `getContent` | `/getContent` | `ResultBody<String>` | variables: Map |
+| 25 | `getPage`（**重载 #2 - 流程列表**）| `/page` | `ResultBody<GridView<ProcItemDTO>>` | variables: Map |
+| 26 | `getSendReadUsers` | `/process/getSendReadUsers/{taskId}` | `ResultBody<List<BpmUser>>` | taskId: String, variables: Map |
+| 27 | `sendingRead` | `/process/sendingRead/{procInstId}` | `ResultBody<String>` | procInstId, userCodes: Map<String,Object> |
+| 28 | `sendReadEnd` | `/process/sendReadEnd/{procInstId}` | `ResultBody<String>` | procInstId: String |
+| 29 | `getProcTypes` | `/query/proctypes` (GET) | `ResultBody<Map<String,String>>` | 无 |
+| 30 | `addFormAddress` | `/add/formaddress` | `ResultBody<Boolean>` | name, address, sort: Integer, typecode |
+| 31 | `getLatestProcDefId` | `/ruleengine/{procDefKey}` | `ResultBody<String>` | procDefKey: String |
+
+### 2.3 1.4.2 新增的 4 个查询接口（重大版本升级遗漏）
+
+| # | 方法名 | URL | 返回类型 | 入参 |
+|---|--------|-----|---------|------|
+| 32 | `queryMyUndo` | `/undo/query` | `ResultBody<GridView<UndoQueryResultVo>>` | queryDto: QueryUndoDto (@RequestBody) |
+| 33 | `queryMyInitiate` | `/mainform/query` | `ResultBody<GridView<MainformQueryResultVo>>` | queryDto: QueryMainformDto (@RequestBody) |
+| 34 | `queryProcMonitor` | `/procMonitor/query` | `ResultBody<GridView<MainMonitorQueryResultVo>>` | queryDto: QueryProcMonitorDto (@RequestBody) |
+| 35 | `queryProcByte` | `/procByte/query` | `ResultBody<GridView<ProcByteQueryResultVo>>` | queryDto: QueryProcByteDto (@RequestBody) |
+
+---
+
+## 三、`getPage` 重载方法说明（重要）
+
+`BpmEngine` 中存在**两个同名方法** `getPage`，绑定到不同 URL：
+
+| 重载 | URL | 返回类型 | 入参 | 用途 |
+|------|-----|---------|------|------|
+| #1 文字追踪 | `/step` | `ResultBody<List<ProcTrackDTO>>` | (procInstId, mainFormId?, procDefId?) | 流程文字追踪 |
+| #2 流程列表 | `/page` | `ResultBody<GridView<ProcItemDTO>>` | variables: Map | 流程列表查询 |
+
+skill 中描述的 `getPage` 未区分这两个重载，**调用时需注意 URL 区分**。
+
+---
+
+## 四、BPM Feign 接口（基于源码实测）
+
+### 4.1 IBpmCustomUserServiceClient
+
+- **类路径**：`com.meritdata.cloud.bpm.engine.feign`（模块 `cloud-system-bpm-engine`，**非** module-core）
+- **@FeignClient**：`${meritdata.cloud.custom-service-name}`, contextId=`processUserCustomServiceClient`, configuration=CloudFeignConfiguration
+- **方法（1 个）**：
+
+| 方法名 | 返回类型 | 入参 | URL |
+|--------|---------|------|-----|
+| `getUserCodes` | `List<String>` | controllerParameter: String (@PathVariable), methodsParameter: String (@PathVariable), params: Map (@RequestParam) | `POST /api/bpm/{controllerParameter}/getUserCode/{methodsParameter}` |
+
+### 4.2 ITaskRestServiceClient
+
+- **类路径**：`com.meritdata.cloud.bpm.core.feign`（模块 `cloud-system-bpm-module-core`，**非** engine.feign）
+- **@FeignClient**：`cloud-system-bpm-engine`, contextId=`taskRestServiceClient`
+- **方法（1 个有效方法）**：
+
+| 方法名 | 返回类型 | 入参 | URL |
+|--------|---------|------|-----|
+| `queryTasks` | `List<TaskVo>` | entity: String (@RequestBody), firstResult: Integer (@RequestParam), maxResults: Integer (@RequestParam) | `POST /engine-rest/task` |
+
+### 4.3 IDeploymentRestServiceClient
+
+- **类路径**：`com.meritdata.cloud.bpm.core.feign`（**非** engine.feign）
+- **@FeignClient**：`cloud-system-bpm-engine`, contextId=`deploymentRestServiceClient`
+- **方法（1 个）**：
+
+| 方法名 | 返回类型 | 入参 | URL |
+|--------|---------|------|-----|
+| `create` | `DeploymentWithDefinitionsVo` | upload: MultipartFile (@RequestPart) | `POST /engine-rest/deployment/create` |
+
+### 4.4 修正要点
+
+| 错误描述 | 正确描述 |
+|---------|---------|
+| `IBpmCustomUserServiceClient` 在 module-core | 实际在 `cloud-system-bpm-engine` 模块，包 `com.meritdata.cloud.bpm.engine.feign` |
+| `ITaskRestServiceClient` 在 `engine.feign` 包 | 实际在 `com.meritdata.cloud.bpm.core.feign` |
+| `IDeploymentRestServiceClient` 在 `engine.feign` 包 | 实际在 `com.meritdata.cloud.bpm.core.feign` |
+
+---
+
+## 五、与 skill api-reference.md 的关系
+
+| 文档 | 关系 |
+|------|------|
+| `api-reference.md`（2272 行）| **详细接口契约**——含完整 URL/参数/响应示例/网关前缀/调用样例。**未修改**，作为权威来源 |
+| **本文档**（35 方法索引）| **方法索引 + 重载/异常标注**——基于源码实测的"快速查询表" |
+
+两者互补：
+- 写代码 → 看 `api-reference.md`（含示例）
+- 选方法 → 看本文档（快速索引）
+
+---
+
+## 🔗 相关文档
+
+- `dev-docs/12_四业务组件-4.1工作流BpmEngine.md`（拆分源文件，Camunda 7.12.0 已核实）
+- `references/api-reference.md`（详细接口契约）
+- `references/components-ref/`（BPM 前端组件）

package/skills/meritdata-platform-bpm/references/bpm-engine-detail/12_/345/233/233/344/270/232/345/212/241/347/273/204/344/273/266-4.1/345/267/245/344/275/234/346/265/201BpmEngine.md

@@ -0,0 +1,86 @@
+---
+name: 工作流组件 BpmEngine
+source-file: 公共资产清单
+source-section: 4.1 工作流组件
+keywords: [BpmEngine, 工作流, Camunda, BPMN, startProcess, complete, processRetfirnode, processRetprenode, queryMainForms, getPage, getGraphTrack, getOpinions, getUndoPage, 流程追踪, 流程审批]
+use-cases: [流程发起, 流程审批, 流程退回, 流程追踪, 流程待办查询, 审批意见填写, 流程监听器开发, 自定义人员选择器]
+related: [16, 11]
+---
+
+# 工作流组件 BpmEngine
+
+> **原文章节**：`公共资产清单 → 4.1 工作流组件`
+> **行号范围**：L2179–L2235
+
+## 🎯 一句话
+基于 Camunda BPM 7.12.0 的工作流引擎，对外提供 13 个方法覆盖流程启动、审批、退回、删除、待办、追踪、意见等全场景。
+
+## 📋 接口/方法清单
+
+### 4.1 工作流组件-详细参考：应用开发平台-流程管理-使用攻略（一)：流程API接口.md
+
+基于 Camunda BPM 7.12.0 的工作流引擎，所有对外接口均通过 `BpmEngine` 提供。
+
+**二开服务使用方式**：通过 `@Autowired` 注入 `BpmEngine`，直接调用其方法。
+
+```
+@Autowired
+private BpmEngine bpmEngine;
+```
+
+方法概览表：
+
+| 来源类 | 方法名 | 作用场景 | 说明 |
+|------|--------|----------|------|
+| BpmEngine | startProcess | 启动流程 | 根据流程定义Key和businessId启动流程 |
+| BpmEngine | ruleEngineInit | 规则引擎初始化 | 查询流程按钮配置信息，初始化流程操作界面 |
+| BpmEngine | ruleEngineRun | 规则引擎执行 | 根据businessId查询待办任务 |
+| BpmEngine | complete | 完成任务 | 完成当前任务，推进流程到下一节点 |
+| BpmEngine | processRetfirnode | 退回拟稿人 | 退回流程至拟稿人（流程起点） |
+| BpmEngine | processRetprenode | 退回上一环节 | 退回流程至上一环节处理人 |
+| BpmEngine | deleteProcInsts | 删除流程实例 | 根据businessIds删除流程实例 |
+| BpmEngine | queryMainForms | 流程实例查询 | 分页查询流程实例列表 |
+| BpmEngine | getPage | 文字追踪 | 获取流程流转路径文字信息 |
+| BpmEngine | getGraphTrack | 图表追踪 | 获取流程图形追踪信息 |
+| BpmEngine | getOpinions | 审批意见 | 获取流程审批意见列表 |
+| BpmEngine | addOrUpdate | 填写意见 | 在节点填写审批意见 |
+| BpmEngine | getUndoPage | 个人待办列表 | 获取当前用户的待办任务列表 |
+
+**重要变量说明**：
+
+| 变量名 | 类型 | 说明 | 示例值 |
+|--------|------|------|--------|
+| businessId | String | 业务ID（唯一标识业务数据） | "3f28824f77d7e9a60177d8110b670002" |
+| procDefKey | String | 流程定义Key（在BPMN文件中定义） | "Process_Demo1" |
+| procInstId | String | 流程实例ID（启动后生成） | "57f63abb-74b1-11eb-bd66-00d861edd189" |
+| taskId | String | 任务ID（当前待办任务） | "9f2c6791-7748-11eb-90ec-00d861edd189" |
+| taskDefKey | String | 任务节点定义Key | "Activity_0vjczzn" |
+| procDefId | String | 流程定义ID（包含版本信息） | "Process_Demo1:4:d349d3dd-7689-11eb-ac36-00d861edd189" |
+| bpmOperValue | String | 操作按钮值（对应流程配置） | "bpmSendBtn"、"bpmRetfirnodeBtn" |
+| bpmOperName | String | 操作按钮名称 | "发送"、"退回" |
+| approve[type] | String | 审批方式 | "onlyApprove"（唯一审批）、"anyApprove"（或签）、"paraApprove"（会签）、"seqApprove"（顺序审批） |
+
+**组合场景表**：
+
+| 场景 | 使用场景 | 详细参考 |
+|------|----------|----------|
+| 流程API接口 | 了解BpmEngine提供的所有API接口，包括启动流程、完成任务、查询实例等 | 应用开发平台-流程管理-使用攻略（一）：流程API接口.md |
+| 工作流程应用开发 | 基于差旅费报销等业务场景，学习如何创建后端工程、配置流程、设计表单、集成前后端 | 应用开发平台-流程管理-使用攻略（二）：工作流程应用开发.md |
+| 监听表达式开发 | 开发自定义监听器jar包，实现流程监听表达式，在流程事件触发时执行自定义业务逻辑 | 应用开发平台-流程管理-使用攻略（三）：监听表达式开发.md |
+| 自定义人员 | 配置自定义人员选择器，通过后端接口动态返回流程下一环节的处理人 | 应用开发平台-流程管理-使用攻略（四）：自定义人员.md |
+| 待办同步门户开发 | 将流程产生的待办信息同步到其他门户页面处理，支持Portal和RTX两种方式 | 应用开发平台-流程管理-使用攻略（五）：待办同步门户开发.md |
+| 流程追踪页面嵌入表单 | 将流程追踪页面（文字追踪、图表追踪、审批意见）嵌入到自定义表单页面中 | 应用开发平台-流程管理-使用攻略（六）：流程追踪页面嵌入表单开发.md |
+| 流程模块设计 | 了解流程模块的整体设计思路、架构组成和业务逻辑 | 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md |
+
+## 💡 使用建议
+
+1. **businessId 必填唯一**：业务表主键作为 `businessId`，与流程实例强绑定，便于按业务数据反查流程状态。
+2. **退回策略**：拟稿人退回用 `processRetfirnode`，上一环节退回用 `processRetprenode`，注意传递 `taskId`。
+3. **审批方式关键**：节点配置 `onlyApprove` / `anyApprove` / `paraApprove` / `seqApprove` 直接影响 `complete` 行为的提交人选择。
+4. **前端协同**：BPM 流程页面（追踪/审批/意见）使用 `MeritBPM` 前端组件对应后端 API，详见 `16_五前端资产-5.1UI组件库-下半.md` 与 `公共资产清单 5.3 节`。
+
+## 🔗 相关章节
+
+- `11_三平台服务-3.6服务通知-CloudFeignMessageClient.md`（流程结果通过服务通知广播）
+- `16_五前端资产-5.1UI组件库-下半.md`（BPM 前端组件协同）
+- `公共资产清单 5.3 流程组件与方法`（MeritBPM 前端方法与后端 API 对应）

package/skills/meritdata-platform-bpm/references/components-ref//346/224/273/347/225/245-08-/346/265/201/347/250/213/345/211/215/347/253/257/347/273/204/344/273/266-00_/346/200/273/350/247/210.md

@@ -0,0 +1,66 @@
+---
+name: 攻略-08-流程前端组件-00_总览
+description: 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+related: [cloud-module-bpm / cloud-module-base]
+source: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档 — 总览
+
+**摘要**：美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+
+**关联**：cloud-module-bpm / cloud-module-base
+
+## 章节索引
+
+01. [概述](攻略-08-流程前端组件-章节01_概述.md)
+02. [组件与方法概览表](攻略-08-流程前端组件-章节02_组件与方法概览表.md) (原 1)
+03. [BpmFormTools - BPM表单工具组件](攻略-08-流程前端组件-章节03_BpmFormTools_-_BPM表单工具组件.md) (原 2)
+04. [BpmGridButtonsNew - BPM表格按钮组件](攻略-08-流程前端组件-章节04_BpmGridButtonsNew_-_BPM表格按钮组件.md) (原 3)
+05. [后端BpmEngine核心接口](攻略-08-流程前端组件-章节05_后端BpmEngine核心接口.md) (原 4)
+06. [附录](攻略-08-流程前端组件-章节06_附录.md) (原 5)
+
+## 引言
+
+**版本**：V1.0
+**日期**：2026-05-19
+**说明**：基于cloud-system-bpm-demo示例项目，详细说明BPM工作流前端组件的使用方法
+
+---
+
+
+## 📑 API 速查
+
+本攻略共 **2 个 API**（按章节排序）：
+
+| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
+|------|------|------|----------|------|------|
+| 章节03_BpmFormTools_-_BPM表单工具组件 | `BpmFormTools` | - | `-` | vue-component | BPM 表单工具 Vue 组件（Props / Events / 内部状态） |
+| 章节04_BpmGridButtonsNew_-_BPM表格按钮组件 | `BpmGridButtonsNew` | - | `-` | vue-component | BPM 表格按钮 Vue 组件（流程状态值 + 按钮事件） |
+
+### JSON Schema 完整索引
+
+```json
+[
+  {
+    "chapter": "章节03_BpmFormTools_-_BPM表单工具组件",
+    "apiName": "BpmFormTools",
+    "method": "",
+    "urlPattern": "",
+    "type": "vue-component",
+    "signature": "",
+    "functionDesc": "BPM 表单工具 Vue 组件（Props / Events / 内部状态）"
+  },
+  {
+    "chapter": "章节04_BpmGridButtonsNew_-_BPM表格按钮组件",
+    "apiName": "BpmGridButtonsNew",
+    "method": "",
+    "urlPattern": "",
+    "type": "vue-component",
+    "signature": "",
+    "functionDesc": "BPM 表格按钮 Vue 组件（流程状态值 + 按钮事件）"
+  }
+]
+```

package/skills/meritdata-platform-bpm/references/components-ref//346/224/273/347/225/245-08-/346/265/201/347/250/213/345/211/215/347/253/257/347/273/204/344/273/266-/347/253/240/350/212/20201_/346/246/202/350/277/260.md

@@ -0,0 +1,165 @@
+---
+name: 攻略-08-流程前端组件-章节01_概述
+description: 概述 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, 概述]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 无编号. 概述
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 概述
+
+本文档以 `cloud-system-bpm-demo` 示例项目为基础，介绍BPM工作流前端组件的实际使用方法。
+
+### 使用步骤：
+
+**1. 流程管理-流程Key，绑定二开服务某个模块的页面表单**
+
+在二开模块中，需要先与流程定义Key进行绑定。流程定义Key由流程管理员在流程设计器中创建，绑定后方可使用BPM组件进行流程操作。
+
+**2. 二开表格页需要新建、删除流程实例及业务数据、需要根据流程权限及流程状态对数据进行过滤，使用BpmGridButtonsNew组件**
+
+当二开模块需要在列表页展示业务流程数据时，使用 `BpmGridButtonsNew` 组件提供新建、我的申请、我的审批等按钮，通过组件事件处理查询、新建、删除等操作。
+
+1）引入组件，procDefKey为第一步创建的流程Key，传入组件
+
+```javascript
+  <bpm-grid-buttons-new
+            :procDefKey="procDefKey"
+            @bpm-query="queryBpm"
+            @bpm-delete="deleteRow"
+          />
+```
+
+2）需要改造二开接口，查询接口需要有procDefKey、bpmStatus的查询参数；删除的业务接口添加对流程实例的删除(参考5.4 删除流程实例)
+
+```javascript
+    // 查询数据
+    queryPageData() {
+      // 调用后端API查询列表
+      this.axios['cloud-system-bpm-demo']
+        .post('/page/procExample/page', {
+          procDefKey: this.procDefKey,
+          bpmStatus: this.bpmStatus,
+          pageNumber: this.currentPage,
+          pageSize: this.pageSize
+        })
+        .then(res => {
+          this.gridData = res.data.rows;
+          this.total = res.data.total;
+        });
+    },
+```
+
+```java
+   // 二开查询方法改造：
+	// 添加流程数据查询
+   		Map<String, Object> formQuery = new HashMap<>();
+        long firstResult = 0L;
+        long singleQueryData = 1000L;
+        List<Mpunitextertransfer> applyData = new ArrayList<>();
+        List<String> businessIds = new ArrayList<>();
+        formQuery.put("BpmStatus", param.get("bpmStatus"));
+        ResultBody<GridView> procData = bpmEngine.queryMainForms(JSON.toJSONString(formQuery), param.get("procDefKey").toString(), firstResult, singleQueryData);
+        if (procData.isSuccess()) {
+            List<Map<String, Object>> listData = new ArrayList<>();
+            listData = procData.getData().getRows();
+            listData.stream().forEach(item -> {
+                // 获取二开业务数据，以下为示例：
+                Mpunitextertransfer mpUnitExterTransfer =new Mpunitextertransfer();
+                mpUnitExterTransfer.setBusinessId((item.get("businessId") == null ? "" : item.get("businessId")).toString());
+                mpUnitExterTransfer.setLastTime((item.get("updateTime") == null ? "" : item.get("updateTime")).toString());
+                mpUnitExterTransfer.
+                setFlowAuthorNames((item.get("flowAuthorNames") == null ? "" : item.get("flowAuthorNames")).toString());
+                mpUnitExterTransfer.setNodeNames((item.get("nodeNames") == null ? "" : item.get("nodeNames")).toString());
+                businessIds.add(item.get("businessId").toString());
+                applyData.add(mpUnitExterTransfer);
+            });
+        }
+
+	// 进行二开业务逻辑操作......
+ 	// 最终合并数据，返回GridView
+        data.forEach(item -> {
+            applyData.stream().filter(item1 -> item.getId().equals(item1.getBusinessId()))
+                    .forEach(item1 -> {
+                        item.setNodeNames(item1.getNodeNames());
+                        item.setFlowAuthorNames(item1.getFlowAuthorNames());
+                        item.setLastTime(item1.getLastTime());
+                    });
+        });
+        return new GridView(data, l);
+```
+
+
+
+**3.二开表单页需要进行流程流转，发送、填写意见、流程追踪等操作，需要使用bpmFormTools组件**
+
+当用户在表单页需要发起审批、填写意见、查看流程进度时，使用 `BpmFormTools` 组件集成流程操作按钮，在init/save回调中处理业务数据与流程的关联。
+
+1）引入组件，procDefKey为第一步创建的流程Key，传入组件
+
+```javascript
+   <!-- BPM工具栏（必须放在表单开头） -->
+    <bpm-form-tools
+      :procDefKey="procDefKey"
+      @init="init"
+      @save="save"
+      ref="bpmformtools"
+    />
+```
+
+2）引入初始化及保存方法，传入组件
+
+```javascript
+// 初始化表单（由bpm-form-tools调用）
+    init(params) {
+      if (params.id == '') {
+        // 新建流程 - 获取当前用户信息
+        this.axios['system-manager']
+          .get('/api/ou/user/session')
+          .then(result => {
+            this.example.name = result.name;
+            this.example.belongDept = result.deptName;
+            this.example.project = result.name + '_' + this.formatDate(new Date()) + '_出差报销';
+            params.callback(this.example);
+          });
+      } else {
+        // 打开已有流程 - 加载业务数据（二开接口）
+        this.axios['cloud-system-bpm-demo']
+          .post('/get', { id: params.id })
+          .then(res => {
+            Object.assign(this.example, res.data);
+            this.example.undoId = params.undoId;
+            params.callback(this.example);
+          });
+      }
+    },
+
+    // 保存业务数据（由bpm-form-tools调用）
+    save(bpmSaveAfter) {
+        // 二开接口
+      this.axios['cloud-system-bpm-demo']
+        .post('/update', this.example)
+        .then(res => {
+          Object.assign(this.example, res.data);
+          // 流程相关逻辑处理
+          // 设置流程相关变量（必须）
+          this.example['bpmSubject'] = res.data.project;   // 流程标题（必填）
+          this.example['bpmUrgent'] = this.example.urgency;  // 紧急程度
+          this.example['bpmSecret'] = this.example.mj;   // 密级
+          // 开展二开相关业务逻辑....
+          // 必须调用此回调，触发流程保存后处理
+          bpmSaveAfter(this.example);
+        });
+    },
+```
+
+### 全局安装方式
+
+```javascript
+// cloud-module-bpm 全局安装
+import cloudModuleBpm from 'cloud-module-bpm';
+Vue.use(cloudModuleBpm);
+```
+
+---

package/skills/meritdata-platform-bpm/references/components-ref//346/224/273/347/225/245-08-/346/265/201/347/250/213/345/211/215/347/253/257/347/273/204/344/273/266-/347/253/240/350/212/20202_/347/273/204/344/273/266/344/270/216/346/226/271/346/263/225/346/246/202/350/247/210/350/241/250.md

@@ -0,0 +1,45 @@
+---
+name: 攻略-08-流程前端组件-章节02_组件与方法概览表
+description: 组件与方法概览表 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, 组件与方法概览表]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 1. 组件与方法概览表
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 一、组件与方法概览表
+
+### 1.1 前端组件
+
+| 来源 | 组件/方法名 | 作用场景 | 说明 |
+|------|------------|----------|------|
+| bpm-form-tools.vue | BpmFormTools | BPM表单工具组件 | 流程表单核心组件，集成发送、暂存等流程操作按钮 |
+| bpm-grid-buttons-new.vue | BpmGridButtonsNew | BPM表格按钮组件 | 流程列表页操作按钮，提供新建、我的申请、我的审批等 |
+
+### 1.2 后端接口
+
+| 来源类 | 方法名 | 作用场景 | 说明 |
+|------|--------|----------|------|
+| BpmEngine | startProcess | 启动流程 | 根据流程定义Key和businessId启动流程 |
+| BpmEngine | ruleEngineInit | 规则引擎初始化 | 查询流程按钮配置信息，初始化流程操作界面 |
+| BpmEngine | ruleEngineRun | 规则引擎执行 | 根据businessId查询待办任务 |
+| BpmEngine | complete | 完成任务 | 完成当前任务，推进流程到下一节点 |
+| BpmEngine | deleteProcInsts | 删除流程实例 | 根据businessIds删除流程实例 |
+| BpmEngine | queryMainForms | 流程实例查询 | 分页查询流程实例列表 |
+| BpmEngine | getPage | 文字追踪 | 获取流程流转路径文字信息 |
+| BpmEngine | getGraphTrack | 图表追踪 | 获取流程图形追踪信息 |
+| BpmEngine | getOpinions | 审批意见 | 获取流程审批意见列表 |
+| BpmEngine | addOrUpdate | 填写意见 | 在节点填写审批意见 |
+| BpmEngine | getUndoPage | 个人待办列表 | 获取当前用户的待办任务列表 |
+
+### 1.3 MeritBPM方法与后端API对应关系
+
+| MeritBPM方法 | 后端API | 说明 |
+|--------------|---------|------|
+| MeritBPM.create / initRuleEngine | POST /api/engine/bpm/ruleengine/init/{procDefKey} | 创建流程/初始化规则引擎 |
+| MeritBPM.open / runRuleEngine | POST /api/engine/bpm/ruleengine/run | 打开流程/运行规则引擎 |
+| MeritBPM.startProcess | POST /api/engine/bpm/{procDefKey}/startprocess | 发起流程 |
+| MeritBPM.validatePermit | POST /api/engine/bpm/{procDefKey}/validate/permit | 验证流程权限 |
+| MeritBPM.openProcTrackWindow | POST /api/engine/track/port | 打开流程跟踪窗口 |
+
+---

package/skills/meritdata-platform-bpm/references/components-ref//346/224/273/347/225/245-08-/346/265/201/347/250/213/345/211/215/347/253/257/347/273/204/344/273/266-/347/253/240/350/212/20203_BpmFormTools_-_BPM/350/241/250/345/215/225/345/267/245/345/205/267/347/273/204/344/273/266.md

@@ -0,0 +1,145 @@
+---
+name: 攻略-08-流程前端组件-章节03_BpmFormTools_-_BPM表单工具组件
+description: BpmFormTools - BPM表单工具组件 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, BpmFormTools - BPM表单工具组件]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 2. BpmFormTools - BPM表单工具组件
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 二、BpmFormTools - BPM表单工具组件
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "BpmFormTools",
+  "type": "vue-component",
+  "framework": "Vue 2.6 + Element UI",
+  "functionDesc": "BPM 表单工具 Vue 组件（Props / Events / 内部状态）",
+  "module": "cloud-module-bpm",
+  "props": [
+    "visible",
+    "title",
+    "value"
+  ],
+  "events": [
+    "confirm",
+    "cancel",
+    "close"
+  ],
+  "bestPractice": "使用 v-model 双向绑定，监听 @confirm 事件"
+}
+```
+
+**文件路径**: `cloud-module-bpm/packages/bpm-form-tools/bpm-form-tools.vue`
+
+**功能说明**: BPM表单核心工具组件，集成流程操作按钮（发送、暂存等），是流程表单页的必选组件。
+
+### 2.1 Props属性
+
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| procDefKey | String | true | 流程定义Key |
+
+### 2.2 Events事件
+
+| 事件名 | 说明 | 返回值 |
+|--------|------|--------|
+| init | 初始化事件，返回业务数据对象 | `{id, undoId, params, callback}` |
+| save | 保存事件，保存业务数据 | `{bpmSaveAfter, bpmBtn}` |
+
+### 2.3 组件内部状态
+
+| 状态名 | 类型 | 说明 |
+|--------|------|------|
+| ruleEngine | Object | 规则引擎对象，包含businessId、procInstId、undoId等 |
+| MeritBPM | Object | BPM工具对象 |
+
+### 3.4 实际使用示例（form-edit.vue）
+
+```vue
+<template>
+  <el-form ref="example" :model="example" label-width="80px" style="padding: 16px;width:850px;margin:20px auto;">
+    <!-- BPM工具栏（必须放在表单开头） -->
+    <bpm-form-tools
+      :procDefKey="procDefKey"
+      @init="init"
+      @save="save"
+      ref="bpmformtools"
+    />
+
+    <el-row><el-col style="font-size:24px;font-weight:bold">出差费用报销单</el-col></el-row>
+
+    <!-- 业务表单字段 ... -->
+  </el-form>
+</template>
+
+<script>
+import { MeritBPM } from 'cloud-module-bpm/packages/utils/merit-bpm.js';
+
+export default {
+  data() {
+    return {
+      MeritBPM,
+      procDefKey: 'Process_Demo1',
+      example: {
+        id: '',
+        project: '',
+        name: '',
+        belongDept: '',
+        amount: 0,
+        urgency: 'common',
+        mj: '1'
+      }
+    };
+  },
+  methods: {
+    // 初始化表单（由bpm-form-tools调用）
+    init(params) {
+      if (params.id == '') {
+        // 新建流程 - 获取当前用户信息
+        this.axios['system-manager']
+          .get('/api/ou/user/session')
+          .then(result => {
+            this.example.name = result.name;
+            this.example.belongDept = result.deptName;
+            this.example.project = result.name + '_' + this.formatDate(new Date()) + '_出差报销';
+            params.callback(this.example);
+          });
+      } else {
+        // 打开已有流程 - 加载业务数据
+        this.axios['cloud-system-bpm-demo']
+          .post('/get', { id: params.id })
+          .then(res => {
+            Object.assign(this.example, res.data);
+            this.example.undoId = params.undoId;
+            params.callback(this.example);
+          });
+      }
+    },
+
+    // 保存业务数据（由bpm-form-tools调用）
+    save(bpmSaveAfter) {
+      this.axios['cloud-system-bpm-demo']
+        .post('/update', this.example)
+        .then(res => {
+          Object.assign(this.example, res.data);
+          // 设置流程相关变量（必须）
+          this.example['bpmSubject'] = res.data.project;   // 流程标题（必填）
+          this.example['bpmUrgent'] = this.example.urgency;  // 紧急程度
+          this.example['bpmSecret'] = this.example.mj;   // 密级
+          // 必须调用此回调，触发流程保存后处理
+          bpmSaveAfter(this.example);
+        });
+    },
+
+    formatDate(date) {
+      return date.toISOString().split('T')[0];
+    }
+  }
+};
+</script>
+```
+
+---