学习目标

了解单据转换插件和反写插件的开发过程，以及掌握转换插件和反写插件基类各个事件的使用和适用场景。

内容简介

本单元将会学习单据转换插件的开发和反写插件的开发。

单据转换，能够把A单据的数据，根据转换规则，转换生成B单据。

单据转换过程，大概分为如下几个步骤：

读取源单到目标单之间的全部转换规则；
匹配转换规则的业务范围，确定适用于当前所选源单的转换规则；
提取转换规则上，字段映射页签及其他页签，使用到的源单字段；
根据源单内码，生成源单取数条件；
读取源单数据行：
只读取转换规则用到的源单字段；
如果源单是整单下推，则读取源单全部行；否则取源单所选行数据；
把单据头、单据体字段组合在一起，生成拉平后的源单数据行；
根据转换规则，数据范围的配置，对源单行数据，进行筛选，剔除不符合条件的行；
根据分单、分录行合并策略，对源单数据行进行分组；
根据分组后的源单数据行，生成目标单、目标单分录行；
逐行填写目标分录行、单据头字段值；
在目标单的关联子实体中，记录来源单据信息；
后续保存目标单时，会根据关联子实体中的来源单据信息，记录单据关联关系及反写；
如果没有在关联子实体中记录来源单据，则不记录单据关联关系，不能联查，也不能反写；
输出生成好的目标单数据包，完成单据转换

特别说明：单据转换，只是生成目标单数据包，并没有保存入库；

如上单据转换过程，会触发单据转换插件事件，允许插件干预。

系统预置了单据转换插件基类AbstractConvertPlugIn，实现了转换插件接口IConvertPlugin。

自定义单据转换插件，必须扩展插件基类AbstractConvertPlugIn，绑定到单据转换规则上：

事件	触发时机	适用场景
initVariable	初始化变量事件	用来增加一些必要的变量
afterBuildQueryParemeter	构建取数参数后事件	添加额外的字段、过滤条件
beforeBuildRowCondition	编译数据筛选条件前事件	取消或增加自定义过滤条件
beforeGetSourceData	取源单数据前事件	修改取数语句和取数条件
afterGetSourceData	取源单数据后事件	根据源单数据获取其他定制数据，或替换系统获取到的数据
beforeBuildGroupMode	构建分单、行合并模式之前事件	可更改分单合并策略及依赖字段
beforeCreateTarget	只在选单时触发	获取到现有的目标单数据包进行定制处理
afterCreateTarget	只在下推时触发
afterFieldMapping	目标字段赋值完毕后事件	对目标单字段值进行修订、计算、汇总等
beforeCreateLink	记录关联关系前事件	可取消记录关联关系
afterCreateLink	记录关联关系后事件	根据源单信息重新计算目标单据其它非转换携带字段的逻辑
afterConvert	单据转换完毕事件，最后执行	对生成的目标单据数据进行最后的调整

通过视频课程的方式介绍反写插件的用法和应用场景

主讲人：汪林

完成单据转换插件3个实现案例

参考资料

https://vip.kingdee.com/school/182222052055674112下载插件开发指南，参考单据转换插件及反写插件章节