@alanwang-merit/meritdata-platform-skill-package 1.0.0

package/skills/meritdata-dev-docs-file-finder/references/dev-docs/.bak//345/272/224/347/224/250/345/274/200/345/217/221/345/271/263/345/217/260-/346/265/201/347/250/213/347/256/241/347/220/206-/344/275/277/347/224/250/346/224/273/347/225/245/357/274/210/344/272/224/357/274/211/357/274/232/345/276/205/345/212/236/345/220/214/346/255/245/351/227/250/346/210/267/345/274/200/345/217/221.md

@@ -0,0 +1,270 @@
+---
+title: 应用开发平台流程管理使用攻略（五）：待办同步门户开发
+date: 2025.05.28
+categories:
+  - 开发攻略
+  - 6.13.2
+---
+
+## 																																应用开发平台流程管理使用攻略（五）：待办同步门户开发
+
+## 1. 背景
+
+有部分项目需要将流程产生的待办同步到其他门户页面处理。
+
+## 2. 功能实现
+
+应用开发平台通过项目在nacos中配置的相关同步参数将待办信息同步到其他服务。
+
+下面说明参数含义及实现原理
+
+### 2.1 nacos 配置
+
+配置参数位置：
+
+common-cloud-bpm-engine.properties 
+
+配置项：
+
+支持向两个门户同时同步
+
+```properties
+#同步待办参数portal 门户  RTX
+#默认为false 不开启同步
+meritdata.cloud.synundo.portal.status=false
+#默认为false 不开启同步
+meritdata.cloud.synundo.rtx.status=false
+#向portal同步未处理的待办地址
+meritdata.cloud.sync.undeal.undo.portal.url=bpm/demo/synundo/to-portal
+#向portal同步已处理待办的地址
+meritdata.cloud.sync.deal.undo.portal.url=bpm/demo/synundo/to-portal
+#向Rtx门户同步未处理的待办地址
+meritdata.cloud.sync.undeal.undo.rtx.url=bpm/demo/synundo/to-rtx
+#向Rtx门户同步已处理的待办地址
+meritdata.cloud.sync.deal.undo.rtx.url=bpm/demo/synundo/to-rtx
+#向portal同步已删除代办数据的待办地址
+meritdata.cloud.sync-del-undo-portal-url=bpm/demo/syndelundo/to-portal
+#向Rtx门户同步已删除代办数据的待办地址
+meritdata.cloud.sync-del-undo-rtx-url=bpm/demo/syndelundo/to-rtx
+
+```
+
+原理：通过获取这些参数，通过feign的方式将待办数据以json入参的形式，调用配置的接口达到向其它服务同步待办的目的 。
+
+由于采用feign的调用方式，因此配置的服务必须是同一个nacos管理的服务。
+
+### 2.2 应用开发平台平台侧的实现代码
+
+```java
+package com.meritdata.cloud.bpm.event;
+
+import com.alibaba.fastjson.JSON;
+import com.meritdata.cloud.bpm.common.Constant;
+import com.meritdata.cloud.bpm.entity.Undo;
+import com.meritdata.cloud.bpm.fegin.IBpmUndoServiceClient;
+import com.meritdata.cloud.bpm.undo.service.IUndoService;
+import com.meritdata.cloud.utils.NacosUtils;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.stereotype.Service;
+
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.logging.Logger;
+
+/**
+ * 待办同步处理类
+ * @author merit
+ * 同步门户和RTX待办
+ */
+@Service
+public class UndoEvent {
+
+    @Autowired
+    NacosUtils nacosUtils;
+    private final static Logger LOGGER = Logger.getLogger(UndoEvent.class.getName());
+
+    @com.google.common.eventbus.Subscribe
+    public void sub(Map<String, Object> params){
+        IBpmUndoServiceClient synUndoClient = (IBpmUndoServiceClient)params.get("synUndoClient");
+        IUndoService undoService = (IUndoService)params.get("undoService");
+        // 调用参数 dealStatus : 待办处理状态 0 未处理 1 已处理 undos: 待办list
+        //portal同步  是否开启同步的判断
+        if(undoService.getSynUndo2Portal()){
+            syncToPortal(undoService, synUndoClient);
+        }
+        //RTX同步待办
+        if(undoService.getSynUndo2Rtx()){
+           syncToRtx(undoService, synUndoClient);
+        }
+    }
+
+    private void syncToRtx(IUndoService undoService, IBpmUndoServiceClient synUndoClient) {
+        // 获取未处理待办同步门户地址
+        String unDealRtxUrl = nacosUtils.getConfigValue(Constant.BPM_NACOS_CONFIG_FILE_NAME,
+                Constant.UNDEAL_UNDO_SYNC_RTX_URL_KEY);
+        LOGGER.info("unDealRtxUrl:" + unDealRtxUrl);
+        if (null != unDealRtxUrl && unDealRtxUrl.length() > Constant.INT_ZERO){
+            List<Undo> undealUndos = undoService.getSynFailedUndealUndosRtx();
+            if(undealUndos != null && undealUndos.size() > Constant.INT_ZERO){
+                boolean synFlag = synUndoClient.syncUndealUndoToRtx(unDealRtxUrl, JSON.toJSONString(undealUndos));
+                if(synFlag){
+                    for(Undo undo : undealUndos){
+                        undoService.updataUnodSynRtxStatus(undo,Constant.UNDEAL_SYNC_SUCESS);
+                    }
+                }
+            }
+        }
+
+        // 获取未处理待办同步门户地址
+        String dealRtxUrl = nacosUtils.getConfigValue(Constant.BPM_NACOS_CONFIG_FILE_NAME,
+                Constant.DEAL_UNDO_SYNC_RTX_URL_KEY);
+        LOGGER.info("dealRtxUrl: " + dealRtxUrl);
+        if (null != unDealRtxUrl && unDealRtxUrl.length() > Constant.INT_ZERO) {
+            List<Undo> dealUndos = undoService.getSynFailedDealUndosRtx();
+            if (dealUndos != null && dealUndos.size() > Constant.INT_ZERO) {
+                boolean synFlag = synUndoClient.syncDealUndoToRtx(dealRtxUrl, JSON.toJSONString(dealUndos));
+                if (synFlag) {
+                    for (Undo undo : dealUndos) {
+                        undoService.updataUnodSynRtxStatus(undo, Constant.DEAL_SYNC_SUCESS);
+                    }
+                }
+            }
+        }
+    }
+
+    private void syncToPortal(IUndoService undoService, IBpmUndoServiceClient synUndoClient) {
+        // 获取未处理待办同步门户地址
+        String unDealPortalUrl = nacosUtils.getConfigValue(Constant.BPM_NACOS_CONFIG_FILE_NAME,
+                Constant.UNDEAL_UNDO_SYNC_PORTAL_URL_KEY);
+        LOGGER.info("unDealPortalUrl: " + unDealPortalUrl);
+        if ( null != unDealPortalUrl && unDealPortalUrl.length() > Constant.INT_ZERO){
+            // 获取同步失败的未处理的待办
+            List<Undo> undealUndos = undoService.getSynFailedUndealUndos();
+            if(undealUndos != null && undealUndos.size() > Constant.INT_ZERO){
+                boolean synFlag = synUndoClient.syncUndealUndoToPortal(unDealPortalUrl, JSON.toJSONString(undealUndos));
+                if(synFlag){
+                    for(Undo undo : undealUndos){
+                        undoService.updataUnodSynStatus(undo, Constant.UNDEAL_SYNC_SUCESS);
+                    }
+                }
+            }
+        }
+        // 获取已处理待办同步门户地址
+        String dealPortalUrl = nacosUtils.getConfigValue(Constant.BPM_NACOS_CONFIG_FILE_NAME,
+                Constant.DEAL_UNDO_SYNC_PORTAL_URL_KEY);
+        LOGGER.info("dealPortalUrl" + dealPortalUrl);
+        if (null != dealPortalUrl && dealPortalUrl.length() > Constant.INT_ZERO){
+            List<Undo> dealUndos = undoService.getSynFailedDealUndos();
+            if(dealUndos != null && dealUndos.size() > Constant.INT_ZERO){
+                boolean synFlag = synUndoClient.syncDealUndoToPortal(dealPortalUrl, JSON.toJSONString(dealUndos));
+                if(synFlag){
+                    for(Undo undo : dealUndos){
+                        undoService.updataUnodSynStatus(undo,Constant.DEAL_SYNC_SUCESS);
+                    }
+                }
+            }
+        }
+
+    }
+
+
+}
+
+```
+
+Feign类代码
+
+```java
+package com.meritdata.cloud.bpm.fegin;
+
+import com.meritdata.cloud.bpm.entity.Undo;
+import com.meritdata.cloud.config.CloudFeignConfiguration;
+import io.swagger.annotations.ApiOperation;
+import org.springframework.cloud.openfeign.FeignClient;
+import org.springframework.web.bind.annotation.*;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * @author merit
+ *
+ * 同步待办feign接口
+ */
+@RestController
+@FeignClient(value = "${meritdata.cloud.custom-syncundo-service-name}",configuration = CloudFeignConfiguration.class)
+public interface IBpmUndoServiceClient {
+
+    /**
+     * 向portal同步未处理待办
+     *
+     * @param unDealPortalUrl 未处理待办地址
+     * @param undos 待办集合
+     * @return boolean
+     */
+    @ApiOperation(value = "向portal端同步未处理待办")
+    @RequestMapping(value = "/api/{unDealPortalUrl}",method = RequestMethod.POST)
+    public Boolean syncUndealUndoToPortal(@PathVariable("unDealPortalUrl") String unDealPortalUrl,
+                                          @RequestBody  String undos);
+
+    /**
+     * 向portal同步已处理待办
+     *
+     * @param dealPortalUrl 已处理待办地址
+     * @param undos 待办集合
+     * @return boolean
+     */
+    @ApiOperation(value = "向portal端同步待办")
+    @RequestMapping(value = "/api/{dealPortalUrl}",method = RequestMethod.POST)
+    public Boolean syncDealUndoToPortal(@PathVariable("dealPortalUrl") String dealPortalUrl, @RequestBody  String undos);
+
+
+    /**
+     * 向RTX同步未处理待办
+     *
+     * @param unDealRtxUrl 未处理待办同步RTX地址
+     * @param undos 待办集合
+     * @return Boolean
+     */
+    @ApiOperation(value = "向RTX端同步待办")
+    @RequestMapping(value = "/api/{unDealRtxUrl}",method = RequestMethod.POST)
+    public Boolean syncUndealUndoToRtx(@PathVariable("unDealRtxUrl") String unDealRtxUrl, @RequestBody  String undos);
+
+    /**
+     * 向RTX同步已处理待办
+     *
+     * @param dealRtxUrl 已处理待办同步RTX地址
+     * @param undos 待办集合
+     * @return Boolean
+     */
+    @ApiOperation(value = "向RTX端同步待办")
+    @RequestMapping(value = "/api/{dealRtxUrl}",method = RequestMethod.POST)
+    public Boolean syncDealUndoToRtx(@PathVariable("dealRtxUrl") String dealRtxUrl, @RequestBody  String undos);
+
+}
+
+```
+
+其他服务接收到待办数据后，就可以对待办数据进行处理展现或者继续同步到其它第三方系统。
+
+### 2.3 二开侧代码
+
+由于需要把JsonString转换为List\<UndoDTO>所以需要引入cloud-system-bpm-module-base 依赖包使用UndoDTO对象
+
+样例代码：入参 String    返参 Boolean   
+
+接口地址必须以/api/开头，后面的部分地址就是配置在nacos中
+
+```java
+ @ApiOperation(value = "同步门户待办接口")
+    @RequestMapping(value = "/synundo/to-portal", method = RequestMethod.POST)
+    public Boolean synUndoToPortal(@RequestBody  String undos){
+        LOGGER.info("调用到了门户待办");
+        List<UndoDTO> undoList = JSON.parseArray(undos,UndoDTO.class);
+        // 后续处理逻辑
+        return true;
+    }
+```
+