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

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/20204_BpmGridButtonsNew_-_BPM/350/241/250/346/240/274/346/214/211/351/222/256/347/273/204/344/273/266.md

@@ -0,0 +1,239 @@
+---
+name: 攻略-08-流程前端组件-章节04_BpmGridButtonsNew_-_BPM表格按钮组件
+description: BpmGridButtonsNew - BPM表格按钮组件 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, BpmGridButtonsNew - BPM表格按钮组件]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 3. BpmGridButtonsNew - BPM表格按钮组件
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 三、BpmGridButtonsNew - BPM表格按钮组件
+
+## 📋 API 契约（机器可读）
+
+```json
+{
+  "apiName": "BpmGridButtonsNew",
+  "type": "vue-component",
+  "framework": "Vue 2.6 + Element UI",
+  "functionDesc": "BPM 表格按钮 Vue 组件（流程状态值 + 按钮事件）",
+  "module": "cloud-module-bpm",
+  "props": [
+    "visible",
+    "title",
+    "value"
+  ],
+  "events": [
+    "confirm",
+    "cancel",
+    "close"
+  ],
+  "bestPractice": "使用 v-model 双向绑定，监听 @confirm 事件"
+}
+```
+
+**文件路径**: `cloud-module-bpm/packages/bpm-grid-buttons-new/bpm-grid-buttons-new.vue`
+
+**功能说明**: BPM流程列表页操作按钮组件，提供新建、我的申请、我的审批、所有流程等下拉菜单按钮。
+
+### 3.1 Props属性
+
+| 属性名 | 类型 | 必填 | 说明 |
+|--------|------|------|------|
+| procDefKey | String | true | 流程定义Key |
+| isShowButton | Boolean | false | 是否显示按钮（默认true） |
+| isDisabledAddButton | Boolean | false | 新建按钮是否禁用 |
+
+### 3.2 Events事件
+
+| 事件名 | 说明 | 返回值 |
+|--------|------|--------|
+| bpm-query | 查询流程 | `bpmStatus` 流程状态值 |
+| bpm-delete | 删除流程 | - |
+
+### 3.3 流程状态值说明
+
+| 状态值 | 说明 | 所属菜单 |
+|--------|------|---------|
+| my | 我的申请 | 我的申请 |
+| mydraft | 我的草稿 | 我的申请 |
+| mytrack | 我的跟踪 | 我的申请 |
+| myover | 我的已完结 | 我的申请 |
+| approve | 待我审批 | 我的审批 |
+| all | 所有流程 | 所有流程 |
+
+### 4.4 实际使用示例（Grid.vue）
+
+```vue
+<template>
+  <el-container>
+    <el-main style="padding: 8px 12px;">
+      <!-- BPM流程按钮组 -->
+      <el-row justify="space-between" type="flex">
+        <el-col :span="7">
+          <bpm-grid-buttons-new
+            :procDefKey="procDefKey"
+            @bpm-query="queryBpm"
+            @bpm-delete="deleteRow"
+          />
+        </el-col>
+        <el-col :span="7">
+          <el-input
+            v-model="keyword"
+            @change="queryKeyword"
+            placeholder="请输入标题"
+            clearable
+            suffix-icon="el-icon-search"
+          >
+          </el-input>
+        </el-col>
+      </el-row>
+
+      <!-- 业务列表 -->
+      <el-table
+        stripe
+        ref="tables"
+        :data="gridData"
+        style="width: 100%"
+        :height="tableHeight"
+        @selection-change="handleSelectionChange"
+      >
+        <el-table-column type="selection" width="55" :selectable="checkDel"></el-table-column>
+        <el-table-column prop="project" label="标题"></el-table-column>
+        <el-table-column prop="procDealStatus" label="处理状态">
+          <template slot-scope="scope">
+            <el-tag>{{ statusLabel(scope.row.procDealStatus) }}</el-tag>
+          </template>
+        </el-table-column>
+        <el-table-column label="操作" width="100">
+          <template slot-scope="scope">
+            <el-button icon="el-icon-edit" @click="editRow(scope.$index, scope.row)" size="small"></el-button>
+          </template>
+        </el-table-column>
+      </el-table>
+
+      <el-pagination
+        @size-change="handleSizeChange"
+        @current-change="handleCurrentChange"
+        :current-page="currentPage"
+        :page-size="pageSize"
+        layout="total, sizes, prev, pager, next, jumper"
+        :total="total"
+      ></el-pagination>
+    </el-main>
+  </el-container>
+</template>
+
+<script>
+import { MeritBPM } from 'cloud-module-bpm/packages/utils/merit-bpm.js';
+
+export default {
+  data() {
+    return {
+      MeritBPM,
+      tableHeight: window.innerHeight - 180,
+      procDefKey: 'Process_Demo1',
+      selectRows: [],
+      bpmStatus: 'my'
+    };
+  },
+  created() {
+    // 初始化时验证流程权限
+    this.MeritBPM.validatePermit(this, this.procDefKey, null);
+    // 将刷新方法挂载到window，用于表单关闭后刷新
+    window.refreshBpmGrid = () => {
+      this.queryBpm(this.bpmStatus);
+    };
+    this.initLoadPage();
+  },
+  methods: {
+    // 由按钮组件触发的查询
+    queryBpm(type) {
+      this.$refs.tables.bodyWrapper.scrollTop = 0;
+      this.currentPage = 1;
+      this.bpmStatus = type;
+      this.queryPageData();
+    },
+
+    // 打开流程（办理）
+    editRow(index, row) {
+      MeritBPM.open(this, { businessId: row.id }, {});
+    },
+
+    // 删除流程
+    deleteRow() {
+      if (this.selectRows.length === 0) {
+        this.$message.warning('请选择需要删除的流程');
+        return;
+      }
+      let delIds = this.selectRows.map(row => row.id);
+      // 删除业务数据（后端删除流程实例）
+      this.batchDeleteExample({ ids: delIds });
+    },
+
+    // 选择框变化
+    handleSelectionChange(rows) {
+      this.selectRows = rows;
+    },
+
+    // 判断行是否可选（草稿或管理员可删除）
+    checkDel(row) {
+      return row.procDealStatus === 'draft' || MeritBPM.procManagePermit;
+    },
+
+    // 分页大小变化
+    handleSizeChange(val) {
+      this.pageSize = val;
+      this.currentPage = 1;
+      this.queryPageData();
+    },
+
+    // 页码变化
+    handleCurrentChange(val) {
+      this.$refs.tables.bodyWrapper.scrollTop = 0;
+      this.currentPage = val;
+      this.queryPageData();
+    },
+
+    // 状态标签
+    statusLabel(status) {
+      return 'status.' + status;
+    },
+
+    // 初始化加载
+    initLoadPage() {
+      this.currentPage = 1;
+      this.queryPageData();
+    },
+
+    // 查询数据
+    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;
+        });
+    },
+
+    // 批量删除
+    batchDeleteExample({ ids, callback }) {
+      this.axios['cloud-system-bpm-demo']
+        .post('/delete/batch', { ids: ids.join(',') })
+        .then(res => {
+          if (callback) callback(res.data);
+          this.initLoadPage();
+        });
+    }
+  }
+};
+</script>
+```
+
+---

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/20205_/345/220/216/347/253/257BpmEngine/346/240/270/345/277/203/346/216/245/345/217/243.md

