npm - @alanwang-merit/meritdata-platform-skill-package - Versions diffs - 1.0.9 → 1.0.11 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (546) hide show

package/skills/meritdata-platform-bpm/references/custom-assignee.md ADDED Viewed

@@ -0,0 +1,28 @@
+自定义人员用于在用户任务进入下一环节时，按业务条件返回候选处理人编码。历史 6.2/6.3 配置方式可能不同，先从目标 BPM 版本和已部署流程设计器确认字段与路由。
+## 1. 配置位置
+在流程设计器的用户任务人员配置中选择“自定义”。填写控制器标识、方法标识和可选的自定义条件；实际菜单名称以目标版本为准。
+## 2. 服务与路由契约
+服务名由 BPM 配置指向目标业务服务，例如：
+```properties
+meritdata.cloud.custom-service-name=<service-name>
+```
+历史路由形态为：
+```text
+/<service-name>/api/bpm/<controller>/getUserCode/<method>
+```
+其中 `<controller>` 和 `<method>` 由流程配置提供。先在目标服务的网关路由和 Controller 映射中验证该形态；不要复制历史示例服务名或路径。
+## 3. 请求与返回
+| 项目 | 要求 |
+| --- | --- |
+| 请求 | `POST`；参数为 `Map<String, String>`，可通过固定键 `customCondition` 传递业务条件 |
+| 返回 | `List<String>`，每项为目标环境中有效的人员编码 |
+| 校验 | 校验请求身份、业务对象权限、条件格式和返回人员的有效性及可见范围 |
+| 空结果 | 由流程定义或业务层明确处理，不能静默分配给默认用户 |
+## 4. 安全要求
+- BPM 到业务服务必须使用已认证的服务到服务调用，例如平台服务身份、OAuth2 客户端凭据或 mTLS，并按当前平台机制传递调用身份。
+- 业务服务必须授权该身份调用人员解析接口，并记录必要审计信息。
+- 不要在 Nacos 或网关中为 `getUserCode` 添加匿名、`permitAll` 或 URL 白名单绕过；这会让任意调用方枚举或影响流程处理人。
+## 5. 验证
+1. 用具有最小权限的已认证身份调用接口，确认无权业务对象被拒绝。
+2. 以有效和无效 `customCondition` 分别验证返回结果、空结果和错误处理。
+3. 在测试流程中确认返回编码与当前租户、组织和流程节点的处理人规则一致。

