学习目标

了解单据转换规则的应用场景
掌握单据转换规则的配置

应用场景

正如企业常见的采购业务活动，采购订单可以下推生成采购入库单，将采购订单的一些关键信息携带到下游单据采购入库单，确保上下游业务的一致性，这种关联生成是通过创建单据转换规则来实现。

单据转换规则的配置要点

为了记录上下游单据的关联关系，单据转换的下游单据需要配置【单据关联配置】。

以销售出库单为例，我们使用有权限的用户登录金蝶云星空集成开发平台/bos设计器，扩展销售出库单，如已扩展则直接打开销售出库单扩展，点击【编辑】→【批量编辑字段属性】，找到【表单属性】里面的【单据关联配置】，如图1所示。

图1

您需要重点关注以下字段：

单据体实体，指定单据的某个实体作为关联主实体，表示上游单据携带到此实体中，会记录与上游源单直接的关联关系，只能选到一个单据体实体。
源单类型、源单编码，无论是否设置关联表都会记录信息，这里设置的目的是用于显示上游的单据信息，自定义单据可以从左侧工具箱拖拽字段到单据体实体中，如图2所示。
图2
关联表名，指定单据体实体的同时要为该实体设置相关的关联表名，用于存储后台关联关系。长度26个字符以内。
控制字段，指定单据体实体中哪些字段作为控制字段。控制字段一般用于反写上游单据，当下推出现行合并时，控制字段会特殊处理关联关系记录，以便于反写时可以准确的找到来源行。

创建单据转换规则

接下来我们一起来配置单据转换规则，以销售订单下推销售出库单为例。

