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

package/skills/meritdata-platform-bpm/references/module-design-ref//346/224/273/347/225/245-07-/346/265/201/347/250/213/346/250/241/345/235/227/350/256/276/350/256/241-/347/253/240/350/212/20205_/346/265/201/347/250/213/345/220/216/347/253/257/350/256/276/350/256/241.md

@@ -0,0 +1,226 @@
+---
+name: 攻略-07-流程模块设计-章节05_流程后端设计
+description: 流程后端设计 — 美林平台 BPM 模块设计说明（前端/后端架构 + 二次开发 + 样例流程）
+keywords: [BPM, 模块设计, 流程设计器, 流程后端, 二次开发, 样例流程, 流程后端设计]
+use-cases: [BPM 模块架构理解, 前端/后端设计, 流程模块二开]
+source-section: 5. 流程后端设计
+source-file: 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md
+---
+
+# 5.流程后端设计
+
+[IMG: image-20210618142846530]
+
+### 5.1 核心Java类
+
+RuleEngine ： 是实体类 ，包含了我们自己封装后的所有属性。
+
+包含 ：流程key, 操作按钮，当前任务节点信息，节点候选人等。
+
+BpmEngine：API接口类，我们通过feign对外提供的自定后的流程相关的API接口。提供了启动流程，规则引擎初始化 ，运行规则引擎，完成任务等接口。
+
+核心接口：运行规则引擎      返回结果  RuleEngine
+
+BpmEngineManager：实现业务逻辑的核心类。启动流程，完成任务的具体业务逻辑。
+
+RuleEngineManager：规则引擎类，主要是实现将XML文件中的信息转换为RuleEngine对象。
+
+DealerComputerService：计算人员类，将XML中的配置人员信息转换为前端显示人员。
+
+MainFormController：MainForm数据的接口。
+
+LineListener： 线监听类  完成节点处理人设置。
+
+UserTaskListener：用户任务监听类  主要完成我们Undo数据的产生和更新。
+
+
+
+### 5.2 流程流转调用接口顺序
+
+新发起流程时: 规则引擎初始化 ，启动流程
+
+起草人完成节点时：完成当前任务
+
+下一个节点人员打开时：运作规则引擎，获取当前节点数据
+
+完成任务时：完成任务接口
+
+每次打开表单时都会调用运行规则引擎接口，获取RuleEngine对象，操作按钮显示，节点候选人都来自运行规则引擎返回的RuleEngine 的信息。
+
+### 5.3 具体的接口逻辑
+
+串行审批模式
+
+首先用户任务的当前节点处理人为camunda:assignee 中配置的值 可以配置用户也可以配置变量，我们这边选择配置变量，根据业务给变量赋不同的候选人。
+
+[IMG: image-20210701143730814]
+
+我们从发起流程开始：
+
+首先调用的就是发起流程接口：/{procDefKey}/startprocess 
+
+[IMG: image-20210701144130755]
+
+重要的就是以上框中代码：1. 设置起草人变量   2. 启动一个流程   3.variable 就是全局变量
+
+当启动一个流程之后流程就要完成第一个线流转就会触发配置的线监听类LineListener，就会执行重写的execute方法
+
+这里完成的就是获取到当前的流转节点即第一个用户任务节点，但此时还没有设置处理人，要完成给Activity_04eqjz8_onlyApprove变量设置。
+
+[IMG: image-20210701144907130]
+
+下面就是完成设置变量值的过程,及给起草人节点设置了候选人值，当前节点就变为运行时节点，处理人为起草人。
+
+[IMG: image-20210701145156418]
+
+当起草人点击发送按钮，选择下一个节点处理人后，要流转到下一个节点，首先会调用完成任务接口/task/{taskId}/complete 
+
+[IMG: image-20210701151737220]
+
+完成起草人接口后又会触发线监听
+
+[IMG: image-20210701152358078]
+
+后面就进行同样的步骤，若流程后面没有节点则流程就结束了。
+
+对于退回上一节点，退回拟稿人操作就相当于把流程的运行节点改为对应的节点，和对应的处理人。
+
+以退回上一节点操作为例：首先调用退回上一节点接口：/process/retprenode/{businessId}
+
+[IMG: image-20210701153712921]
+
+[IMG: image-20210701153853698]
+
+退回上一节点，退回拟稿人，特送都会调用到此方法，具体的跳转到那个节点是由下面框中原生接口完成。
+
+[IMG: image-20210701154142970]
+
+
+
+UserTaskListener 的业务介绍：
+
+首先我们可以看到有事件的定义，以及主要操作的是undo数据。
+
+[IMG: image-20210701154914197]
+
+对于create事件的意思就是新进入用户任务之前，我们主要来给这个节点的处理人创建待办数据。
+
+[IMG: image-20210701155153027]
+
+[IMG: image-20210701155519880]
+
+我们在产生待办的同时也给接收人发送了系统消息：
+
+[IMG: image-20210701155656904]
+
+对于complete，和delete事件 主要用来更新待办数据
+
+[IMG: image-20210701160153014]
+
+### 5.4 几种审批模式的介绍
+
+单人审批： 一个人审批即可    XML中为 camunda:assignee 属性
+
+多人审批：
+
+​     任意一人  并行审批 多个候选人其中一个审批即可完成当前节点  XML中为 camunda:candidateUsers   意思为候选人
+
+​	 多人审批  并行多个人审批  所有候选人审批完 流入下一个节点   XML中为 camunda:assignee   审批类型为  <camunda:approve type="parApproveList" />
+
+[IMG: image-20210701170958030]
+
+​    串行审批   多个人按选择的顺序审批 所有候选人依次审批完流入下一个节点  XML中为 camunda:assignee="${seqApprove}" 审批类型为  <camunda:approve type="seqApproveList" />
+
+[IMG: image-20210701170713127]
+
+代码中的设置位置：
+
+[IMG: image-20210701171224339]
+
+### 5.5 bpm模块相关表介绍
+
+ACT开头：这些都是camunda引擎创建的表。
+
+下面对表做一个简单介绍：
+
+ACT_RE_*: 表示repository，这个前缀表包含了流程定义和流程静态资源 。
+
+ACT_RU_*: 表示runtime，这个前缀表示流程运行时的表，包含流程实例，任务，变量等数据。 只在流程实例运行的时候保存这些数据，在流程结束后就会删除这些记录。
+
+ACT_ID_*:表示identity ，这些表包含身份信息，比如用户等。
+
+ACT_HI_*: 表示history 这些表包含历史数据，比如历史流程，变量，任务等待。
+
+ACT_GE_*: 通用数据 用于存放资源。
+
+几个常用到比较重要的表：
+
+1：资源库流程规则表
+
+​    act_re_deployment 部署信息表
+
+​    act_re_model  流程设计模型部署表
+
+​	act_re_procdef  流程定义数据表
+
+2：运行时数据库表
+
+​    act_ru_execution 运行 时流程执行实例表
+
+​	act_ru_identitylink 运行时流程人员表，主要存储任务节点与参与者相关信息
+
+​    act_ru_task 运行时任务节点表
+
+​	act_ru_variable 运行时流程变量表
+
+3：历史数据表
+
+​	act_hi_actinst 历史节点表
+
+​	act_hi_procinst 历史流程实例表
+
+​	act_hi_taskinst 历史任务实例表
+
+​	act_hi_varinst 历史变量实例表
+
+4：通用数据表
+
+​		act_ge_bytearray 二进制数据表
+
+​		act_ge_property 属性数据表
+
+
+
+pf_bpm开头：我们自己维护的相关表
+
+pf_bpm_mainform ：流程实例表  主要记录了流程流转过程中的信息。流程启动时产生数据。
+
+pf_bpm_undo：待办表  流程流转到下一个节点时插入的下一个节点人处理信息。
+
+pf_bpm_proctrack： 流程处理过程中，流程的追踪信息。
+
+pf_bpm_procopinion：流程处理过程中填写的意见表。
+
+pf_bpm_procservice_item: 监听表达式维护表
+
+pf_bpm_procdefbyte：流程的维护类
+
+
+
+意见管理：
+
+个人意见和公共意见：为维护的意见模板。在流程流转过程中填写意见可以快速选取。
+
+流程意见：为流程流转过程中填写的意见。
+
+代码位置：ProcOpinionController.java
+
+流程追踪: 
+
+为方便用户直观地了解流程当前的处理节点设计的可视化展示。
+
+代码位置：TrackController.java
+
+待办管理：
+
+待办数据是在每完成一个任务节点会触发监听器方法，方法中会给Undo表中插入数据。

