电脑桌面
添加蚂蚁七词文库到电脑桌面
安装后可以在桌面快捷访问

BOTP转换规则

来源:金蝶云社区作者:金蝶2024-09-2323

BOTP转换规则

变更记录


产品版本

更新内容更新日期
V7.0

关联实体增加布局配置说明

数据范围增加高级条件配置说明

增加高级选项配置说明

2024年10月




1 功能介绍

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

  • 关联关系建立与维护;

  • 转换路线与转换规则;

  • 反写及取消反写。


转换规则

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

2 应用场景

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

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

  • 转换规则支持扩展,支持继承,满足扩展需求;

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

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

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

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

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

3 系统路径

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

4 主要操作

步骤一:管理转换规则

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

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

主要按钮说明
新建创建一个空白新规则
扩展系统预置的原厂规则,不允许被直接修改,必须先扩展,然后在扩展规则上改动。运行时,系统会自动把扩展规则上所做的改动,覆盖到原厂规则上运行
删除不允许删除已启用的规则,不允许删除原厂规则
复制把源规则复制为一条独立的新规则,复制完之后,对源规则做的改动,不会影响复制后的规则
继承从源规则继承出一条独立的新规则,继承完之后,对源规则的改动,会同步更新到继承的规则
保存全部把所有的改动保存到数据库
反写打开反写列表,自动筛选出源单、目标单之间的反写规则



步骤二:基本信息维护

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

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

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

主要配置项说明
规则启用条件源单和目标单之间支持多个转换规则,每个规则适用于特定的业务分类,可以通过规则启用条件来自动匹配这些业务分类
启用新建规则时默认为禁用状态,只有启用的规则才会在运行时被使用
默认选用此规则一条转换路线支持多条转换规则,但只能有一条规则勾上此选项,作为默认规则
运行时可见用户在下推(push)时可以选择下推使用哪条规则。关闭此选项时,在下推时就选不到此规则;但是对于只在后台使用的规则,可以关闭此选项,并使用后台下推(pushandsave)代替下推,自动执行此规则。

运行时可见控制

运行时可见参数,同时控制了规则在下推、选单时可用。运行时可见控制参数,支持分别控制运行时下推、选单可见性。开启参数时,显示运行时选单可见参数,用于控制转换规则运行时选单是否可见;原有的运行时可见参数,则只控制下推时是否可见。
下推自动保存使用该转换规则下推时,是否自动保存目标单据;开启后,下推时生成并自动保存目标单据。


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





步骤三:关联实体维护

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

主要配置项说明
源单关联实体/目标单关联实体

关联实体,需要按照追踪反写的粒度要求,选择最明细的实体。如果要进行子单据体行级的追踪、反写,就必须选择子单据体作为关联实体。如果要进行单据体行级的追踪、反写,就必须选择单据体作为关联实体。如果只是要进行单据级的追踪、反写,就选择单据头作为关联实体

记录关联关系
只有配置记录关系,才能绑定关联的源单和目标单。开启记录关联关系是配置反写的必备条件
PC源单选单布局PC端在目标单上选单时,打开的源单列表布局。例如源单有物料明细、付款计划两个单据体,某些转换路线,需要打开付款计划列表视图,而不是默认的物料明细列表视图
移动端选单布局移动端选单操作,打开源单数据列表时,展示的源单布局。
PC端下推目标单布局PC端执行下推操作,打开目标单新增界面,展示的目标单布局。
移动端下推目标单布局移动端执行下推操作,打开目标单新增界面,展示的目标单布局。


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

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

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

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

下推类型说明
仅指定类型源单类型,仅能下推指定的目标单类型
不限类型源单类型,可以下推任意目标单类型
不允许下推源单类型,不允许下推到目标单
禁止指定类型除了不允许下推生成特定类型之外,其他类型都可以下推


步骤五:字段映射维护

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

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

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

  • 过滤选项:见下表;

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

配置项主要配置项说明
取值源单字段直接取源单字段值,字段类型必须一致
计算公式使用源单字段、BOTP函数、常量,配置计算公式
常量

BOTP转换规则

变更记录产品版本更新内容更新日期V7.0关联实体增加布局配置说明数据范围增加高级条件配置说明增加高级选项配置说明2024年10月1 功能介绍B...
点击下载文档文档为doc格式

声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益,可联系本站删除。

确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息
QQ群
  • 答案:my7c点击这里加入QQ群
支持邮箱
微信
  • 微信