金蝶云苍穹单据转换插件样例初使用

作者: 涎涎 | 来源:发表于2020-08-22 00:02 被阅读0次

金蝶云苍穹单据转换插件样例初使用
金蝶云苍穹单据转换插件beforeBuildRowConditi
金蝶云苍穹单据转换插件AfterBuildQueryPareme
金蝶云苍穹标准单据列表插件billListHyperLinkCl
金蝶云苍穹标准单据列表插件beforeCreateListCol
金蝶云苍穹单据操作插件onAddValidators事件案例
金蝶云苍穹单据列表插件billClosedCallBack事件案
金蝶云苍穹插件开发之值改变事件
金蝶云苍穹基础资料的简单介绍
金蝶云苍穹树形单据体创建及插件的简单使用

前置条件

必须有两张单据，例我做了两张单据采购申请单和采购订单

测试编码

package kd.bos.billzh.plugin;

import kd.bos.entity.BillEntityType;
import kd.bos.entity.botp.ConvertOpType;
import kd.bos.entity.botp.ConvertRuleElement;
import kd.bos.entity.botp.plugin.AbstractConvertPlugIn;
import kd.bos.entity.botp.plugin.args.AfterBuildQueryParemeterEventArgs;
import kd.bos.entity.botp.plugin.args.AfterConvertEventArgs;
import kd.bos.entity.botp.plugin.args.AfterCreateLinkEventArgs;
import kd.bos.entity.botp.plugin.args.AfterCreateTargetEventArgs;
import kd.bos.entity.botp.plugin.args.AfterFieldMappingEventArgs;
import kd.bos.entity.botp.plugin.args.AfterGetSourceDataEventArgs;
import kd.bos.entity.botp.plugin.args.BeforeBuildGroupModeEventArgs;
import kd.bos.entity.botp.plugin.args.BeforeBuildRowConditionEventArgs;
import kd.bos.entity.botp.plugin.args.BeforeCreateLinkEventArgs;
import kd.bos.entity.botp.plugin.args.BeforeCreateTargetEventArgs;
import kd.bos.entity.botp.plugin.args.BeforeGetSourceDataEventArgs;
import kd.bos.entity.botp.plugin.args.InitVariableEventArgs;

/**
 * <p>Title: </p>
 * <p>
 *    Description:
 *    演示单据转换插件事件的触发时机
 *    试验成功
 * </p>
 * <p>Copyright: Copyright (c) 2020</p>
 * @author xx
 * @date 2020年3月18日
 * @version 1.0
 */