package/skills/meritdata-platform-bpm/references/module-design-ref//346/224/273/347/225/245-07-/346/265/201/347/250/213/346/250/241/345/235/227/350/256/276/350/256/241-/347/253/240/350/212/20206_/346/265/201/347/250/213/345/211/215/347/253/257/350/256/276/350/256/241.md

@@ -0,0 +1,80 @@
+---
+name: 攻略-07-流程模块设计-章节06_流程前端设计
+description: 流程前端设计 — 美林平台 BPM 模块设计说明（前端/后端架构 + 二次开发 + 样例流程）
+keywords: [BPM, 模块设计, 流程设计器, 流程后端, 二次开发, 样例流程, 流程前端设计]
+use-cases: [BPM 模块架构理解, 前端/后端设计, 流程模块二开]
+source-section: 6. 流程前端设计
+source-file: 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md
+---
+
+# 6.流程前端设计
+
+[IMG: image-20210618160441316]
+
+demo 工程主要提供业务表单页面及引入操作按钮组件，组成流程操作页面
+
+bpm-form-tools   主要为按钮组件
+
+bpm-grid-buttons 为查询pf_bpm_mainform表数据提供的按钮
+
+### 6.1 核心文件
+
+bpm-grid-buttons.vue 负责查询分类按钮，新增，删除按钮的控制
+
+bpm-form-tools.vue 按钮组件负责按钮的显示及弹框的引入
+
+merit-bpm.js  前端封装的方法类复制调用接口
+
+### 6.2 调用逻辑梳理
+
+打开流程处理表单页面的处理过程,以待办列表中点开为例，其他与之类似：
+
+第一步：点击操作按钮时触发点击操作事件
+
+[IMG: image-20210622105134150]
+
+第二步触发MeritBPM.open()方法：
+
+[IMG: image-20210622105330904]
+
+第三步触发window.open()方法打开页面：
+
+由于页面引入了操作按钮组件，则会先执行组件中的方法
+
+[IMG: image-20210622105710650]
+
+[IMG: image-20210622105541605]
+
+第四步若businessId不存在则直接回调，若有通过businessId查询表单数据，再进行回调
+
+[IMG: image-20210622160813583]
+
+第五步调用运行规则引擎方法,获取操作按钮
+
+[IMG: image-20210622160927022]
+
+第六步完成表单页面渲染
+
+[IMG: image-20210510100059452]
+
+
+
+merit.js 中定义了流程操作中的按钮点击事件，方法最终还是调用后台接口。
+
+### 6.3 cloud-module-bpm中文件修改，调试方式
+
+由于cloud-module-bpm是基础依赖文件，若在代码中验证需要每次推到仓库，这样增加了风险也增加了操作量，所以提供了一个examples的页面来调试代码。
+
+[IMG: image-20210628172109839]
+
+页面中提供了流程打开后调用的组件，使用时放开注释就好。
+
+[IMG: image-20210628172236546]
+
+调试时需要修改这些参数为你实际上页面的参数
+
+[IMG: image-20210628172425303]
+
+效果如下：
+
+[IMG: img]

