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



