一，单据转换概要

1.单据转换，是指把上游所选单据，按照转换规则，自动生成下游单据数据包的过程；并且不对下游单据进行任何操作处理。

2.单据转换插件，能够介入到单据转换的各个关键时刻，对转换行为进行控制，从而调整所生成的下游数据包。

3.单据转换按照发起方不同，可分为下推、选单；

4.下推是指在上游单据列表把所选单据或维护页面点击下推操作，生成下游单据数据包，并展示出来。

5.选单是指在下游单据新增界面，弹出上游单据列表，选择源单返回，然后根据转换规则把源单数据填写到下游单据新增界面上。

6.选单实际上分为两个独立的过程，一个是选单前过程，根据转换规则，生成源单数据筛选条件，传给源单列表。因此源单列表上显示的，都是允许下推的数据；另外一个就是选单过程，把用户选择返回的源单数据，迁移到目标单据上。

6.下推与选单，采用相同单据转换规则，进行数据迁移；也采用相同的单据转换插件，但触发的事件略有差异，编写单据转换插件时，需要兼顾这些差异。

二，单据转换插件编写

1. 需要引用组件  

  1)Kingdee.BOS.dll

  2)Kingdee.BOS.Core.dll,

  3)Kingdee.BOS.Contracts.dll

  4)Kingdee.BOS.DataEntity.dll

  5)Kingdee.BOS.BusinessEntity.dll

2.需要使用的命名空间

  1)Kingdee.BOS.Core.Metadata.ConvertElement.PlugIn

  2)Kingdee.BOS.Core.Metadata.ConvertElement.PlugIn.Args

3.必须继承AbstractConvertPlugIn类

三，单据转换插件注册

1. 注册在单据转换规则中的插件策略中，如下图

四，单据转换插件包含的属性

1.Context 上下文，包含用户跟账套等信息

2.OperationNumber,操作编码，如下推，选单操作等，值分别为Push,Draw

3.OperationResult,单据转换结果信息,可以在插件中放一下验证信息，并指定在哪里显示，实际作用不大，

提示消息参考帖：https://vip.kingdee.com/article/157801279824699648

4.Option，调用下推引擎时，额外传递的一些参数字典。如是否整单下推、是否需要校验下游单据新增权限等；

单据转换插件可以到此参数字典中，获取自定义参数。

五，单据转换插件执行顺序

参考帖子：https://vip.kingdee.com/questions/7428/answers/10922