@@ -1,51 +1,51 @@
----
-name: 攻略-03-监听表达式-00_总览
-description: BPM 流程监听表达式二开实现（自定义 jar 包 + 自定义服务）
-keywords: [BPM, 监听表达式, JavaDelegate, 监听器, jar包, 二开]
-use-cases: [自定义流程监听器, BPM 流程节点事件触发, 自定义服务调用]
-related: [cloud-system-bpm-engine / Camunda]
-source: 应用开发平台-流程管理-使用攻略（三）：监听表达式开发.md
----
-# 应用开发平台流程管理使用攻略（三）：监听表达式开发 — 总览
-**摘要**：BPM 流程监听表达式二开实现（自定义 jar 包 + 自定义服务）
-**关联**：cloud-system-bpm-engine / Camunda
-## 章节索引
-01. [实现策略](攻略-03-监听表达式-章节01_实现策略.md) (原 1)
-02. [自定义 jar 包的实现流程](攻略-03-监听表达式-章节02_自定义_jar_包的实现流程.md) (原 2)
-03. [自定义服务搭建（若已存在工程和接口，此步骤可省略）](攻略-03-监听表达式-章节03_自定义服务搭建（若已存在工程和接口，此步骤可省略）.md) (原 3)
-04. [流程设计中设置 listener 参数](攻略-03-监听表达式-章节04_流程设计中设置_listener_参数.md) (原 4)
-05. [测试触发流程监听事件是否生效](攻略-03-监听表达式-章节05_测试触发流程监听事件是否生效.md) (原 5)
-## 引言
-        流程设计器中原生支持配置监听表达式参数，流程流转时能够按照事件自动触发配置类中重写的方法，执行表达式完成业务逻辑的执行。由于各项目的业务不同，应用开发平台无法提供统一的监听表达式，因此提供二次开发文档来指导各项目开发自己的监听表达式。
-## 📑 API 速查
-本攻略共 **1 个 API**（按章节排序）：
-| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
-|------|------|------|----------|------|------|
-| 章节02_自定义_jar_包的实现流程 | `CustomListener` | - | `class CustomListener` | java | 自定义监听器类（implements JavaDelegate） |
-### JSON Schema 完整索引
-```json
-[
-  {
-    "chapter": "章节02_自定义_jar_包的实现流程",
-    "apiName": "CustomListener",
-    "method": "",
-    "urlPattern": "",
-    "type": "java",
-    "signature": "class CustomListener",
-    "functionDesc": "自定义监听器类（implements JavaDelegate）"
-  }
-]
-```
+---
+name: 攻略-03-监听表达式-00_总览
+description: BPM 流程监听表达式二开实现（自定义 jar 包 + 自定义服务）
+keywords: [BPM, 监听表达式, JavaDelegate, 监听器, jar包, 二开]
+use-cases: [自定义流程监听器, BPM 流程节点事件触发, 自定义服务调用]
+related: [cloud-system-bpm-engine / Camunda]
+source: 应用开发平台-流程管理-使用攻略（三）：监听表达式开发.md
+---
+# 应用开发平台流程管理使用攻略（三）：监听表达式开发 — 总览
+**摘要**：BPM 流程监听表达式二开实现（自定义 jar 包 + 自定义服务）
+**关联**：cloud-system-bpm-engine / Camunda
+## 章节索引
+01. [实现策略](攻略-03-监听表达式-章节01_实现策略.md) (原 1)
+02. [自定义 jar 包的实现流程](攻略-03-监听表达式-章节02_自定义_jar_包的实现流程.md) (原 2)
+03. [自定义服务搭建（若已存在工程和接口，此步骤可省略）](攻略-03-监听表达式-章节03_自定义服务搭建（若已存在工程和接口，此步骤可省略）.md) (原 3)
+04. [流程设计中设置 listener 参数](攻略-03-监听表达式-章节04_流程设计中设置_listener_参数.md) (原 4)
+05. [测试触发流程监听事件是否生效](攻略-03-监听表达式-章节05_测试触发流程监听事件是否生效.md) (原 5)
+## 引言
+        流程设计器中原生支持配置监听表达式参数，流程流转时能够按照事件自动触发配置类中重写的方法，执行表达式完成业务逻辑的执行。由于各项目的业务不同，应用开发平台无法提供统一的监听表达式，因此提供二次开发文档来指导各项目开发自己的监听表达式。
+## 📑 API 速查
+本攻略共 **1 个 API**（按章节排序）：
+| 章节 | API | 方法 | 路径/签名 | 类型 | 描述 |
+|------|------|------|----------|------|------|
+| 章节02_自定义_jar_包的实现流程 | `CustomListener` | - | `class CustomListener` | java | 自定义监听器类（implements JavaDelegate） |
+### JSON Schema 完整索引
+```json
+[
+  {
+    "chapter": "章节02_自定义_jar_包的实现流程",
+    "apiName": "CustomListener",
+    "method": "",
+    "urlPattern": "",
+    "type": "java",
+    "signature": "class CustomListener",
+    "functionDesc": "自定义监听器类（implements JavaDelegate）"
+  }
+]
+```

@@ -11,7 +11,7 @@ source-file: 应用开发平台-流程管理-使用攻略（三）：监听表
 开发一个 jar 包放入 cloud-system-bpm 工程中，jar 包中的方法使用 feign 方式来调用自己业务的接口。
