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

涎涎原创约 1611 字大约 5 分钟...KingdeeKingdee

85-金蝶云苍穹单据转换插件样例初使用.mdopen in new window

注意

本博文仅供学术研究和交流参考，严禁将其用于商业用途。如因违规使用产生的任何法律问题，使用者需自行负责。

前置条件

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

测试编码

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);
	}
}

注册插件

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

测试

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

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

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

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

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

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

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

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

分割线

相关信息

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

上次编辑于:
贡献者: 涎涎
0  字
评论
  • 按正序
  • 按倒序
  • 按热度
Powered by Waline v2.15.4
默认页脚
Copyright © 2024 涎涎