public class BillConvertEventSample extends AbstractConvertPlugIn {
    /**
     * void</br>
     * 
     * <p>Title: </p>
     * <p>
     *    Description:
     * 演示如何获取上下文信息
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @return the bare_field_name
     * see_to_overridden
     * @version 1.0
     */
    private void getContext(){
        // 源单主实体
        BillEntityType srcMainType = this.getSrcMainType();
        // 目标单主实体
        BillEntityType tgtMainType = this.getTgtMainType();
        // 转换规则
        ConvertRuleElement rule = this.getRule();
        // 转换方式：下推、选单
        ConvertOpType opType = this.getOpType();
    }
    
    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 初始化变量事件
     * 获取上下文信息，构建一些必须的变量
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#initVariable(kd.bos.entity.botp.plugin.args.InitVariableEventArgs)
     * @version 1.0
     */
    @Override
    public void initVariable(InitVariableEventArgs e) {
        this.printEventInfo("initVariable", "");
    }
    
    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 构建取数参数后事件
     * 添加额外的字段、过滤条件
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#afterBuildQueryParemeter(kd.bos.entity.botp.plugin.args.AfterBuildQueryParemeterEventArgs)
     * @version 1.0
     */
    @Override
    public void afterBuildQueryParemeter(AfterBuildQueryParemeterEventArgs e) {
        this.printEventInfo("afterBuildQueryParemeter", "");
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 编译数据筛选条件前事件
     * 设置忽略规则原生的条件，改用插件定制条件，或者在规则条件基础上，追加定制条件
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#beforeBuildRowCondition(kd.bos.entity.botp.plugin.args.BeforeBuildRowConditionEventArgs)
     * @version 1.0
     */
    @Override
    public void beforeBuildRowCondition(BeforeBuildRowConditionEventArgs e) {
        this.printEventInfo("beforeBuildRowCondition", "");
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 取源单数据前事件
     * 修改取数语句、取数条件
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#beforeGetSourceData(kd.bos.entity.botp.plugin.args.BeforeGetSourceDataEventArgs)
     * @version 1.0
     */
    @Override
    public void beforeGetSourceData(BeforeGetSourceDataEventArgs e) {
        this.printEventInfo("beforeGetSourceData", "");
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 取源单数据后事件
     * 根据源单数据，获取其他定制的引用数据；也可以替换系统自动获取到的数据
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#afterGetSourceData(kd.bos.entity.botp.plugin.args.AfterGetSourceDataEventArgs)
     * @version 1.0
     */
    @Override
    public void afterGetSourceData(AfterGetSourceDataEventArgs e) {
        this.printEventInfo("afterGetSourceData", "");
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 构建分单、行合并模式之前事件
     * 调整分单、合并策略及依赖的字段
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#beforeBuildGroupMode(kd.bos.entity.botp.plugin.args.BeforeBuildGroupModeEventArgs)
     * @version 1.0
     */
    @Override
    public void beforeBuildGroupMode(BeforeBuildGroupModeEventArgs e) {
        this.printEventInfo("beforeBuildGroupMode", "");
    }
    
    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 初始化创建目标单据数据包前事件
     * 这个事件，只在选单时触发：
     * 选单时，需要基于现有的目标单数据包，进行追加处理；
     * 插件可以在此事件，获取到现有的目标单数据包，提前进行定制处理
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#beforeCreateTarget(kd.bos.entity.botp.plugin.args.BeforeCreateTargetEventArgs)
     * @version 1.0
     */
    @Override
    public void beforeCreateTarget(BeforeCreateTargetEventArgs e) {
        this.printEventInfo("beforeCreateTarget", "");
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 创建目标单据数据包后事件
     * 这个事件，只在下推时触发，把根据分单规则创建好的目标单，传递给插件
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#afterCreateTarget(kd.bos.entity.botp.plugin.args.AfterCreateTargetEventArgs)
     * @version 1.0
     */
    @Override
    public void afterCreateTarget(AfterCreateTargetEventArgs e) {
        this.printEventInfo("afterCreateTarget", "");
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 目标字段赋值完毕后事件
     * 插件可以在此基础上，继续填写目标字段值
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#afterFieldMapping(kd.bos.entity.botp.plugin.args.AfterFieldMappingEventArgs)
     * @version 1.0
     */
    @Override
    public void afterFieldMapping(AfterFieldMappingEventArgs e) {
        this.printEventInfo("afterFieldMapping", "");
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 记录关联关系前事件
     * 取消记录关联关系
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#beforeCreateLink(kd.bos.entity.botp.plugin.args.BeforeCreateLinkEventArgs)
     * @version 1.0
     */
    @Override
    public void beforeCreateLink(BeforeCreateLinkEventArgs e) {
        this.printEventInfo("beforeCreateLink", "");
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 记录关联关系后事件
     * 根据系统自动记录的关联关系，进行相关数据的同步携带，如携带其他子单据体数据
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#afterCreateLink(kd.bos.entity.botp.plugin.args.AfterCreateLinkEventArgs)
     * @version 1.0
     */
    @Override
    public void afterCreateLink(AfterCreateLinkEventArgs e) {
        this.printEventInfo("afterCreateLink", "");
    }

    /**
     * <p>Title: </p>
     * <p>
     *    Description:
     * 单据转换后事件，最后执行 
     * 插件可以在这个事件中，对生成的目标单数据，进行最后的修改
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @param e
     * @see kd.bos.entity.botp.plugin.IConvertPlugIn#afterConvert(kd.bos.entity.botp.plugin.args.AfterConvertEventArgs)
     * @version 1.0
     */
    @Override
    public void afterConvert(AfterConvertEventArgs e) {
        this.printEventInfo("afterConvert", "");
    }

    /**
     * void</br>
     * 
     * <p>Title: </p>
     * <p>
     *    Description:
     * </p>
     * <p>Copyright: Copyright (c) 2020</p>
     * @author xx
     * @date 2020年3月18日
     * @param param the bare_field_name
     * @return the bare_field_name
     * @param eventName
     * @param argString
     * see_to_overridden
     * @version 1.0
     */
    private void printEventInfo(String eventName, String argString){
        String msg = String.format("%s : %s", eventName, argString);
        System.out.println(msg);
    }
}

注册插件

流程服务云 --> 业务流服务 --> 转换路线 --> 选择后双击进入

测试

进入采购申请单预览添加数据后保存提交审核

进入流程审批

刷新首页点击自己头像，咦，发现没有消息？？？

不要慌，进入流程服务云里的消息中心看看

如下图所示，还是没有看到自己所提交的单据，我现在很慌。。。。由于一直没有找到原因。。。故秉着世上无难事，只要肯放弃的原则，我完美的回避了这一问题。。。。

找到业务控制将其工作流关闭

在代码里的初始化方法打个断点

重新预览添加数据后保存提交然后下推

如下图所示，可以看到进入断点了。。那么此时足以证明插件注册成功，可以开始写代码了。。。。

以上就是我关于 金蝶云苍穹单据转换插件样例初使用 知识点整理与总结的全部内容，希望对你有帮助。。。。。。。

分割线

金蝶云苍穹单据转换插件样例初使用
前置条件必须有两张单据，例我做了两张单据采购申请单和采购订单测试编码注册插件流程服务云 --> 业务...
金蝶云苍穹单据转换插件beforeBuildRowConditi
前置条件两张单据,例笔者就做了两张单据分别为采购申请单和采购订单编码测试注册插件预览测试以上就是我关于...
金蝶云苍穹单据转换插件AfterBuildQueryPareme
前置条件要有目标单与源单，例笔者有做一个采购申请单与采购订单为目标单添加字段在采购订单的单据头中添加一个文本...
金蝶云苍穹标准单据列表插件billListHyperLinkCl
新建带组织模板单据设置表名后保存在表单的基本信息里面添加文本字段将其标识更改为 textfield1 将其名称...
金蝶云苍穹标准单据列表插件beforeCreateListCol
新建带组织模板单据在表单界面设置好表名之后管理员账号登录授权预览之后添加数据后保存不提交，最好添加多条数据在...
金蝶云苍穹单据操作插件onAddValidators事件案例
新建模板单据设置单据表名 t_bill_test1 新建高级面板，添加单据体，并设置分录操作代码，添加日期控件 ...
金蝶云苍穹单据列表插件billClosedCallBack事件案
新建带组织模板的单据添一个文本字段在基本信息里，将其名称更改为文本1将其标识更改为textfield1 管理员账...
金蝶云苍穹插件开发之值改变事件
新建单据新建步骤请参考金蝶云苍穹如何新建云、应用、页面？[https://www.jianshu.com/p/e...
金蝶云苍穹基础资料的简单介绍
产品介绍基础资料实际上是一种特殊的单据金蝶云苍穹基础资料主要为以下几点：基于单据，继承了动态表单、单据的全部...
金蝶云苍穹树形单据体创建及插件的简单使用
树形单据体介绍单据体，用来在界面上显示、录入多行多列数据。树形单据体与单据体的不同之处在于，树形单据体中的数据...