package/skills/meritdata-platform-bpm/references/module-design-ref//346/224/273/347/225/245-07-/346/265/201/347/250/213/346/250/241/345/235/227/350/256/276/350/256/241-/347/253/240/350/212/20207_/344/272/214/346/254/241/345/274/200/345/217/221.md

@@ -0,0 +1,38 @@
+---
+name: 攻略-07-流程模块设计-章节07_二次开发
+description: 二次开发 — 美林平台 BPM 模块设计说明（前端/后端架构 + 二次开发 + 样例流程）
+keywords: [BPM, 模块设计, 流程设计器, 流程后端, 二次开发, 样例流程, 二次开发]
+use-cases: [BPM 模块架构理解, 前端/后端设计, 流程模块二开]
+source-section: 7. 二次开发
+source-file: 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md
+---
+
+# 7.二次开发
+
+基于应用开发平台提供的这套东西有比较多的限制，因为所有接口封装都依赖于Rule Engine对象中定义的一套内容。
+
+但遵守上面的一些限制，则可以更快地开发业务。
+
+基于应用开发平台提供的流程引擎开发方式：
+
+  1.方式一 ：引入前端按钮组件
+
+​     优势：可以不用自己调用后端流程的API接口  
+
+​	 缺点：按钮无法更改
+
+​	 采用项目组:tempo, 数据资产，7103
+
+ 2.方式二：自己开发前端样式按钮等
+
+​    优势：前端按钮样式可自定义
+
+​    缺点：需自己整理业务逻辑调用后端的API接口
+
+​    采用项目组：希子图鉴
+
+以上两种都有提供相关参考文档。
+
+《二次开发--流程API接口》
+
+《二次开发--工作流流程应用开发》

