实践案例 | 单据转换中“获取单据字段值”函数妙用

客户A为大型贵金属冶炼企业，在生成财务应收单时需要获取物料的实际销售单价，以便后续对账和审计，但是上、下游单据都是只有物料的含税单价，没有实际销售单价信息。

客户希望通过确定的应收“金额”、物料信息，计算得出物料的“实际销售单价”。考虑到暂估应收单与财务应收单会通过苍穹BOTP（Business Object Transform Platform）进行关联，同时BOTP能够支持单据对象间转换，包括转换规则和反写规则等，BOTP便成为需求兑现的关键途径。

但如果需要使用苍穹标准产品BOTP处理这个场景，仔细考虑兑现方案后，仍然会存在以下问题：

（1）财务应收单上没有物料重量信息，无法直接通过计算公式计算。

（2）如果在财务应收单上增加物料重量信息，则需要额外的二次开发工作。

经过分析，财务应收单上的“金额”数据，是在暂估应收单生成财务应收单时，通过数量、实际单价及汇率自动计算得出的。有了“金额”数据作为基础，在财务应收单生成时，我们也就能够实现自动生成“销售单价”，计算公式为：销售单价=金额/物料净重。

对于单据转换过程中，目标单上字段之间的运算，常用的方式是通过配置单据转换业务规则实现。接下来为大家介绍详细操作步骤，实现财务应收单生成时，同步转换得到“实际销售单价“。

路径：【开发服务云】→【单据转换开发】→【转换规则】。

在转换规则列表中查询“暂估应收下推财务应收”的转换规则，点击规则进入规则编辑界面，左侧选中该规则执行扩展操作，进入扩展规则编辑界面。

编辑扩展规则

我们可以通过函数来实现，使用通用函数中的“获取单据字段值（GetFieldValue）”函数。为方便理解，这里对此函数做一个说明：BOTP转换规则，可以使用GetFieldValue函数，取任意单据上的字段值。

（1）函数格式：

GetFieldValue(entityNumber, readProp, filterProp1, filterValue1)

（2）返回值：Object

（3）函数说明：

• 函数描述：根据传入的取值条件，读取单据字段值 

• 函数格式：GetFieldValue(entityNumber, readProp, filterProp1, filterValue1) 

• 函数参数：entityNumber, 读取单据; re