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

package/skills/meritdata-platform-bpm/references/listener-expression.md

@@ -0,0 +1,304 @@
+## 适配与安全
+
+历史截图已移除。此文档中的 JDK、Spring Boot、扩展目录和 MANIFEST 写法仅适用于对应历史版本；先核对目标 BPM 部署包、JDK 与扩展机制。监听器调用业务服务时使用受认证的服务到服务身份，并对输入变量和副作用操作做授权、幂等与错误处理。
+
+流程设计器可配置监听表达式，在流程事件时调用实现类。业务规则因项目而异，监听扩展 JAR 应部署到目标 BPM 服务指定的扩展位置。
+## 1.1 需要开发一个 jar 包和一个包含业务接口的微服务（若有微服务可以不用创建）
+jar 包中包含两部分：
+ 1.定义监听的实现类用于触发事件。
+ 2.定义一个应用开发平台调用类，用于调用自己开发的应用开发平台业务方法。
+应用开发平台包中定义了业务具体实现的接口。
+## 1.2 部署扩展 JAR
+
+历史版本在 6.10 前后使用不同目录和 MANIFEST 配置。不要复制旧的绝对路径或 WAR 修改步骤；由目标 BPM 版本的部署说明确定扩展目录、类加载配置和启启方式，并在非生产环境验证 Bean 已注入后再发布。
+## 1.3 这种方式可以扩展监听器的配置的监听表达式,开发人员自定义业务的灵活性更高。
+## 2.1 创建一个 maven 项目
+### 2.1.1 目录结构
+1.在 IntelliJ IDEA 窗口中点击左上角 选择 "File->New-> Project"，创建一个新的工程
+2.在 "New Project" 页面选择 Maven，并使用目标项目 BOM 和部署包要求的 JDK 版本；不要从历史运行目录复制 JDK。
+3.配置参数
+| 名称       | 参数值                | 说明                   |
+| ---------- | --------------------- | ---------------------- |
+| GroupId    | com.meritdata.cloud   | 可以自定义             |
+| artifactId | `<listener-artifact>` | 项目名称，按目标项目命名规范确定 |
+4.点击 java 文件夹-》右击鼠标-》选择 Mark Directory as -》Resources Root 设置 Java 文件为 root 文件
+逐级新建文件结构如下
+### 2.1.2 修改 pom 文件
+需要引入流程的相关依赖包及 Spring Boot，springCloud 相关依赖
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
+    <modelVersion>4.0.0</modelVersion>
+    // springboot项目
+    <parent>
+        <groupId>org.springframework.boot</groupId>
+        <artifactId>spring-boot-starter-parent</artifactId>
+        <version>2.1.8.RELEASE</version> <!-- lookup parent from repository -->
+    </parent>
+    <groupId>com.meritdata.cloud</groupId>
+    <artifactId>listener-extension</artifactId>
+    <version>1.0-SNAPSHOT</version>
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+        //6.13.2以下版本用1.8版本的jdk即可
+        <java.version>1.8</java.version>
+        //6.13.2版本需要21版本的jdk
+        <java.version>21</java.version>
+        <spring-cloud.version>Greenwich.SR3</spring-cloud.version>
+        <meritdata-platform-cloud.version>${meritdata-platform-cloud.version}</meritdata-platform-cloud.version>
+    </properties>
+    <dependencies>
+    // 应用开发平台的依赖
+        <dependency>
+            <groupId>com.meritdata.cloud</groupId>
+            <artifactId>cloud-starter-core</artifactId>
+            <version>${meritdata-platform-cloud.version}</version>
+        </dependency>
+        // camunda依赖
+        <dependency>
+            <groupId>org.camunda.bpm.springboot</groupId>
+            <artifactId>camunda-bpm-spring-boot-starter-rest</artifactId>
+            <version>3.4.0</version>
+        </dependency>
+    </dependencies>
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>org.springframework.cloud</groupId>
+                <artifactId>spring-cloud-dependencies</artifactId>
+                <version>${spring-cloud.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+    <build>
+        <!--使配置文件可以直接读取pom中的系统参数 -->
+        <resources>
+            <resource>
+                <directory>src/main/resources</directory>
+                <filtering>true</filtering>
+            </resource>
+        </resources>
+        <plugins>
+            <plugin>
+                <groupId>com.google.code.maven-replacer-plugin</groupId>
+                <artifactId>replacer</artifactId>
+                <version>1.5.3</version>
+                <executions>
+                    <execution>
+                        <phase>prepare-package</phase>
+                        <goals>
+                            <goal>replace</goal>
+                        </goals>
+                    </execution>
+                </executions>
+            </plugin>
+        </plugins>
+    </build>
+</project>
+```
+### 2.1.3 类定义示例及说明
+UserCustomTaskListener.java ---
+目的用于监听用户事件(UserTask) ，需要 implements TaskListener
+```java
+package com.meritdata.cloud.listener;
+
+import com.meritdata.cloud.feign.IUserTaskListener;
+import org.camunda.bpm.engine.delegate.DelegateTask;
+import org.camunda.bpm.engine.delegate.TaskListener;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.stereotype.Service;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.logging.Logger;
+
+/**
+ * 监听用户任务事件
+ *
+ */
+@Service("userCustomTaskListener")
+public class UserCustomTaskListener implements TaskListener {
+
+    @Autowired
+    IUserTaskListener iUserTaskListener;
+
+    private final static Logger LOGGER = Logger.getLogger(UserCustomTaskListener.class.getName());
+
+    @Override
+    public void notify(DelegateTask delegateTask) {
+        LOGGER.info("开始监听服务");
+        LOGGER.info("活动ID: " + delegateTask.getExecution().getCurrentActivityId() +
+                ", 事件类型：" + delegateTask.getEventName());
+        Map<String,Object> params = new HashMap<>();
+        params.put("eventName" , delegateTask.getEventName());
+        params.put("variables", delegateTask.getVariables());
+        params.put("currentActivityId", delegateTask.getExecution().getCurrentActivityId());
+        params.put("assignee", delegateTask.getAssignee());
+        params.put("processDefinitionId", delegateTask.getProcessDefinitionId());
+        String result= iUserTaskListener.listenerService(params);
+        Map<String, Object> variables = delegateTask.getVariables();
+        LOGGER.info("完成监听服务");
+    }
+}
+```
+// 获取一些参数的方法
+```
+// 获取businessId
+String businessId = (String) delegateTask.getVariable("businessId");
+// 获取节点处理人
+  String assignee = delegateTask.getAssignee();
+// 获取某个变量值
+String xx = (String) delegateTask.getVariable("xx")
+// 获取流程实例
+ String processInstanceId = delegateTask.getProcessInstanceId();
+```
+IUserTaskListener.java ---用于定义调用应用开发平台接口
+```java
+package com.meritdata.cloud.feign;
+
+import com.meritdata.cloud.config.CloudFeignConfiguration;
+import io.swagger.annotations.ApiOperation;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.stereotype.Service;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
+
+import java.util.Map;
+
+@RestController
+@FeignClient(value = "${meritdata.cloud.custom-listener-name}",contextId = "lisetenerUserCustomServiceClient",configuration = CloudFeignConfiguration.class)
+@Service("iUserTaskListener")
+public interface IUserTaskListener {
+        @ApiOperation(value = "调用三方自定义监听服务")
+        @RequestMapping(value = "${meritdata.cloud.listener-controller-name}/${meritdata.cloud.listener-method-name}",method = RequestMethod.POST)
+        public String  listenerService(@RequestParam Map<String, Object> params);
+
+}
+```
+### 2.1.4 打成 jar 包
+以 idea 工具为例
+依次点击打出 jar 包--并在 target 文件夹下找到 jar 包
+### 2.1.5 部署扩展 JAR
+
+将 JAR 部署到目标 BPM 版本指定的扩展目录，并按该版本的类加载配置完成注册。由平台运维或发布流程处理目录权限、包更新和服务重启；不要修改历史 WAR 文件或复制历史绝对路径。
+
+### 2.1.6 重启目标 BPM 服务
+## 3.1 搭建工程
+根据《应用开发平台使用攻略(一)：系统环境搭建》 的后端工程创建，进行后端工程搭建。
+具体示例代码
+- 选中 com.meritdata.cloud ——>鼠标右键——> 点击 New ——> 选择 Package
+- 添加 `controller`、`entity`、`repository`、`service` 包。
+- 添加以下 Java 文件：
+  - 服务层
+    - 服务层接口
+      - IBpmUserCustomService.java
+    - 服务层接口实现
+      - BpmUserCustomServiceImpl.java
+  - 控制层
+    UserCustomController.java
+    持久层 ：示例项目无，二次开发根据自己业务需求编写
+    ### 控制层
+    | 类名                 | 类型  |
+    | -------------------- | ----- |
+    | UserCustomController | class |
+    ```java
+    
+    package com.meritdata.cloud.controller;
+    
+    import com.alibaba.fastjson.JSONObject;
+    import com.meritdata.cloud.bpm.base.service.IBpmUserCustomService;
+    import io.swagger.annotations.ApiOperation;
+    import org.springframework.beans.factory.annotation.Autowired;
+    import org.springframework.web.bind.annotation.RequestMapping;
+    import org.springframework.web.bind.annotation.RequestMethod;
+    import org.springframework.web.bind.annotation.RequestParam;
+    import org.springframework.web.bind.annotation.RestController;
+    
+    import java.util.HashMap;
+    import java.util.Map;
+    
+    @RestController
+    @RequestMapping(value = "/api/bpmlistener/demo")
+    public class UserCustomController {
+        @Autowired
+        private IBpmUserCustomService procUserCustomService;
+    
+        @ApiOperation(value = "扩展监听器事件接口")
+        @RequestMapping(value = "/doListenerEvent", method = RequestMethod.POST)
+        public String doListenerEvent(@RequestParam  Map<String,Object> params){
+            /**
+             * currentActivityId 活动ID
+             * eventName 事件名称 create(开始),complete(结束)
+             * variables 变量
+             */
+            procUserCustomService.sendEmil();
+            Map<String, Object> map = new HashMap<>();
+            map.put("variables", variables);
+            String result = JSONObject.toJSONString(map);
+            return result;
+        }
+    }
+    ```
+    | 类名                  | 类型      | 父类 |
+    | :-------------------- | --------- | ---- |
+    | IBpmUserCustomService | interface |      |
+```java
+package com.meritdata.cloud.service;
+
+public interface IBpmUserCustomService {
+	// 具体业务实现，自定义
+    void sendEmil();
+}
+```
+服务层接口实现
+| 类名                     | 类型  | 父类                          |
+| ------------------------ | ----- | ----------------------------- |
+| BpmUserCustomServiceImpl | class | 实现 IBpmUserCustomService 类 |
+```java
+package com.meritdata.cloud.service.impl;
+
+import com.meritdata.cloud.bpm.base.service.IBpmUserCustomService;
+import org.springframework.stereotype.Service;
+
+@Service("procUserCustomService")
+public class BpmUserCustomServiceImpl implements IBpmUserCustomService {
+
+    @Override
+    public void sendEmil() {
+        System.out.println("发送了邮件");
+    }
+
+}
+```
+## 3.2 服务启动
+启动完毕后可在 nacos 中的服务列表页面查看，该应用已注册至 nacos
+## 3.3 设置参数
+meritdata.cloud.custom-listener-name=应用开发平台名称
+meritdata.cloud.listener-controller-name=controller 地址
+示例：
+meritdata.cloud.listener-method-name = 接口地址
+若存在多个应用开发平台则 nacos 中配置多个参数即可，每个 feign 接口与之对应即可。
+## 4.1 维护监听类
+登录账户-进入流程服务菜单添加已经配置好的监听类
+## 4.2 流程节点配置监听参数
+点击流程编辑按钮-进入编辑状态-双击用户任务--选择监听参数配置框
+### 4.2.1 添加表达式
+在表达式菜单中添加 userCustomTaskListener 表达式内容
+表达式 userCustomTaskListener 来自于之前在自定义 jar 中的 bean 名称
+事件类型目前支持开始和结束， 开始对应 ---create 结束对应--- complete
+### 4.2.2 添加完监听事件后-发布流程
+## 5.1 创建测试流程测试
+## 5.2 查看自定义业务是否生效
+由图可看到触发了自定义事件
+## 1.表达式需要扩展，则仿照上面过程继续添加。
+示例：
+## 2.本例是以 UserTask 流程节点为例创建监听任务类，若添加线监听实现类过程与之类似，实现类需要改成 implements JavaDelegate 接口启写 execute 方法。
+服务任务节点配置的监听类也是要 implements JavaDelegate 接口启写 execute 方法。
+## 3.在监听类维护时，为线创建的监听类维护时监听类型选择线任务监听，为流程服务和用户服务创建的选择用户任务监听（否则选择不到）。
+## 4.给服务任务节点选择表达式时一定不能选错，不能选择给 UserTask 节点配置的表达式否则流程流转时会报错。意思就是给服务节点上配置的监听类是必须 implements JavaDelegate 接口。

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-00_/346/200/273/350/247/210.md

@@ -0,0 +1,25 @@
+---
+name: 攻略-07-流程模块设计-00_总览
+description: 美林平台 BPM 模块设计说明（前端/后端架构 + 二次开发 + 样例流程）
+keywords: [BPM, 模块设计, 流程设计器, 流程后端, 二次开发, 样例流程]
+use-cases: [BPM 模块架构理解, 前端/后端设计, 流程模块二开]
+related: [cloud-system-bpm-module-core / cloud-module-bpm]
+source: 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md
+---
+
+# 应用开发平台流程管理使用攻略（七）：流程模块设计说明文档 — 总览
+
+**摘要**：美林平台 BPM 模块设计说明（前端/后端架构 + 二次开发 + 样例流程）
+
+**关联**：cloud-system-bpm-module-core / cloud-module-bpm
+
+## 章节索引
+
+01. [背景](攻略-07-流程模块设计-章节01_背景.md) (原 1)
+02. [工作流相关介绍](攻略-07-流程模块设计-章节02_工作流相关介绍.md) (原 2)
+03. [应用开发平台流程包含模块](攻略-07-流程模块设计-章节03_应用开发平台流程包含模块.md) (原 3)
+04. [流程功能模块介绍](攻略-07-流程模块设计-章节04_流程功能模块介绍.md) (原 4)
+05. [流程后端设计](攻略-07-流程模块设计-章节05_流程后端设计.md) (原 5)
+06. [流程前端设计](攻略-07-流程模块设计-章节06_流程前端设计.md) (原 6)
+07. [二次开发](攻略-07-流程模块设计-章节07_二次开发.md) (原 7)
+08. [个人样例流程的配置](攻略-07-流程模块设计-章节08_个人样例流程的配置.md) (原 8)

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/20201_/350/203/214/346/231/257.md

@@ -0,0 +1,12 @@
+---
+name: 攻略-07-流程模块设计-章节01_背景
+description: 背景 — 美林平台 BPM 模块设计说明（前端/后端架构 + 二次开发 + 样例流程）
+keywords: [BPM, 模块设计, 流程设计器, 流程后端, 二次开发, 样例流程, 背景]
+use-cases: [BPM 模块架构理解, 前端/后端设计, 流程模块二开]
+source-section: 1. 背景
+source-file: 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md
+---
+
+# 1.背景
+
+流程模块业务为应用开发平台核心模块，业务性强 ，为了便于同事快速了解此块业务，编写文档帮助同事理解设计思路和业务逻辑。

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/20202_/345/267/245/344/275/234/346/265/201/347/233/270/345/205/263/344/273/213/347/273/215.md

@@ -0,0 +1,28 @@
+---
+name: 攻略-07-流程模块设计-章节02_工作流相关介绍
+description: 工作流相关介绍 — 美林平台 BPM 模块设计说明（前端/后端架构 + 二次开发 + 样例流程）
+keywords: [BPM, 模块设计, 流程设计器, 流程后端, 二次开发, 样例流程, 工作流相关介绍]
+use-cases: [BPM 模块架构理解, 前端/后端设计, 流程模块二开]
+source-section: 2. 工作流相关介绍
+source-file: 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md
+---
+
+# 2.工作流相关介绍
+
+​	工作流原理：简单来说就是通过数据库维护一定数量的表来记录工作流转的信息。
+
+​	工作流框架：Activity  Camunda等。 我们使用Camunda
+
+​	工作流引擎：负责生成流程运行时的各种实例及数据、监控和管理流程的运行。
+
+​	工作流生命周期：定义-发布-执行-完成。
+
+​	工作流规范： BPMN2.0。
+
+​	相关概念：流程定义对象，流程实例对象，任务。
+
+​	涉及组件： 流程设计器  一般是一个绘图工具，通过提供的组件设计出需要的流程，可以转化为XML文件。 
+
+​					    流程引擎  解析XML文件，将流程启动和运行，维护整个过程的数据。
+
+​

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/20203_/345/272/224/347/224/250/345/274/200/345/217/221/345/271/263/345/217/260/346/265/201/347/250/213/345/214/205/345/220/253/346/250/241/345/235/227.md

@@ -0,0 +1,18 @@
+---
+name: 攻略-07-流程模块设计-章节03_应用开发平台流程包含模块
+description: 应用开发平台流程包含模块 — 美林平台 BPM 模块设计说明（前端/后端架构 + 二次开发 + 样例流程）
+keywords: [BPM, 模块设计, 流程设计器, 流程后端, 二次开发, 样例流程, 应用开发平台流程包含模块]
+use-cases: [BPM 模块架构理解, 前端/后端设计, 流程模块二开]
+source-section: 3. 应用开发平台流程包含模块
+source-file: 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md
+---
+
+# 3.应用开发平台流程包含模块
+
+ 1.流程设计器模块
+
+ 2.流程业务维护模块
+
+ 3.流程基础组件模块
+
+ 4.流程样例模块

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/20204_/346/265/201/347/250/213/345/212/237/350/203/275/346/250/241/345/235/227/344/273/213/347/273/215.md

@@ -0,0 +1,284 @@
+---
+name: 攻略-07-流程模块设计-章节04_流程功能模块介绍
+description: 流程功能模块介绍 — 美林平台 BPM 模块设计说明（前端/后端架构 + 二次开发 + 样例流程）
+keywords: [BPM, 模块设计, 流程设计器, 流程后端, 二次开发, 样例流程, 流程功能模块介绍]
+use-cases: [BPM 模块架构理解, 前端/后端设计, 流程模块二开]
+source-section: 4. 流程功能模块介绍
+source-file: 应用开发平台-流程管理-使用攻略（七）：流程模块设计说明文档.md
+---
+
+# 4.流程功能模块介绍
+
+###  4.1 流程设计器模块
+
+主要功能是来设计流程图
+
+[IMG: image-20210616101916639]
+
+代码主要为前端代码，代码位置：front-end\cloud-system-bpm\src\pages\designer下    基于bpmn-js工具
+
+流程三大核心流对象：Activities 活动   Gateway 网关   Event 事件
+
+流程设计器相关概念：任务 ，网关 ，事件
+
+左侧为流程设计组件--也是基于规范提供的组件。
+
+事件：开始节点 结束节点
+
+任务：用户任务(UserTask) 、子流程(CallActivtiy) 、服务任务(ServiceTask)、后续可继续扩展
+
+用户任务：需要人员参与的节点。
+
+子流程：可以配置另一个流程。有具体子流程的参考文档。
+
+服务任务：自动执行，可以配置监听类完成业务逻辑。
+
+网关：分支网关 合并网关 包含网关   控制流程的流转。
+
+分支网关：按条件分支流转，只能有一个分支流转。
+
+合并网关：多个分支合并为一个分支。
+
+包含网关：与分支网关类似但可以多个分支流转。
+
+监听类：流程引擎支持配置监听类来实现触发事件执行实现类中的方法。
+
+监听表达式为：delegateExpression   类型    ${lineListener}     括号中的为监听类
+
+监听类需要实现camunda中的接口才可以触发 ，我们分别给线和用户任务内置了两个监听类，完成一些操作。
+
+例如上面的lineListener，就需要定义类实现JavaDelegate接口重写execute方法
+
+[IMG: image-20210624144759982]
+
+用户任务上配置的监听类定义就需要实现TaskListener 重写notify方法
+
+[IMG: image-20210624145028810]
+
+以上组件都基于原生的流程设计组件
+
+我们通过给组件添加了配置表单来配置我们的业务数据
+
+[IMG: image-20210617171554189]
+
+配置完成后需要将流程设计转换为xxx.bpmn20.xml格式的流程通用文件，其中为了存储我们自己表单中配置的信息，我们扩展了一些xml标签.
+
+截取一部分供了解xxx.bpmn20.xml结构
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<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">
+  <bpmn:process id="Process_Demo1" name="出差单" isExecutable="true">
+    <bpmn:documentation>{"formLink":"/bpm/example/index.html#/form?id=businessId","appModuleName":"dd","appModuleId":"dd","appSystemName":"BPM系统","appSystemId":"BPM"}</bpmn:documentation>
+    <bpmn:startEvent id="Event_0esv7me" name="开始">
+      <bpmn:outgoing>Flow_1uhgeou</bpmn:outgoing>
+    </bpmn:startEvent>
+    <bpmn:userTask id="Activity_0hwkbjn" name="起草 " camunda:assignee="${Activity_0hwkbjn_onlyApprove}">
+      <bpmn:extensionElements>
+        <camunda:meritdata>
+          <camunda:editStatus type="1" />
+          <camunda:isretprenode type="" />
+          <camunda:isretfirnode type="" />
+          <camunda:regainStatus type="" />
+          <camunda:retRandomNodeStatus type="" />
+          <camunda:formLink name="起草 " sort="0">
+            <camunda:link>/bpm-demo/example/index.html#/formEdit?id=businessId</camunda:link>
+          </camunda:formLink>
+          <camunda:formVars />
+          <camunda:actors>
+            <camunda:actor type="1" ids="drafterCode" name="起草人" />
+          </camunda:actors>
+          <camunda:sendRead>
+            <camunda:issendread type="0" />
+          </camunda:sendRead>
+          <camunda:approve type="onlyApprove" />
+          <camunda:route type="1" operName="发送" returnName="" returnValue="" operImgPath="" />
+          <camunda:seluserwin display="yes@@@@@【本环节需要选人】" noseluser="no@@@@@【本环节不需要自动选人】" />
+          <camunda:opinion display="" type="1" must="" isOpiDisplay="" isOpiMust="" regionName="" regionSort="0" opinionField="" opinionYesNo="" opinionDeptStatus="" opinionUserImgStatus="" autoOpinion="" autoOpiContent="" routeName="" routeValue="" routeOpiMust="" routeCommentMust="" />
+        </camunda:meritdata>
+        <camunda:taskListener delegateExpression="${userTaskListener}" event="create" />
+        <camunda:taskListener delegateExpression="${userTaskListener}" event="complete" />      
+        <camunda:taskListener delegateExpression="${userTaskListener}" event="delete" />
+      </bpmn:extensionElements>
+      <bpmn:incoming>Flow_1uhgeou</bpmn:incoming>
+      <bpmn:outgoing>Flow_0902i1k</bpmn:outgoing>
+    </bpmn:userTask>
+    <bpmn:userTask id="Activity_1yq15ws" name="用户任务" camunda:assignee="${Activity_1yq15ws_onlyApprove}">
+      <bpmn:extensionElements>
+        <camunda:meritdata>
+          <camunda:editStatus type="1" />
+          <camunda:isretprenode type="" />
+          <camunda:isretfirnode type="" />
+          <camunda:regainStatus type="" />
+          <camunda:retRandomNodeStatus type="" />
+          <camunda:formLink name="用户任务" sort="0">
+            <camunda:link>/bpm-demo/example/index.html#/formRead?id=businessId</camunda:link>
+          </camunda:formLink>
+          <camunda:formVars />
+          <camunda:actors>
+            <camunda:actor type="2" ids="1fc3e895f1ea43268144af73e29fb005" names="zs" codes="zs" />
+          </camunda:actors>
+          <camunda:sendRead>
+            <camunda:issendread type="0" />
+          </camunda:sendRead>
+          <camunda:approve type="onlyApprove" />
+          <camunda:route type="1" operName="发送" returnName="" returnValue="" operImgPath="" />
+          <camunda:seluserwin display="yes@@@@@【本环节需要选人】" noseluser="no@@@@@【本环节不需要自动选人】" />
+          <camunda:opinion display="" type="1" must="" isOpiDisplay="" isOpiMust="" regionName="" regionSort="0" opinionField="" opinionYesNo="" opinionDeptStatus="" opinionUserImgStatus="" autoOpinion="" autoOpiContent="" routeName="" routeValue="" routeOpiMust="" routeCommentMust="" />
+        </camunda:meritdata>
+        <camunda:taskListener delegateExpression="${userTaskListener}" event="create" />     
+        <camunda:taskListener delegateExpression="${userTaskListener}" event="complete" />
+        <camunda:taskListener delegateExpression="${userTaskListener}" event="delete" />
+      </bpmn:extensionElements>
+      <bpmn:incoming>Flow_0902i1k</bpmn:incoming>
+      <bpmn:outgoing>Flow_01mc0vx</bpmn:outgoing>
+    </bpmn:userTask>
+    <bpmn:endEvent id="Event_16yttqg" name="结束">
+      <bpmn:incoming>Flow_0cbz45i</bpmn:incoming>
+    </bpmn:endEvent>
+    <bpmn:sequenceFlow id="Flow_1uhgeou" sourceRef="Event_0esv7me" targetRef="Activity_0hwkbjn">
+      <bpmn:extensionElements>
+        <camunda:executionListener delegateExpression="${lineListener}" event="take" />
+      </bpmn:extensionElements>
+    </bpmn:sequenceFlow>
+  </bpmn:process>
+  <bpmndi:BPMNDiagram id="BpmnDiagram_1">
+    <bpmndi:BPMNPlane id="BpmnPlane_1" bpmnElement="Process_Demo1">
+      <bpmndi:BPMNEdge id="Flow_0cbz45i_di" bpmnElement="Flow_0cbz45i">
+        <di:waypoint x="1184" y="261" />
+        <di:waypoint x="1198" y="261" />
+        <di:waypoint x="1198" y="280" />
+        <di:waypoint x="1211" y="280" />
+      </bpmndi:BPMNEdge>
+      <bpmndi:BPMNShape id="Event_16yttqg_di" bpmnElement="Event_16yttqg">
+        <dc:Bounds x="1211" y="261" width="38" height="38" />
+        <bpmndi:BPMNLabel>
+          <dc:Bounds x="1219" y="302" width="22" height="14" />
+        </bpmndi:BPMNLabel>
+      </bpmndi:BPMNShape>
+      <bpmndi:BPMNShape id="Activity_0awjt76_di" bpmnElement="Activity_0awjt76">
+        <dc:Bounds x="1016" y="233" width="168" height="55" />
+      </bpmndi:BPMNShape>
+    </bpmndi:BPMNPlane>
+  </bpmndi:BPMNDiagram>
+</bpmn:definitions>
+
+```
+
+[IMG: image-20210617172301211]
+
+以上的流程涉及到：表单到xml的转化及xml到表单的回显逻辑。
+
+流程设计器的主要代码及组件
+
+[IMG: image-20210621150204933]
+
+activiti.json  --定义的是XML中的标签及属性。
+
+contextPadConfig.json -- 定义画板，组件配置。
+
+dialog.json -- 定义各组件弹框大小。
+
+paletteConfig.json --  定义组件类型。
+
+rendererConfig.js -- 渲染器配置。
+
+具体扩展有参考文档。《流程设计器使用说明v2.doc》
+
+components 文件夹下基本都是弹框，表单组件。
+
+### 4.2 程业务维护模块
+
+此分类主要涉及的是流程的周边功能，如下
+
+[IMG: image-20210617172818271]
+
+流程设计--顾名思义就是上面提到的流程设计模块
+
+流程监控--为发起启动流程后流程实例的列表
+
+流程项管理--主要为流程的权限配置
+
+意见管理--意见模板的维护
+
+外出代理-顾名思义就是人员外出代理的配置
+
+流程服务--主要为流程设计器中监听配置表达式的维护
+
+
+
+配置权限的介绍：
+
+1.配置流程的管理员权限
+
+[IMG: image-20210621151207127]
+
+配置完成后 
+
+拥有管理员权限的用户就具有以下功能：
+
+1）个人样例中的删除按钮权限
+
+[IMG: image-20210621151528307]
+
+2) 拥有查看所有流程实例的权限
+
+3）若是流程中某个节点的处理人时，会显示特送，管理特送按钮
+
+2.流程实例查看权限
+
+[IMG: image-20210621151934163]
+
+部门查看权限 -- 可以查看本部门人的起草的流程
+
+部门参与权限 -- 可以查看本部门人参与的流程
+
+公司查看权限 -- 可以查看本公司（机构）人参与的所有流程
+
+
+
+流程追踪查看页面
+
+[IMG: image-20210621154955986]
+
+前端代码位置
+
+[IMG: image-20210621155136409]
+
+### 4.3 流程基础组件模块
+
+作为平台，我们提供了流程中的一些基本组件包含:流程操作的按钮，一些弹框，实例的选择按钮等。
+
+实例的选择按钮
+
+[IMG: image-20210617173409387]
+
+[IMG: image-20210621154332485]
+
+流程操作按钮
+
+[IMG: image-20210617173457376]
+
+[IMG: image-20210621154452079]
+
+按钮中主要调用的方法都封装在merit-bpm.js中
+
+前端代码主要在cloud-module-bpm工程中
+
+点击按钮后的操作流程说明，以发送按钮为例：
+
+点击发送按钮---》@click="BPMEventBus('doSend', bpmBtn)" 触发 merit-bpm.js中定义的MeritBPM.doSend方法---》
+
+判断按钮类型 ----》若为发送按钮---》运行规则引擎方法获取节点候选人，候选人不为空---》是否需要填写意见---》若需要，弹出意见框---
+
+点击保存意见触发保存意见及意见保存后方法---》意见保存方法中判断按钮类型---》---若需要选人 ---》 弹出选人框 ---》点击确定--》
+
+》触发merit-bpm.js中MeritBPM.bpmUserSelectSave方法--》调用完成任务方法--》流程完成流转
+
+### 4.4 流程样例模块
+
+此模块为样例模块，主要为其他项目提供开发模板及开发自测流程样例
+
+现有样例流程ID固定为 Process_Demo1
+
+前端代码在cloud-system-bpm-demo   后端在 cloud-system-bpm-demo