流程action开发教程

action代码规范说明

基本代码结构介绍

技术思路:ESB 提供的接口,并将此接口按 dubbo 的方式注册到注册中心,然后通过ESB 动作流配置实现接口调用。

package路径:
import com.weaver.esb.api.rpc.EsbServerlessRpcRemoteInterface;

一、代码基本结构如下:

通过注解的形式定义实例bean名称,对应dubbo.xm! 服务提供者配置中的ref 并且实现 EsbServerlessRpcRemoteInterface 接口
@Service("actionTestDemo")
public class WfTestAction implements EsbServerlessRpcRemoteInterface {
     @Override
    public WeaResult<Map<String, Object>> execute(Map<String, Object> inParams) {
        //inParams 是动作流的请求入参的数据对象
        //封装action返回值
        String  errStr = "相关请求中,存在未归档的流程,请将关联流程归档后再提交本流程!";
        if (!"".equals(errStr)) {
            //报错,给出相应的提示
            return WeaResult.fail(errStr);
        } else {
            Map<String, Object> result = new HashMap<>();
            //放行,继续提交
            return WeaResult.success(result);
        }
    }
}

二、dubbo配置操作说明

1、代码打包成jar上传到二开服务中心

(- 不懂请看 jar包部署说明)

2、登录【e-code 监控管理平台】> 后端监控 > 部署jar > 配置文件编辑 >  选择二开服【weaver-secondev-service】> 查询 > 添加一下信息
 <dubbo:service ref="actionTestDemo" -- 实现类bean名称
    interface="com.weaver.esb.api.rpc.EsbServerlessRpcRemoteInterface"  -- 固定不能改
    group="actionTestDemo" -- 区分不同服务的唯一标识
    version ="esb_1.0"/> -- 版本号,可选,如果此处填了则动作流也必须配置

    最后按Ctrl+S 保存(是不是很神奇?哈哈哈总部脑回路)


3、重启【weaver-secondev-service】二开服务
4、配置ESB动作流
操作路径:流程引擎 > 需要配置的流程 > 流程设置 > 选择需要触发的入口 > 动作流 > 自定义动作流 > 新增动作流(图一)
 > 添加动作 > 内置操作 > 代码 > serverless/Action (图二:填入发布服务时对应的分组标识(group)和版本号(version)如果没有版本号就不用填))
 > 配置输入参数(决定了action中inParams的参数对象)(图三)
 > 配置输出参数(和action中最后返回的WeaResult.fail或者WeaResult.success返回参数名对应)(图四)
在结合当前业务配置其他的动作流信息 

图一:
图二:
图三:
图四:

如何获取流程或者动作流传入的参数?
==========个人建议··action写法(不想学的可以看后面,总部提供的方法)  代码开始================
//.流程action配置动作流的时候
//请求参数 >参数标识:datas > 文本类型 > 动态赋值 > 选择【表单数据或者表单字段】整个数据对象传输,然后你想获取那个字段的值就获取那个字段的值
//PS :建议按需封装你的参数对象,不然字段太多··可能有性能问题

//获取datas对象
String datasTxt=String.valueOf(inParams.get("datas"));
//动作流别的参数对象
String otherKey=String.valueOf(inParams.get("otherKey"));
//因为是字符串格式的json,需要替换成正常的对象
datasTxt=datasTxt.replace("/","");
//转成json对象或者map对象
JSONObject data= JSONObject.parseObject(datasTxt);
//获取字段ID为976161636015357957的值
System.out.println(data.getString("976161636015357957"));

==========个人建议··action写法  代码结束==========


如何通过rpc获取流程的信息和数据(总部提供的方法)?

1、注解定义流程服务提供的rpc服务名称
@RpcReference(group = "workflow")
WfcFormRest wfcFormRest;

2、注解定义流程服务提供的获取流程数据的rest对象
@RpcReference
WfcFormDataRest wfcFormDataRest;

3、通过 wfcFormRest.getFormFieldByWfId(workflowId,用户ID)方法获取流程字段信息对象
List<WfFormFieldEntity> formFieldList = wfcFormRest.getFormFieldByWfId(Long.parseLong(workflowId), new HashMap<>(), Long.parseLong(employId));
for (WfFormFieldEntity entity : formFieldList) {
   //你的代码逻辑
}

4、通过 wfcFormDataRest.getFormFieldValue(requestId, List(字段ID集合), 用户ID);获取相关流程请求的队友字段数据数据
List<Long> fieldList = new ArrayList<>();
//你要获取的字段ID集合
fieldList.add(fieldid);
List<FormDataDetail> formFieldValue = wfcFormDataRest.getFormFieldValue(Long.parseLong(requestId), fieldList, Long.parseLong(employId));
List<FormDataOption> dataOptions = formFieldValue.get(0).getDataOptions();
//最终获取到的值
String xxValue = "";
for (FormDataOption option : dataOptions) {
    xxValue += "," + option.getOptionId();
}

操作代码案列

