转换线路

说明：

配置源单和目标单如何进行数据转换，源单字段值如何携带到目标单据对应的字段上

作用：

同一个转换路线，支持多规则

转换规则支持扩展，支持继承

可以指定需要跟踪、反写的实体，即关联主实体

可以指定两单单据类型之间的映射关系

可以指定各个目标字段如何取值

可以设置分单合并策略

可以设置业务规则，对转换后的目标单字段值进一步处理

操作：

• 入口【开发服务云】-【业务流开发】-【转换路线】

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

• 新建：创建一个空白新规则

• 扩展：系统预置的原厂规则，不允许被直接修改，必须先扩展，然后在扩展规则上改动。运行时，系统会自动把扩展规则上所做的改动，覆盖到原厂规则上运行

• 删除：不允许删除已启用的规则，不允许删除原厂规则

• 复制：把源规则复制为一条独立的新规则，复制完之后，对源规则做的改动，不会影响复制后的规则

• 继承：从源规则继承出一条独立的新规则，继承完之后，对源规则的改动，会同步更新到继承的规则

• 保存全部：把所有的改动保存到数据库

• 反写：打开反写列表，自动筛选出源单、目标单之间的反写规则

基本信息维护

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

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

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

• 运行时可见：关闭此选项，在下推界面中，就选不到此规则。可以把只在后台使用的规则，关闭此选项

关联实体维护

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

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

• 源单选单视图：在目标单上选单时，打开的源单列表视图。例如源单有物料明细、付款计划两个单据体，某些转换路线，需要打开付款计划列表视图，而不是默认的物料明细列表视图

单据类型映射维护

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

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

• 仅指定类型：源单类型，仅能下推指定的目标单类型

• 不限类型：源单类型，可以下推任意目标单类型

• 不允许下推：源单类型，不允许下推到目标单

• 禁止指定类型：除了不允许下推生成特定类型之外，其他类型都可以下推

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

字段映射维护

• 取值选项：配置目标单各字段如何从源单取值，可选项包括源单字段、计算公式、常量、按条件取值

• 源单字段：直接取源单字段值，字段类型必须一致

• 计算公式：使用源单字段、BOTP函数、常量，配置出计算公式取值

• 常量：适用于下拉列表和基础资料字段，直接设置常量值

• 按条件取值：可以定义多条取值规则，按不同条件，设置不同的取值计算公式

• 合并选项：多条源单数据行合并生成目标单数据行时，具体字段如何合并取值，包括取第一行、合计、最大、最小、平均、计数、拼接

• 如果数据行一对一生成，则合并选项不起作用

• 取第一行：只把源单第一条数据行计算出的值赋给目标单；（默认选项）

• 合计：把所有源单数据行计算出的值，合计后赋给目标单字段

• 最大、最小：取所有源单数据行中，最大或最小值

• 平均：合计后求平均

• 计数：取源单行数

• 拼接：把从所有源单数据行取出的字符串，用逗号分割，拼接在一起

• 过滤选项：用于选单时，根据目标单已填写的字段值，筛选源单

• 追加时过滤选项：同一张目标单支持多次选单，第一次选单完毕，再次打开选单时，根据上次选单返回的字段值，筛选源单，以确保再次选单，数据与第一批数据不冲突

分单合并

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

• 一对一：一张源单，生成一张目标单

• 多对一：把所有源单，合并到一张目标单

• 按规则分组合并：把所有源单行打乱，按分单字段值分组，每组生成一张目标单

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

• 一对一：一条源单分录行，生成一条目标单分录行

• 多对一：所有源单分录行，合并为一条目标单分录行

• 按规则分组合并：按合并字段值分组，每组生成一条目标单行

数据范围维护

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

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

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

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

• 典型数据范围：

  已审核才允许下推

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

业务规则维护

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

• 常见场景：

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

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

插件维护

• 单据转换支持插件

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

• 插件基类：AbstractConvertPlugIn