@@ -0,0 +1,135 @@
+---
+name: 攻略-08-流程前端组件-章节05_后端BpmEngine核心接口
+description: 后端BpmEngine核心接口 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, 后端BpmEngine核心接口]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 4. 后端BpmEngine核心接口
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 四、后端BpmEngine核心接口
+
+完整包路径：`com.meritdata.cloud.bpm.core.BpmEngine`
+
+### 4.1 方法概览表
+
+| 来源类 | 方法名 | 作用场景 | 说明 |
+|------|--------|----------|------|
+| BpmEngine | startProcess | 启动流程 | 根据流程定义Key和businessId启动流程 |
+| BpmEngine | ruleEngineInit | 规则引擎初始化 | 查询流程按钮配置信息，初始化流程操作界面 |
+| BpmEngine | ruleEngineRun | 规则引擎执行 | 根据businessId查询待办任务 |
+| BpmEngine | complete | 完成任务 | 完成当前任务，推进流程到下一节点 |
+| BpmEngine | deleteProcInsts | 删除流程实例 | 根据businessIds删除流程实例 |
+| BpmEngine | queryMainForms | 流程实例查询 | 分页查询流程实例列表 |
+| BpmEngine | getPage | 文字追踪 | 获取流程流转路径文字信息 |
+| BpmEngine | getGraphTrack | 图表追踪 | 获取流程图形追踪信息 |
+
+### 4.2 启动流程
+
+```java
+@Autowired
+private BpmEngine bpmEngine;
+
+@Autowired
+private SessionUtils sessionUtils;
+
+/**
+ * 启动流程
+ */
+public MainFormDTO startProcess(String procDefKey, Map<String, Object> variables) {
+    // 设置拟稿人
+    variables.put("bpmDrafterId", sessionUtils.getCurrentUserName());
+
+    // 启动流程
+    ResultBody<MainFormDTO> resultBody = bpmEngine.startProcess(procDefKey, variables);
+
+    if (resultBody != null && resultBody.isSuccess()) {
+        return resultBody.getData();
+    }
+    return null;
+}
+```
+
+### 4.3 查询流程实例列表（分页）
+
+```java
+@Autowired
+private BpmEngine bpmEngine;
+
+/**
+ * 分页查询流程实例
+ */
+public GridView<Map> pageProcExample(String procDefKey, String bpmStatus, int pageNumber, int pageSize) {
+    // 构建流程查询条件
+    MainFormQueryDTO formQuery = new MainFormQueryDTO();
+    formQuery.setBpmStatus(bpmStatus);
+
+    // 调用BpmEngine查询流程主表
+    ResultBody<GridView> resultBody = bpmEngine.queryMainForms(
+        JSONUtil.toJsonStr(formQuery), procDefKey, (pageNumber - 1) * pageSize, pageSize
+    );
+
+    List<Map> mainForms = new ArrayList<>();
+    long total = 0;
+    if (resultBody != null && resultBody.isSuccess() && resultBody.getData() != null) {
+        mainForms = resultBody.getData().getRows();
+        total = resultBody.getData().getTotal();
+    }
+
+    // 将流程数据与业务数据关联
+    // ... 关联业务表数据 ...
+
+    return new GridView<>(mainForms, total);
+}
+```
+
+### 5.4 删除流程实例
+
+```java
+@Autowired
+private BpmEngine bpmEngine;
+
+/**
+ * 批量删除流程实例
+ * 注意：先删流程，再删业务数据
+ */
+public boolean deleteBatch(List<String> businessIds) {
+    // 1. 调用BpmEngine删除流程实例
+    ResultBody<Boolean> resultBody = bpmEngine.deleteProcInsts(businessIds);
+
+    if (resultBody != null && resultBody.isSuccess() && resultBody.getData()) {
+        // 2. 流程删除成功后，删除业务表数据
+        exampleRepository.deleteAllByIds(businessIds);
+        return true;
+    }
+    return false;
+}
+```
+
+### 5.5 获取流程跟踪信息
+
+```java
+/**
+ * 获取流程文字跟踪信息
+ */
+public List<ProcTrackDTO> getFlowSteps(String procInstId) {
+    ResultBody<List<ProcTrackDTO>> resultBody = bpmEngine.getPage(procInstId, null, null);
+    if (resultBody != null && resultBody.isSuccess()) {
+        return resultBody.getData();
+    }
+    return Collections.emptyList();
+}
+
+/**
+ * 获取流程图形跟踪信息
+ */
+public Map getFlowGraph(String procInstId) {
+    ResultBody<Map> resultBody = bpmEngine.getGraphTrack(procInstId, null, null);
+    if (resultBody != null && resultBody.isSuccess()) {
+        return resultBody.getData();
+    }
+    return Collections.emptyMap();
+}
+```
+
+---

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/20206_/351/231/204/345/275/225.md

