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

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

@@ -0,0 +1,548 @@
+---
+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

@@ -0,0 +1,49 @@
+---
+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)