1 功能介绍

BOTP（Business Object Transform Platform ）就是基于业务对象的数据转换平台，用于处理不同单据之间的数据转换。主要功能点包括：

• 关联关系建立与维护；

• 转换路线与转换规则；

• 反写及取消反写。

转换规则：

本篇知识主要讲解BOTP转换规则/转换路线。BOTP转换规则/转换路线可以用于配置上游单据在满足一定条件的情况下，将上游单据字段值自动按一定规律映射到下游单据的字段中，或将上游单据字段值携带到下游单据的字段中，从而实现源单到目标单的数据自动下推，减少人工重复填录成本。

2 应用场景

BOTP转换规则/转换路线可以用于如下需求的场景中：

• 同一个转换路线，支持多规则，应用于多方式下推；

• 转换规则支持扩展，支持继承，满足扩展需求；

• 指定需要跟踪、反写的实体，即关联主实体，支持数据反写需求；

• 指定两单单据类型之间的映射关系，应用于指定单据实体间的数据转换；

• 指定各个目标字段如何取值，应用于复杂数据计算下推的情况；

• 设置分单合并策略，应用于有子单据体数据合并的场景；

• 设置业务规则，对转换后的目标单字段值进一步处理，提供转换后数据的业务规则处理能力。

3 系统路径

【开发服务云】→【单据转换开发】→【转换路线】

4 主要操作

步骤一：管理转换规则

修改转换路线，打开转换规则配置界面，显示出转换路线下全部的转换规则。

注意：转换规则配置前，需要进行单据关联配置，请参考单据关联配置。

步骤二：基本信息维护

• 规则启用条件：源单和目标单之间支持多个转换规则，每个规则适用于特定的业务分类，可以通过规则启用条件来自动匹配这些业务分类；

• 启用：新建规则，默认为禁用状态。只有启用的规则才会在运行时被使用；

• 默认选用此规则：一条转换路线支持多条转换规则，只允许有一条规则勾上此选项，作为默认规则；

注意：转换规则关闭运行时可见参数，后台下推操作配置仍可选到该转换规则。

步骤三：关联实体维护

系统会在目标单关联实体的下级关联子表中，记录源单关联实体行内码等，以支持后续业务追踪、反写。

步骤四：单据类型映射维护

• 配置源单单据类型，与目标单单据类型之间的映射关系；

• 支持实时测试源单、目标单各种单据类型的映射结果；
  

• 源单与目标单类型之间，有多种下推类型。

步骤五：字段映射维护

字段映射主要包括以下可配置项

• 取值：用于配置目标单各字段如何从源单取值；

• 合并选项：多条源单数据行合并生成目标单数据行时，具体字段如何合并取值；

• 过滤选项：见下表；

• 追加时过滤选项：见下表。

步骤六：附件面板映射

 转换规则提供附件面板映射页签，支持对目标单附件面板配置源单上对应的附件面板。

附件面板映射支持“合并”与“取第一行”两种模式：

• 合并模式将上游单关联的所有附件信息携带到下游单对应的附件面板上；

• 取第一行模式将上游单第一张单关联的所有附件信息携带到下游单对应的附件面板上。

步骤七：分单合并

转换规则提供多种分单合并规则，用于多张源单或目标单的合并数据转换，包括：

• 分单策略：决定所选源单会生成多少张目标单；

• 单据体合并策略：分好单以后，同一分组下的源单分录行，如何生成目标单分录行；

• 子单据体合并策略：见下表。
  

步骤八：数据范围维护

• 设置数据条件，限制允许转换的源单数据行；

• 只能使用源单单据头及关联实体上的字段配置数据条件；

• 实际单据转换时，不符合条件的数据会转换失败，并给出提示；

• 条件描述：手工录入更加人性化的条件描述，作为转换失败时的提示内容；

• 典型数据范围：

  已审核才允许下推；

  已关联反写完的数据行不允许再次下推。

• 启用高级条件

  支持设置数据范围方案，每个方案支持设置多个条件，每个方案支持设置条件描述，作为数据范围条件校验提示内容。

  每个数据范围方案在查询数据时取交集，即同时满足所有数据范围方案的数据才允许执行单据转换携带。

步骤九：业务规则维护

• 业务规则可以在源单数据携带完毕后，基于目标单已经填好的字段，对其他字段值进一步计算加工；

• 业务规则的配置方法与设计器表单中的业务规则一致；

• 常见场景：

  下推剩余数量，根据剩余数量重算金额；

  源单行合并下推后，金额已经合计，根据数量倒算单价、含税单价。

步骤十：插件

• 单据转换支持插件；

• 插件类型包括Java代码插件、JScript脚本插件；

• 插件基类：AbstractConvertPlugIn。

步骤十一：高级选项

提供转换规则参数配置功能，参数内容包括：

• 单据转换时启用网控：单据转换启用网控后，下推时，不允许对源单再做下推或其他操作（如反审核），直至下游单退出时，才释放上游单网控。

• 不允许重复下推：下推时生成并保存了目标单后，不允许再次使用此规则下推到这种单据（可下推到其他单据），此参数仅对下推操作有效。

• 生成报告：生成下推监控报告，仅在单据转换出现异常时，通过监控报告排查问题。

• 条件校验保留字段值首尾空格：转换规则启用条件、字段映射（按条件取值、计算公式）、数据范围、业务规则条件等，配置的源单字段取值首尾存在空格，在执行单据转换时是否自动去除空格，开启参数，在执行转换时将保留空格。