@@ -0,0 +1,43 @@
+---
+name: 攻略-08-流程前端组件-章节06_附录
+description: 附录 — 美林平台 BPM 前端组件与方法说明（BpmFormTools / BpmGridButtonsNew / MeritBPM）
+keywords: [BPM, 前端组件, BpmFormTools, BpmGridButtonsNew, MeritBPM, Vue, Element UI, 附录]
+use-cases: [BPM 前端组件集成, 流程表单开发, BPM 按钮组件]
+source-section: 5. 附录
+source-file: 应用开发平台-流程管理-使用攻略（八）：流程前端组件及方法说明文档.md
+---
+
+# 五、附录
+
+### 5.1 BPM组件与API对应关系
+
+| 前端组件 | MeritBPM方法 | 后端API | 说明 |
+|----------|-------------|---------|------|
+| BpmFormTools | create/initRuleEngine | POST /api/engine/bpm/ruleengine/init/{procDefKey} | 创建流程/初始化规则引擎 |
+| BpmFormTools | runRuleEngine | POST /api/engine/bpm/ruleengine/run | 运行规则引擎 |
+| BpmFormTools | startProcess | POST /api/engine/bpm/{procDefKey}/startprocess | 发起流程 |
+| BpmGridButtonsNew | validatePermit | POST /api/engine/bpm/{procDefKey}/validate/permit | 验证权限 |
+| - | openProcTrackWindow | POST /api/engine/track/port | 打开流程跟踪 |
+
+### 5.2 流程变量说明
+
+| 变量名 | 类型 | 说明 |
+|--------|------|------|
+| bpmSubject | String | 流程标题（必填） |
+| bpmUrgent | String | 紧急程度 |
+| bpmSecret | String | 密级 |
+| bpmDrafterId | String | 拟稿人ID |
+| businessId | String | 业务数据ID |
+| procInstId | String | 流程实例ID |
+| undoId | String | 待办ID |
+| procDefKey | String | 流程定义Key |
+
+### 5.3 流程状态值说明
+
+| 状态值 | 说明 | 使用场景 |
+|--------|------|---------|
+| draft | 草稿 | 流程未提交 |
+| running | 进行中 | 流程正在审批 |
+| approved | 已通过 | 流程审批通过 |
+| rejected | 已驳回 | 流程被驳回 |
+| cancelled | 已取消 | 流程已取消 |