接口文档描述修改

yangys

2025-07-08 ffd5abc74eea1f6ee6433ac11e401aaa57bcc4ab

 blade-service/blade-mdm/src/main/java/org/springblade/mdm/flow/controller/DispatchController.java

@@ -1,8 +1,10 @@
package org.springblade.mdm.flow.controller;

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.Parameter;
import io.swagger.v3.oas.annotations.tags.Tag;
import lombok.AllArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.apache.commons.lang3.StringUtils;
import org.flowable.engine.TaskService;
@@ -16,7 +18,9 @@
import org.springblade.mdm.flow.entity.ApproveRecord;
import org.springblade.mdm.flow.excution.StartDispatcher;
import org.springblade.mdm.flow.service.ApproveRecordService;
import org.springblade.mdm.flow.service.FlowCommonService;
import org.springblade.mdm.flow.vo.TaskAssignVO;
import org.springblade.mdm.program.entity.ProcessProgRef;
import org.springblade.mdm.program.service.ProcessProgRefService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.PostMapping;
@@ -30,19 +34,19 @@

@Slf4j
@RestController
@AllArgsConstructor
@RequestMapping("/flow/dispatch")
@Tag(name = "派工流程", description = "派工流程")
public class DispatchController {

   @Autowired
   private StartDispatcher dispatcher;
   @Autowired
   private TaskService taskService;
   @Autowired
   private ProcessProgRefService processProgRefService;
   private final StartDispatcher dispatcher;

   @Autowired
   private final TaskService taskService;

   private final ProcessProgRefService processProgRefService;

   private ApproveRecordService approveRecordService;
   private final FlowCommonService flowCommonService;
   /**
    * 新增
    */
@@ -55,7 +59,7 @@

   @Operation(summary = "完成任务", description = "流向下一个节点")
   @PostMapping("completeTask")
   public R<Void> completeTask(String taskId, String processInstanceId, String comment,@Parameter(description = "对应的程序id,逗号分隔") String programIds, @Parameter(name = "variables", description = "任务变量") @RequestBody Map<String, Object> variables) {
   public R<Void> completeTask(String taskId, String processInstanceId, String comment,@Parameter(name = "variables", description = "任务变量") @RequestBody Map<String, Object> variables) {
      // 增加评论
      if (StringUtil.isNoneBlank(processInstanceId, comment)) {
         taskService.addComment(taskId, processInstanceId, comment);
@@ -63,6 +67,10 @@
      // 非空判断
      if (Func.isEmpty(variables)) {
         variables = Kv.create();
      }
      String programIds = null;
      if(variables.containsKey("programIds")){
         programIds = variables.get("programIds").toString();
      }
      if(StringUtils.isNotEmpty(programIds)) {
         processProgRefService.addRelations(processInstanceId,Func.toLongList(programIds));
@@ -72,7 +80,8 @@
      variables.put("approveUserNickName",AuthUtil.getNickName());

      if(variables.containsKey("assignee")){
         addApproveRecord(taskId,processInstanceId,comment,programIds,variables);

         addApproveRecord(taskId,processInstanceId,comment,variables);
         //指定了下一步执行人
         taskService.complete(taskId, variables);

@@ -84,29 +93,13 @@

   }

   void addApproveRecord(String taskId, String processInstanceId, String comment,String programIds,Map<String, Object> variables){
      List<Long> programIdList = new ArrayList<>();
      if(programIds != null){
         programIdList = Func.toLongList(programIds);
      }else{
         programIdList.add(null);
      }
   void addApproveRecord(String taskId, String processInstanceId, String comment,Map<String, Object> variables){
      String operateResult = variables.get("approve")+"";

      Task task = taskService.createTaskQuery()
         .taskId(taskId)
         .singleResult();
      for(Long programId : programIdList){
         ApproveRecord rec = new ApproveRecord();
         rec.setTaskName(task.getName());
         rec.setComment(comment);
         rec.setNcProgramId(programId);
         rec.setOperateResult(variables.get("approve")+"");//审批结果
         rec.setOperateTime(DateUtil.now());
         rec.setProcessInstanceId(processInstanceId);
         rec.setUserId(AuthUtil.getUserId());
         rec.setUserNickname(AuthUtil.getNickName());

         approveRecordService.save(rec);
      }
      approveRecordService.saveApproveRecords(task,processInstanceId,operateResult,comment);

   }
}