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

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-02-/345/267/245/344/275/234/346/265/201/347/250/213-/347/253/240/350/212/20204_/345/220/216/347/253/257/345/267/245/347/250/213/344/270/232/345/212/241/347/261/273/345/210/233/345/273/272.md

@@ -1,548 +0,0 @@
----
-name: 攻略-02-工作流程-章节04_后端工程业务类创建
-description: 后端工程业务类创建 — 美林平台 BPM 工作流程应用开发完整教程（工程创建 / 配置 / 业务类）
-keywords: [BPM, 工作流程, 开发教程, 工程创建, pom.xml, bootstrap.properties, 二开, 后端工程业务类创建]
-use-cases: [从零创建 BPM 二开工程, 配置 nacos, 编写流程业务类]
-source-section: 3. 后端工程业务类创建
-source-file: 应用开发平台-流程管理-使用攻略（二）：工作流程应用开发.md
----
-
-# 3. 后端工程业务类创建
-
-## 📋 API 契约（机器可读）
-
-```json
-{
-  "apiName": "BusinessService",
-  "type": "java",
-  "signature": "class BusinessService",
-  "functionDesc": "BPM 业务 Service 类（@Service + @Autowired BpmEngine）",
-  "module": "platform",
-  "methods": [],
-  "bestPractice": "确保方法抛出的异常已被 Service 层 catch 或全局异常处理器处理"
-}
-```
-
-- 点击 com.meritdata.cloud ——>鼠标右键——> 点击 New ——> 选择 Package
-  ![](./imgs/流程应用开发/1-31.jpg)
-  在"New Package"界面 分别创建 controller,entity,repository,service 包
-  ![](./imgs/流程应用开发/1-9.jpg)
-
-- 添加完包后，按照下图创建对应的 java 文件，
-  点击包名 ——>鼠标右键 ——>点击 New ——> 选择 java class
-  ![](./imgs/流程应用开发/1-10.jpg)
-
-### 3.1 实体类
-
-| 类名          | 类型  | 父类                    | 说明                                                                                          |
-| ------------- | ----- | ----------------------- | --------------------------------------------------------------------------------------------- |
-| TravelExpense | class | 继承 CloudBaseEntity 类 | CloudBaseEntity 属于系统基础实体类，维护多租户标识 添加创建时间，更新时间，作者和更新人员信息 |
-
-完整代码如下:
-
-```java
-package com.meritdata.cloud.entity;
-import com.meritdata.cloud.base.entity.CloudBaseEntity;
-import lombok.Data;
-import org.hibernate.annotations.GenericGenerator;
-import javax.persistence.*;
-/**
- * 出差费用报价单
- */
-@Entity
-@Data
-@Table(name = "pf_bpm_travel_expense")
-@GenericGenerator(name = "jpa-uuid", strategy = "uuid")
-public class TravelExpense extends CloudBaseEntity {
-
-    @Id
-    @GeneratedValue(generator = "jpa-uuid")
-    @Column(name = "[ID]")
-    private String id;
-
-    /**
-     * 标题
-     */
-    @Column(name = "[PROJECT]")
-    private String project;
-
-    /**
-     * 所属部门
-     */
-    @Column(name = "[BELONG_DEPART]")
-    private String belongDepart;
-
-    /**
-     * 申请人
-     */
-    @Column(name = "[NAME]")
-    private String name;
-
-    /**
-     * 出差类型 0.项目支持，1.售前支撑
-     */
-    @Column(name = "[TYPE]")
-    private String type;
-
-    /**
-     * 金额
-     */
-    @Column(name = "[AMOUNT]")
-    private Double amount;
-
-    /**
-     * 出差目的地
-     */
-    @Column(name = "[DESTINATION]")
-    private String destination;
-
-    /**
-     * 出差事由
-     */
-    @Column(name = "[TRAVEL_REMARK]")
-    private String travel_remark;
-
-    /**
-     * 出差时间
-     */
-    @Column(name = "[TRAVEL_TIME]")
-    private Long travel_time;
-}
-
-```
-
-### 3.2 持久层
-
-系统持久层框架使用 JPA+QueryDsl。JPA 主要负责数据库的新增、修改、删除。QueryDsl 主要负责对数据库的查询操作。
-| 类名 | 类型 | 父类 | 说明|
-| ------------- | ----- | ----------------------- |-----|
-| TravelExpenseRepository | interface | 分别继承 JpaRepository 类，QuerydslPredicateExecutor 类 | JpaRepository 提供了默认的保存查找等方法，QuerydslPredicateExecutor 接口是为了使用 QueryDsl|
-
-JpaRepository 的使用和 QueryDsl 的使用
-查看《二次开发：业务应用》 附件 1
-
-完整代码如下:
-
-```java
-package com.meritdata.cloud.repository;
-
-import com.meritdata.cloud.entity.TravelExpense;
-import org.springframework.data.jpa.repository.JpaRepository;
-import org.springframework.data.querydsl.QuerydslPredicateExecutor;
-
-/**
- * 查看单表
- */
-public interface TravelExpenseRepository extends JpaRepository<TravelExpense, String>, QuerydslPredicateExecutor<TravelExpense> {
-
-}
-```
-
-### 3.3 服务层
-
-#### 3.3.1 服务层接口
-
-| 类名                  | 类型      |
-| --------------------- | --------- |
-| ITravelExpenseService | interface |
-
-完整代码如下:
-
-```java
-package com.meritdata.cloud.service;
-import com.meritdata.cloud.base.mvc.entity.GridView;
-import com.meritdata.cloud.entity.TravelExpense;
-import javax.validation.constraints.NotNull;
-import java.util.List;
-import java.util.Map;
-
-public interface ITravelExpenseService {
-
-    /**
-     * 保存差旅费
-     * @return
-     */
-    TravelExpense saveTravelExpense(TravelExpense travelExpense);
-
-    /**
-     * 修改差旅费
-     */
-    TravelExpense updateTravelExpense(TravelExpense travelExpense);
-
-
-    /**
-     * 删除多条差旅费
-     * @param exampleIds
-     * @return
-     */
-    boolean deleteByIds(List<String> exampleIds);
-
-    /**
-     * 根据id查看单条
-     * @param id
-     * @return
-     */
-    TravelExpense getTravelExpense(String id);
-
-    /**
-     * page分页查询
-     * @param procDefKey
-     * @param bpmStatus
-     * @param pageSize
-     * @param pageNumber
-     * @param nextStartResults
-     * @param type
-     * @return
-     */
-    Object pageTravelExpense(@NotNull String procDefKey, @NotNull String bpmStatus, int pageSize, long pageNumber, Long nextStartResults, String type);
-    //理想化查询
-    GridView<Map> pageTravelExpenseIdeal(String procDefKey, String bpmStatus, Integer pageSize, Long pageNumber);
-}
-
-```
-
-#### 3.3.2 服务层实现
-
-| 类名              | 类型  | 父类                          |
-| ----------------- | ----- | ----------------------------- |
-| TravelExpenseImpl | class | 实现 ITravelExpenseService 类 |
-
-完整代码如下:
-
-```java
-package com.meritdata.cloud.service.impl;
-
-import com.alibaba.fastjson.JSON;
-import com.google.common.collect.Lists;
-import com.meritdata.cloud.base.mvc.entity.GridView;
-import com.meritdata.cloud.bpm.base.dto.MainFormQueryDTO;
-import com.meritdata.cloud.bpm.core.BpmEngine;
-import com.meritdata.cloud.entity.QTravelExpense;
-import com.meritdata.cloud.entity.TravelExpense;
-import com.meritdata.cloud.repository.TravelExpenseRepository;
-import com.meritdata.cloud.resultmodel.ResultBody;
-import com.meritdata.cloud.service.ITravelExpenseService;
-import com.querydsl.core.types.ExpressionUtils;
-import com.querydsl.core.types.Predicate;
-import com.querydsl.jpa.impl.JPAQueryFactory;
-import org.apache.commons.collections.CollectionUtils;
-import org.apache.commons.lang3.StringUtils;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.stereotype.Service;
-import org.springframework.transaction.annotation.Transactional;
-
-import java.beans.IntrospectionException;
-import java.beans.PropertyDescriptor;
-import java.lang.reflect.Field;
-import java.lang.reflect.InvocationTargetException;
-import java.lang.reflect.Method;
-import java.util.*;
-import java.util.stream.Collectors;
-
-@Service
-@Transactional
-public class TravelExpenseImpl implements ITravelExpenseService {
-
-    @Autowired
-     JPAQueryFactory jpaQueryFactory;
-
-    @Autowired
-     TravelExpenseRepository travelExpenseDao;
-
-    //引入流程
-    @Autowired
-    BpmEngine bpmEngine ;
-
-    /**
-     *
-     * @param procDefKey
-     * @param bpmStatus
-     * @param pageSize
-     * @param pageNumber
-     * @param nextStartResults
-     * @param type
-     * @return
-     */
-    @Override
-    public Object pageTravelExpense( String procDefKey,  String bpmStatus, int pageSize, long pageNumber, Long nextStartResults, String type) {
-
-        //流程代码
-        MainFormQueryDTO formQuery = new MainFormQueryDTO();
-        formQuery.setBpmStatus(bpmStatus); //流程状态
-        formQuery.setOrderFields(Lists.newArrayList(formQuery.new Field(MainFormQueryDTO.SORT_BY_UPDATE_TIME, true)));
-
-        //业务代码 ideal理想化查询
-        if ("ideal".equals(type)) {
-            return this.getIdealProcExample(procDefKey, formQuery, pageSize, pageNumber);
-        }
-        return new GridView<>();
-    }
-
-
-    @Override
-    public GridView<Map> pageTravelExpenseIdeal(String procDefKey, String bpmStatus, Integer pageSize, Long pageNumber) {
-        MainFormQueryDTO formQuery = new MainFormQueryDTO();
-        formQuery.setBpmStatus(bpmStatus);
-        formQuery.setOrderFields(Lists.newArrayList(formQuery.new Field(MainFormQueryDTO.SORT_BY_UPDATE_TIME, true)));
-        return getIdealProcExample(procDefKey, formQuery, pageSize, pageNumber);
-
-    }
-
-    @Override
-    public TravelExpense saveTravelExpense(TravelExpense travelExpense) {
-        return travelExpenseDao.save(travelExpense);
-    }
-
-    @Override
-    public TravelExpense updateTravelExpense(TravelExpense travelExpense) {
-        return travelExpenseDao.save(travelExpense) ;
-    }
-
-
-    @Override
-    public boolean deleteByIds(List<String> travelIds) {
-        QTravelExpense travelExpense = QTravelExpense.travelExpense;
-        Predicate predicate = travelExpense.id.in(travelIds);
-        Iterable<TravelExpense> all = travelExpenseDao.findAll(predicate);
-        return this.deleteList(all);
-    }
-
-    @Override
-    public TravelExpense getTravelExpense(String id) {
-        TravelExpense exampleById = travelExpenseDao.findById(id).get();
-        return exampleById;
-    }
-
-    /**
-     *理想化查询
-     * @param procDefKey 流程key
-     * @param formQueryDTO dto
-     * @param pageSize
-     * @param pageNumber
-     * @return
-     */
-    public  GridView<Map> getIdealProcExample(String procDefKey, MainFormQueryDTO formQueryDTO, long pageSize, long pageNumber) {
-
-            long nextStrartIdx =(pageNumber -1) * pageSize;
-            nextStrartIdx = nextStrartIdx < 0 ? 0:nextStrartIdx;
-            long total = 0;
-            // 流程实例获取 根据流程key和流程状态
-            ResultBody<GridView> resultBody = bpmEngine.queryMainForms(JSON.toJSONString(formQueryDTO), procDefKey, nextStrartIdx, pageSize);
-            List<Map> mainForms = new ArrayList<>();
-            if(null != resultBody && resultBody.isSuccess() && null != resultBody.getData()) {
-                    List<Map> rows = resultBody.getData().getRows();
-                    if (CollectionUtils.isNotEmpty(rows)) {
-                        mainForms.addAll(rows);
-                    }
-                    total = resultBody.getData().getTotal();
-            }
-
-            // 获取流程中的businessId(业务Id)
-            Map<String, Map> mainFormMap = new HashMap<String, Map>();
-            List<String> businessIdAll = new ArrayList<>();
-            for (Map map: mainForms) {
-                Object businessIdObj = map.get("businessId"); //获取到其中的业务id
-                if (null != businessIdObj && StringUtils.isNotBlank(businessIdObj.toString())) {
-                    String businessId = businessIdObj.toString();
-                    businessIdAll.add(businessId);
-                    mainFormMap.put(businessId,map);
-                }
-            }
-            //根据获取的业务id 查询业务数据
-            List<Map> result = null;
-            QTravelExpense travelExpense = QTravelExpense.travelExpense;
-            Predicate predicate = null;
-            predicate = ExpressionUtils.and(predicate,travelExpense.id.in(businessIdAll));
-            result = jpaQueryFactory.select(travelExpense)
-                    .from(travelExpense)
-                    .where(predicate)
-                    .orderBy(travelExpense.updateTime.desc())
-                    .fetch()
-                    .stream()
-                    .map(item ->{
-                        return this.covertMainFormToMap(mainFormMap,item);
-                    }).collect(Collectors.toList());
-
-
-        return new GridView<>(result,total);
-    }
-        //获取流程中未处理人，处理状态，处理节点
-    private Map covertMainFormToMap(Map<String, Map> mainFormMap, TravelExpense item)  {
-            Field[] fields=item.getClass().getDeclaredFields();
-            Map map = new HashMap();
-            for (Field field : fields) {
-                try {
-                    PropertyDescriptor pd =new PropertyDescriptor(field.getName(),item.getClass());
-                    Method method = pd.getReadMethod();
-                    map.put(field.getName(),method.invoke(item));
-                } catch (IntrospectionException | IllegalAccessException | InvocationTargetException e) {
-                }
-            }
-            Map mainform = mainFormMap.get(item.getId());
-            if (null != mainform) {
-                map.put("flowAuthorNames", mainform.get("flowAuthorNames"));
-                map.put("flowReaderIds", mainform.get("flowReaderIds"));
-                map.put("nodeNames", mainform.get("nodeNames"));
-                map.put("procDealStatus", mainform.get("procDealStatus"));
-            }
-            return map;
-        }
-
-     // 根据流程实例Ids删除流程实例
-    private  boolean deleteList(Iterable<TravelExpense> all) {
-            if (null != all) {
-                Iterator<TravelExpense> iterator = all.iterator();
-                List<String> businessIds = new ArrayList<>();
-                while (iterator.hasNext()) {
-                    String businessId = iterator.next().getId();
-                    businessIds.add(businessId);
-                }
-                if (CollectionUtils.isNotEmpty(businessIds)) {
-                    // 流程代码
-                    ResultBody<Boolean> resultBody = bpmEngine.deleteProcInsts(businessIds);
-                    if (null != resultBody && resultBody.isSuccess() && resultBody.getData()) {
-                        // 业务代码
-                        travelExpenseDao.deleteAll(all);
-                        return true;
-                    }
-                }
-            }
-            return false;
-        }
-}
-```
-
-注意：添加完 TravelExpenseImpl 类中代码后，编译工程，maven->compile
-![image](./imgs/流程应用开发/1-48.jpg)
-
-### 3.4 控制层
-
-| 类名                    | 类型  |
-| ----------------------- | ----- |
-| TravelExpenseController | class |
-
-完整代码如下:
-
-```java
-package com.meritdata.cloud.controller;
-
-import cn.hutool.core.util.StrUtil;
-import com.meritdata.cloud.base.mvc.entity.GridView;
-import com.meritdata.cloud.bpm.base.utils.StringUtils;
-import com.meritdata.cloud.entity.TravelExpense;
-import com.meritdata.cloud.resultmodel.ResultBody;
-import com.meritdata.cloud.service.ITravelExpenseService;
-import io.swagger.annotations.Api;
-import io.swagger.annotations.ApiOperation;
-import io.swagger.annotations.ApiParam;
-import org.springframework.beans.factory.annotation.Autowired;
-import org.springframework.web.bind.annotation.*;
-
-import java.util.*;
-
-/**
- * 差旅费报销流程
- */
-@RestController
-@RequestMapping(value = "/api/travel-expense")
-@Api(value = "TravelExpenseController}", tags = "")
-public class TravelExpenseController {
-
-    @Autowired
-    private ITravelExpenseService travelExpenseService;
-
-    /**
-     * 修改
-     */
-    @PostMapping("/update")
-    @ApiOperation(value = "修改")
-    public ResultBody<TravelExpense> update(@RequestParam TravelExpense travelExpense) {
-        TravelExpense result = null;
-        try {
-            result = travelExpenseService.updateTravelExpense(travelExpense);
-        } catch (Exception e) {
-            e.printStackTrace();
-            return ResultBody.failure(e.getMessage());
-        }
-        return ResultBody.success(result);
-    }
-
-    /**
-     * 新增
-     */
-    @PostMapping("/save")
-    @ApiOperation(value = "新增")
-    public ResultBody<TravelExpense> save(TravelExpense travelExpense) {
-        TravelExpense result = null;
-        try {
-            result = travelExpenseService.saveTravelExpense(travelExpense);
-        } catch (Exception e) {
-            e.printStackTrace();
-            return ResultBody.failure(e.getMessage());
-        }
-
-        return ResultBody.success(result);
-    }
-
-
-    /**
-     * 批量删除
-     */
-    @PostMapping("/delete")
-    @ApiOperation(value = "批量删除")
-    public ResultBody<Boolean> remove(String ids) {
-        List<String> idList = Arrays.asList(StrUtil.split(ids, ","));
-        boolean result;
-        try {
-            result = travelExpenseService.deleteByIds(idList);
-        } catch (Exception e) {
-            e.printStackTrace();
-            return ResultBody.failure(e.getMessage());
-        }
-
-        return ResultBody.success(result);
-    }
-
-    /**
-     * 获取单个差旅费流程
-     *
-     * @param id
-     * @return
-     */
-    @PostMapping("/get-travel-expense")
-    @ApiOperation(value = "获取单个差旅费流程")
-    public ResultBody<TravelExpense> getTravelExpense(String id) {
-        TravelExpense travelExpense = new TravelExpense();
-        try {
-            if (!"".equals(id)) {
-                travelExpense = travelExpenseService.getTravelExpense(id);
-            }
-        } catch (Exception e) {
-            e.printStackTrace();
-            return ResultBody.failure(e.getMessage());
-        }
-        return ResultBody.success(travelExpense);
-    }
-
-    /**
-     * 理想化查询
-     *
-     * @param procDefKey
-     * @param bpmStatus
-     * @param pageSize
-     * @param pageNumber
-     * @return
-     */
-    @RequestMapping(value = "/page/ideal", method = RequestMethod.POST)
-    public @ResponseBody
-    ResultBody<GridView<Map>> 
-        pageProcExampleIdeal(@RequestParam(name = "procDefKey") String procDefKey,
-                             @RequestParam(name = "bpmStatus") String bpmStatus,
-                             @RequestParam(name = "pageSize", required = false, defaultValue = "10") Integer pageSize,
-                             @RequestParam(name = "pageNumber", required = false, defaultValue = "1") Long pageNumber) {
-        GridView<Map> gridView = travelExpenseService.pageTravelExpenseIdeal(procDefKey, bpmStatus, pageSize, pageNumber);
-        return ResultBody.success(gridView);
-    }
-
-}
-```