package com.weaver.seconddev.broadsync.action;

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
import com.weaver.common.base.entity.result.WeaResult;
import com.weaver.common.form.data.detail.FormDataDetail;
import com.weaver.common.form.data.option.FormDataOption;
import com.weaver.ebuilder.datasource.api.entity.ExecuteSqlEntity;
import com.weaver.ebuilder.datasource.api.enums.SourceType;
import com.weaver.ebuilder.datasource.api.service.DataSetService;
import com.weaver.esb.api.rpc.EsbServerlessRpcRemoteInterface;
import com.weaver.framework.rpc.annotation.RpcReference;
import com.weaver.workflow.common.entity.formdef.WfFormFieldEntity;
import com.weaver.workflow.core.api.rest.form.WfcFormRest;
import com.weaver.workflow.core.api.rest.publicapi.WfcFormDataRest;
import lombok.extern.slf4j.Slf4j;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

////rpc 实例bean名称,对应dubbo.xm! 服务提供者配置中的ref
@Service("actionTestDemo")
@Slf4j
public class WfTestAction implements EsbServerlessRpcRemoteInterface {

    //流程服务提供的rpc服务名称
    @RpcReference(group = "workflow")
    WfcFormRest wfcFormRest;

    //流程服务提供的获取流程数据的rest对象
    @RpcReference
    WfcFormDataRest wfcFormDataRest;

    //数据库操作对象
    @Autowired
    private DataSetService dataSetService;

    @Override
    public WeaResult<Map<String, Object>> execute(Map<String, Object> inParams) {
        log.info("====动作流配置入参对象==>{}", JSON.toJSONString(inParams));


        //======================个人建议··action写法(不想学的可以看后面,总部提供的方法) 代码开始======================
        //.流程action配置动作流的时候
        //请求参数 >参数标识:datas > 文本类型 > 动态赋值 > 选择【表单数据或者表单字段】整个数据对象传输,然后你想获取那个字段的值就获取那个字段的值
        //PS :建议按需封装你的参数对象,不然字段太多··可能有性能问题

        //获取datas对象
        String datasTxt=String.valueOf(inParams.get("datas"));
        //因为是字符串格式的json,需要替换成正常的对象
        datasTxt=datasTxt.replace("/","");
        //转成json对象或者map对象
        JSONObject data= JSONObject.parseObject(datasTxt);
        //获取字段ID为976161636015357957的值
        System.out.println(data.getString("976161636015357957"));

        //======================个人建议··action写法 代码结束======================


        //下面都是esb动作流入参配置获取对应参数值
        String workflowId = String.valueOf(inParams.get("workflowId"));
        String requestId = String.valueOf(inParams.get("requestId"));
        String employId = String.valueOf(inParams.get("employId"));

        //你的流程中字段数据库字段名称
        String xgqqField = "xxxField";

        //查询字段信息获取字段ID
        long fieldid = -1l;
        List<WfFormFieldEntity> formFieldList = wfcFormRest.getFormFieldByWfId(Long.parseLong(workflowId), new HashMap<>(), Long.parseLong(employId));
        for (WfFormFieldEntity entity : formFieldList) {
            String dataKey = String.valueOf(entity.getOtherParams().get("dataKey"));
            if (dataKey.equals(xgqqField)) {
                fieldid = entity.getId();
            }
        }
        log.info("你的字段id==>{}", fieldid);

        //2、获取相关流程请求的队友字段数据数据
        List<Long> fieldList = new ArrayList<>();
        fieldList.add(fieldid);
        List<FormDataDetail> formFieldValue = wfcFormDataRest.getFormFieldValue(Long.parseLong(requestId), fieldList, Long.parseLong(employId));
        List<FormDataOption> dataOptions = formFieldValue.get(0).getDataOptions();
        log.info("formFieldValue==>{}", JSON.toJSONString(formFieldValue));
        String xgqqValue = "";
        for (FormDataOption option : dataOptions) {
            xgqqValue += "," + option.getOptionId();
        }

        if (!"".equals(xgqqValue))
            xgqqValue = xgqqValue.substring(1);

        log.info("xgqqValue==>{}", xgqqValue);

        //3、查询流程是否归档
        String sql = "select requestid,requestname from wfc_requestbase where flowstatus != 4 and requestid in (" + xgqqValue + ")";
        log.info("sql==>{}", sql);
        ExecuteSqlEntity executeSqlEntity = new ExecuteSqlEntity();
        executeSqlEntity.setSql(cn.hutool.core.codec.Base64.encode(sql));
        //groupid,可以访问  E10地址/api/datasource/ds/group?sourceType=LOGIC 获取
        executeSqlEntity.setGroupId("weaver-workflow-report-serviceworkflowreport");
        executeSqlEntity.setSourceType(SourceType.LOGIC);
        Map<String, Object> datas = dataSetService.executeSql(executeSqlEntity);

        log.info("datas==>{}", JSON.toJSONString(datas));

        String errStr = "";
        if (String.valueOf(datas.get("status")).equals("OK")) {
            List<Map<String, Object>> results = (List<Map<String, Object>>) datas.get("records");

            for (Map<String, Object> result : results) {
                errStr += "," + result.get("requestname");
            }
        }


        //4、封装返回值
        if (!"".equals(errStr)) {
            errStr = errStr.substring(1);
            errStr = "相关请求中,存在未归档的流程【" + errStr + "】,请将关联流程归档后再提交本流程!";
            //报错,给出相应的提示
            return WeaResult.fail(errStr);
        } else {
            Map<String, Object> result = new HashMap<>();
            //放行,继续提交
            return WeaResult.success(result);
        }
    }
}