-![image-20210628111844355](.\imgs\监听二次开发\image-20210628111844355.png)
+[IMG: image-20210628111844355]
 ### 1.1 需要开发一个 jar 包和一个包含业务接口的微服务（若有微服务可以不用创建）

@@ -31,11 +31,11 @@ source-file: 应用开发平台-流程管理-使用攻略（三）：监听表
 1.在 IntelliJ IDEA 窗口中点击左上角 选择 "File->New-> Project"，创建一个新的工程
-![image-20210401093623690](.\imgs\监听二次开发\image-20210401093623690.png)
+[IMG: image-20210401093623690]
 2.在"New Project "页面选择"Maven"，然后配置工程所需要的 JDK,如果微服务版本未升级到6.13.2时，jdk选择1.8即可，否则jdk则需要选择21版本，在 run 文件夹下的 merit_cloud 文件夹中存放了一个 正确版本的jdk 可以选择使用，点击 下一步
-![image-20210401093655891](.\imgs\监听二次开发\image-20210401093655891.png)
+[IMG: image-20210401093655891]
 3.配置参数
@@ -44,13 +44,13 @@ source-file: 应用开发平台-流程管理-使用攻略（三）：监听表
 | GroupId    | com.meritdata.cloud   | 可以自定义             |
 | artifactId | project-listener-demo | 项目名称, 可自定义名称 |
-![image-20210401094011877](.\imgs\监听二次开发\image-20210401094011877.png)
+[IMG: image-20210401094011877]
 4.点击 java 文件夹-》右击鼠标-》选择 Mark Directory as -》Resources Root 设置 Java 文件为 root 文件
 逐级新建文件结构如下
-![](.\imgs\监听二次开发\image-20210311155149811.png)
+[IMG: (图片)]
 ### 2.1.2 修改 pom 文件
@@ -79,14 +79,14 @@ source-file: 应用开发平台-流程管理-使用攻略（三）：监听表
         //6.13.2版本需要21版本的jdk
         <java.version>21</java.version>
         <spring-cloud.version>Greenwich.SR3</spring-cloud.version>
-        <meritdata-cloud.version>${meritdata-cloud.version}</meritdata-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-cloud.version}</version>
+            <version>${meritdata-platform-cloud.version}</version>
         </dependency>
         // camunda依赖
         <dependency>
@@ -142,7 +142,7 @@ UserCustomTaskListener.java ---
 ```java
 package com.meritdata.cloud.listener;
-import com.meritdata.cloud.fegin.IUserTaskListener;
+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;
@@ -197,7 +197,7 @@ String xx = (String) delegateTask.getVariable("xx")
 IUserTaskListener.java ---用于定义调用应用开发平台接口
 ```java
-package com.meritdata.cloud.fegin;
+package com.meritdata.cloud.feign;
 import com.meritdata.cloud.config.CloudFeignConfiguration;
 import io.swagger.annotations.ApiOperation;
@@ -227,15 +227,15 @@ public interface IUserTaskListener {
 依次点击打出 jar 包--并在 target 文件夹下找到 jar 包
-![image-20210311160429487](.\imgs\监听二次开发\image-20210311160429487.png)
+[IMG: image-20210311160429487]
-![image-20210311160606017](.\imgs\监听二次开发\image-20210311160606017.png)
+[IMG: image-20210311160606017]
 ### 2.1.5 将 jar 包复制到/opt/merit_cloud/apps/system/server/bpm/WEB-INF/lib 目录下
 如下图
-![image-20210311161044426](.\imgs\监听二次开发\image-20210311161044426.png)
+[IMG: image-20210311161044426]
 微服务版本大于等于6.10以后，将jar包放置在/opt/merit_cloud/apps/system/server/bpm-dev-lib/目录下，同时要给此目录授权，同时修改/server/bpm/下cloud-system-bpm-engine.war，war包中的MF文件，添加监听包路径

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-bpm/references/listener}//346/224/273/347/225/245-03-/347/233/221/345/220/254/350/241/250/350/276/276/345/274/217-/347/253/240/350/212/20203_/350/207/252/345/256/232/344/271/211/346/234/215/345/212/241/346/220/255/345/273/272/357/274/210/350/213/245/345/267/262/345/255/230/345/234/250/345/267/245/347/250/213/345/222/214/346/216/245/345/217/243/357/274/214/346/255/244/346/255/245/351/252/244/345/217/257/347/234/201/347/225/245/357/274/211.md RENAMED Viewed