package/skills/meritdata-dev-docs-file-finder/references/dev-docs//346/224/273/347/225/245-02-/345/267/245/344/275/234/346/265/201/347/250/213-/347/253/240/350/212/20205_/345/220/257/345/212/250/345/220/216/347/253/257/345/272/224/347/224/250/345/267/245/347/250/213.md

@@ -1,49 +0,0 @@
----
-name: 攻略-02-工作流程-章节05_启动后端应用工程
-description: 启动后端应用工程 — 美林平台 BPM 工作流程应用开发完整教程（工程创建 / 配置 / 业务类）
-keywords: [BPM, 工作流程, 开发教程, 工程创建, pom.xml, bootstrap.properties, 二开, 启动后端应用工程]
-use-cases: [从零创建 BPM 二开工程, 配置 nacos, 编写流程业务类]
-source-section: 4. 启动后端应用工程
-source-file: 应用开发平台-流程管理-使用攻略（二）：工作流程应用开发.md
----
-
-# 4. 启动后端应用工程
-
-### 4.1 启动后端工程服务
-
-配置启动 key 文件
-![](./imgs/流程应用开发/1-44.jpg)
-在 VM options 中配置 key 文件,key 文件在 merit_cloud 文件夹下的 key 文件夹下
-
-```
-  -DCLOUD_HOME= key路径
-```
-
-本案例中 key 路径为：C:/work/soft/run/merit_cloud
-
-再添加认证参数和允许循环依赖
-
--Dmeritdata.cloud.authentication-server-url=${CLOUD_HOME}/key
--Dspring.main.allow-circular-references=true
-
-如下图所示：
-
-![image-20220614093829639](.\imgs\流程应用开发\image-20220614093829639.png)
-
-![](./imgs/流程应用开发/1-43.jpg)
-
-启动后端应用
-选择 CloudBaseDemoProjectApplication,右键,选择 Run "CloudBaseDemoProjectApplication"
-![](./imgs/流程应用开发/1-11.jpg)
-启动成功
-![](./imgs/流程应用开发/1-12.jpg)
-
-### 4.2 检查后端工程服务
-
-查看后端工程服务是否注册到 Nacos 中。
-nacos 地址：
-url:http://localhost:8848/nacos/#/serviceManagement?dataId=&group=&appName=&namespace=
-账号：admin
-密码：BigData.2018v6
-
-![](./imgs/流程应用开发/1-13.jpg)