您在BOS设计器中，点击左上角的【文件】→【单据转换】，在弹出的单据转换主界面上面再点击【新建】，维护需要设置单据转换规则的源单和目标单，如图3所示。
图3
如果这两个单据之间已有单据转换规则的话，可以通过复制已有的单据转换规则再进行修改或者直接点击【添加】按钮，就会再弹出一行单据转换规则，如图4所示。
图4
注意：主界面有部分重要参数需要您掌握，如图5所示。
(1) 规则名称可以修改，唯一标识必须唯一，不能跟其他的单据转换规则重复，我们可以勾选随机产生唯一标识，也可以取消掉之后再手工维护。
(2) 【可见性】中如果把【运行时隐藏】勾选，这样前台源单下推是无法直接看到目标单，只能通过插件调用单据转换服务执行。同时【规则状态】勾选启动后再保存转换规则才能生效，勾选默认则我们在做下推选单的时候选到目标单或源单的时候会自动带出这个默认的单据转换规则。
(3) 【允许业务流程无连线转换】参数应用前台的业务流程设置，单据上的业务流程图的如果没有该单据转换规则的下游单据，默认是无法下推的，如果勾选此参数，则单据下推不受源单业务流程的控制。
(4) 【规则检查】，勾选则在保存转换规则时检查目标单的单据关联配置是否已设置。
(5) 转换类型，一般使用关联携带，表示要求记录关联关系（没有记录关联关系则无法上下查、全流程跟踪、反写，相当于我们这个单据转换只是把字段信息携带过去下游单据而且，两者就没有关联关系了）。
(6) 【下推启动条件】默认为空，当有多个转换规则时，可以通过启动条件配置，管控不同条件下启动不同规则，用户下推时就会自动过滤掉不符合条件的单据转换规则。
图5
关联主单据体。
和前面介绍的【单据关联配置】相关，可以自动点击自动获取，再去配置源单字段的映射，如图6所示。
图6
单据类型映射。
用于设置源单与目标单不同的单据类型的下推映射关系。当单据类型设置为空时，默认表示是全部，没有任何单据类型限制。
如图6里面的第1点，表示所有的销售订单都可以下推标准销售出库单；第2点中的"无”表示没有销售订单用来下推现销出库单；第3点则是单据类型为标准销售订单可以下推标准销售出库单。
图6
字段映射关系
(1) 字段映射关系是单据转换规则里面最基础的内容，我们要设置上游源单字段跟下游目标单字段的关联，实现将下游单据的值携带到下游单据上。一般是相同类型的字段才可以做字段映射，在本案例的销售出库单中，发货组织字段是出库单的主业务组织字段，所以这个字段建议映射，如果没有映射的话，您下推销售出库单时都会要求您去选择业务组织的，如图7所示。
图7
(2) 单据转换中的组织，货主，本位币，结算币别，物料，客户，基本单位，单位字段可以直接做映射关系关联，但是像【源单类型】、【源单编号】、【审核人】、【审核日期】、【作废人】、【作废日期】、【业务类型】等字段是不能直接映射的，如果我们点击了【自动匹配】，这些字段都会映射上，要注意给他们取消掉，如图8所示。
图8
(3) 另外，一些无法直接做字段映射的字段我们可以考虑做公式来处理，例如【业务类型】字段，它是一个下拉列表字段，我们可以直接加公式去取到它的枚举值，如图9，图10所示，我们可以把中间的处理选为自定义公式，直接维护枚举值（注意枚举值要加引号），这个下推的时候直接默认取到普通销售的业务类型。
图9
图10
(4) 数量字段也可以直接做映射选到上游的字段，但是如果我们有分批下推销售出库单的情况，那么直接取上游的数量字段就不太正确了，所以，我们也可以用公式的形式来写。例如库存基本数量，我们可以把处理类型设置为自定义公式，然后公式设置为：库存基本数量-累计出库数量（库存基本），如图11所示，同理我们可以去设置销售基本数量等其他的数量字段的映射。
图11
注意，字段映射只能同时映射一个单据体的信息，上游下游单据都是一样的，所以已经做了明细信息的映射那么就不能再映射收款计划、税务明细页签的字段了，如果时点击了自动匹配的，要注意把这些字段取消掉，如图12所示。
图12
分组策略
分组策略是当我们设置多张单据批量生成下游单据时，单据数据如何重新分组、分录行如何合并的规则。
(1) 一对一生成，1张源单对应生成1张目标单，单据不拆分且分录行不合并。
(2) 多对一生成，多张源单对应生成1张目标单，单据合成1张下游单据，所有分录行都填到此下游单据上，但是分录行不合并。
(3) 按规则分组合并生成，按单据分组依据决定下游单据拆分生成几张（如果为空表示不拆分，1张源单对应1张目标单），有分组依据字段不一样的源单单据就会拆分。
按单据体分录合并条件，决定每张目标单上哪些分录行进行合并（如果为空表示分录行不进行合并），有分录合并对应字段都一样的话就会合并成同一行的单据体。
注意：如果希望按物料的编码为依据合并分录行，添加条件时应选择【物料编码.编码】
图13
选单条件策略
分为附加条件和匹配条件两部分
(1) 新增条件匹配行可以设置源单字段跟常量值的匹配，如图14所示，表示只有单据状态是已审核，且单价要大于0的分录行才能下推销售出库单。
图14
(2) 附加条件我们可以比较自由的编辑单据转换的条件，如图15所示，用源单的销售基本数量跟累计出库数量（销售基本）做比较，必须前者大于后者才能够下推，否则就会报错。
图15
插件策略
单据转换从选择单据、指定单据类型、分组合并、过滤携带数据等整个转换过程都提供了插件干预方法，应对一些复杂的单据转换场景需求，可以通过二开插件实现。
表单服务策略
前面所说的字段映射都是使用源单的字段进行映射、自定义公式计算，而表单服务策略针对的是数据携带完毕后，基于下游单据目前的数据携带结果，配置计算服务，依据下游单据字段进行计算，更新下游单据的其他字段，类似于单据下推时执行的实体服务规则或值更新事件，比较常用的是【计算定义公式的值并填写到指定列】跟【根据数量关联的单位自动计算目标数量】。
(1) 目前系统中需要在表单服务策略再重新做计算的例如有金额和价税合计字段。一般情况下，我们金额字段不建议直接做字段映射携带，要根据下游单据的单价和数量字段重算出金额和价税合计的，如图16所示。
图16
(2) 还有一种情况为不同单位数量的换算，一般情况下我们数量都是只在字段映射里面去做自定义公式计算基本单位数量再来这里用基本数量来换算其他的单位数量的服务，如图17所示。
图17
至此，单据转换规则设置过程介绍完毕，启动流程后我们可以用新增的单据转换规则来做单据转换，如图18所示。
图18

通过本单元学习，相信您已经掌握单据转换规则的配置逻辑，我们也可以通过以下相关知识来学习巩固。

看一看，单据转换规则其实也不难

恭喜您！