@@ -17,11 +17,11 @@ source-file: 应用开发平台-流程管理-使用攻略（三）：监听表
 - 选中 com.meritdata.cloud ——>鼠标右键——> 点击 New ——> 选择 Package
-- ![image-20210309100531855](.\imgs\监听二次开发\image-20210309100531855.png)
+- [IMG: image-20210309100531855]
 - 添加包目录,按照下图，分别添加 controller 包,entity 包,repository 包,service 包
-  ![image-20210309100626984](.\imgs\监听二次开发\image-20210309100626984.png)
+  [IMG: image-20210309100626984]
   添加 java 文件,按照下图,分别添加:
@@ -53,7 +53,7 @@ source-file: 应用开发平台-流程管理-使用攻略（三）：监听表
     package com.meritdata.cloud.controller;
     import com.alibaba.fastjson.JSONObject;
-    import com.meritdata.cloud.service.IBpmUserCustomService;
+    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;
@@ -109,7 +109,7 @@ public interface IBpmUserCustomService {
 ```java
 package com.meritdata.cloud.service.impl;
-import com.meritdata.cloud.service.IBpmUserCustomService;
+import com.meritdata.cloud.bpm.base.service.IBpmUserCustomService;
 import org.springframework.stereotype.Service;
 @Service("procUserCustomService")
@@ -127,24 +127,24 @@ public class BpmUserCustomServiceImpl implements IBpmUserCustomService {
 启动完毕后可在 nacos 中的服务列表页面查看，该应用已注册至 nacos
-![image-20210309102321752](.\imgs\监听二次开发\image-20210309102321752.png)
+[IMG: image-20210309102321752]
 ### 3.3 设置参数
 meritdata.cloud.custom-listener-name=应用开发平台名称
-![image-20210309104250874](.\imgs\监听二次开发\image-20210309104250874.png)
+[IMG: image-20210309104250874]
-![image-20210309153526242](.\imgs\监听二次开发\image-20210309153526242.png)
+[IMG: image-20210309153526242]
 meritdata.cloud.listener-controller-name=controller 地址
 示例：
-![image-20210309104203506](.\imgs\监听二次开发\image-20210309104203506.png)
+[IMG: image-20210309104203506]
 meritdata.cloud.listener-method-name = 接口地址
-![image-20210311161814985](.\imgs\监听二次开发\image-20210311161814985.png)
+[IMG: image-20210311161814985]
 若存在多个应用开发平台则 nacos 中配置多个参数即可，每个 feign 接口与之对应即可。

@@ -13,31 +13,31 @@ source-file: 应用开发平台-流程管理-使用攻略（三）：监听表
 登录账户-进入流程服务菜单添加已经配置好的监听类
-![image-20210628102718558](.\imgs\监听二次开发\image-20210628102718558.png)
+[IMG: image-20210628102718558]
 ### 4.2 流程节点配置监听参数
 点击流程编辑按钮-进入编辑状态-双击用户任务--选择监听参数配置框
-![](.\imgs\监听二次开发\image-20210309103008443.png)
+[IMG: (图片)]
-![image-20210309103223849](.\imgs\监听二次开发\image-20210309103223849.png)
+[IMG: image-20210309103223849]
 ### 4.2.1 添加表达式
-![image-20210628103121555](.\imgs\监听二次开发\image-20210628103121555.png)
+[IMG: image-20210628103121555]
 在表达式菜单中添加 userCustomTaskListener 表达式内容
-![image-20210628110631669](.\imgs\监听二次开发\image-20210628110631669.png)
+[IMG: image-20210628110631669]
-![image-20210628102918606](.\imgs\监听二次开发\image-20210628102918606.png)
+[IMG: image-20210628102918606]
-![image-20210628105151150](.\imgs\监听二次开发\image-20210628105151150.png)
+[IMG: image-20210628105151150]
 表达式 userCustomTaskListener 来自于之前在自定义 jar 中的 bean 名称
-![image-20210311161951475](.\imgs\监听二次开发\image-20210311161951475.png)
+[IMG: image-20210311161951475]
 事件类型目前支持开始和结束， 开始对应 ---create 结束对应--- complete

package/skills/{meritdata-dev-docs-file-finder/references/dev-docs → meritdata-platform-bpm/references/listener}//346/224/273/347/225/245-03-/347/233/221/345/220/254/350/241/250/350/276/276/345/274/217-/347/253/240/350/212/20205_/346/265/213/350/257/225/350/247/246/345/217/221/346/265/201/347/250/213/347/233/221/345/220/254/344/272/213/344/273/266/346/230/257/345/220/246/347/224/237/346/225/210.md RENAMED Viewed

@@ -11,13 +11,13 @@ source-file: 应用开发平台-流程管理-使用攻略（三）：监听表
 ### 5.1 创建测试流程测试
-![image-20210309135918804](.\imgs\监听二次开发\image-20210309135918804.png)
+[IMG: image-20210309135918804]
 ### 5.2 查看自定义业务是否生效
-![image-20210311164704675](.\imgs\监听二次开发\image-20210311164704675.png)
+[IMG: image-20210311164704675]
-![image-20210311201142536](.\imgs\监听二次开发\image-20210311201142536.png)
+[IMG: image-20210311201142536]
 由图可看到触发了自定义事件
@@ -27,15 +27,15 @@ source-file: 应用开发平台-流程管理-使用攻略（三）：监听表
 ### 1.表达式需要扩展，则仿照上面过程继续添加。
-示例：![image-20210311162530715](.\imgs\监听二次开发\image-20210311162530715.png)
+示例：[IMG: image-20210311162530715]
 ### 2.本例是以 UserTask 流程节点为例创建监听任务类，若添加线监听实现类过程与之类似，实现类需要改成 implements JavaDelegate 接口重写 execute 方法。
 服务任务节点配置的监听类也是要 implements JavaDelegate 接口重写 execute 方法。
-![image-20210401095619223](.\imgs\监听二次开发\image-20210401095619223.png)
+[IMG: image-20210401095619223]
-![image-20210311194204225](.\imgs\监听二次开发\image-20210311194204225.png)
+[IMG: image-20210311194204225]
 ### 3.在监听类维护时，为线创建的监听类维护时监听类型选择线任务监听，为流程服务和用户服务创建的选择用户任务监听（否则选择不到）。

@@ -11,15 +11,15 @@ source-file: 应用开发平台-流程管理-使用攻略（三）：监听表
 ### 1.表达式需要扩展，则仿照上面过程继续添加。
-示例：![image-20210311162530715](.\imgs\监听二次开发\image-20210311162530715.png)
+示例：[IMG: image-20210311162530715]
 ### 2.本例是以 UserTask 流程节点为例创建监听任务类，若添加线监听实现类过程与之类似，实现类需要改成 implements JavaDelegate 接口重写 execute 方法。
 服务任务节点配置的监听类也是要 implements JavaDelegate 接口重写 execute 方法。
-![image-20210401095619223](.\imgs\监听二次开发\image-20210401095619223.png)
+[IMG: image-20210401095619223]
-![image-20210311194204225](.\imgs\监听二次开发\image-20210311194204225.png)
+[IMG: image-20210311194204225]
 ### 3.在监听类维护时，为线创建的监听类维护时监听类型选择线任务监听，为流程服务和用户服务创建的选择用户任务监听（否则选择不到）。