package/skills/meritdata-platform-bpm/references/module-design-ref//346/224/273/347/225/245-07-/346/265/201/347/250/213/346/250/241/345/235/227/350/256/276/350/256/241-/347/253/240/350/212/20208_/344/270/252/344/272/272/346/240/267/344/276/213/346/265/201/347/250/213/347/232/204/351/205/215/347/275/256.md

@@ -0,0 +1,92 @@
+---
+name: 攻略-07-流程模块设计-章节08_个人样例流程的配置
+description: 个人样例流程的配置 — 美林平台 BPM 模块设计说明（前端/后端架构 + 二次开发 + 样例流程）
+keywords: [BPM, 模块设计, 流程设计器, 流程后端, 二次开发, 样例流程, 个人样例流程的配置]
+use-cases: [BPM 模块架构理解, 前端/后端设计, 流程模块二开]
+source-section: 8. 个人样例流程的配置
+source-file: 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md
+---
+
+# 8.个人样例流程的配置
+
+###    8.1 配置个人样例菜单和授权
+
+​	系统管理员账号登录系统，进入资源管理，资源维护 在流程管理下配置新增资源
+
+[IMG: image-20210624114259006]
+
+配置文本：配置流程(个人样例)菜单：
+【路由地址】
+/bpm-demo/example/index
+
+【实际菜单地址】
+/bpm-demo/example/index.html
+
+【所属应用名】
+cloud-system-bpm
+
+授权完成后，登录有权限的用户就可以看到菜单
+
+[IMG: image-20210624133004431]
+
+### 8.2 用户侧新建样例流程
+
+流程设计下新建分类，分类下新建个人样例流程
+
+[IMG: image-20210624133252180]
+
+
+
+### 8.3 设计流程
+
+[IMG: image-20210624133805053]
+
+按表单上的内容配置信息，表单链接地址第一个节点配置为：/bpm-demo/example/index.html#/formEdit?id=businessId
+
+后面节点配置为：/bpm-demo/example/index.html#/formRead?id=businessId
+
+[IMG: image-20210624134127168]
+
+
+
+[IMG: image-20210624134848377]
+
+### 8.4 设计完成后发布流程
+
+[IMG: image-20210624134943278]
+
+### 8.5 发起流程
+
+方式一
+
+[IMG: image-20210624151602461]
+
+方式二
+
+[IMG: image-20210624151647831]
+
+### 8.6 处理流程
+
+操作入口
+
+入口一
+
+[IMG: image-20210624151810068]
+
+入口二
+
+[IMG: image-20210624151910806]
+
+入口三
+
+[IMG: s]
+
+入口四--消息中
+
+[IMG: image-20210624152111891]
+
+
+
+操作页面：
+
+[IMG: image-20220614101414615]