实践案例 | 单据转换中“获取单据字段值”函数妙用
小编推荐
为方便对账和审计,客户在生成财务应收单时需要获取物料的实际销售单价,但上下游单据只有含税单价。本期实践案例通过配置单据转换业务规则,妙用“获取单据字段”函数,实现客户诉求,无需二开,强烈推荐!
案例撰稿人:李涛。
业务背景
客户A为大型贵金属冶炼企业,在生成财务应收单时需要获取物料的实际销售单价,以便后续对账和审计,但是上、下游单据都是只有物料的含税单价,没有实际销售单价信息。
客户希望通过确定的应收“金额”、物料信息,计算得出物料的“实际销售单价”。考虑到暂估应收单与财务应收单会通过苍穹BOTP(Business Object Transform Platform)进行关联,同时BOTP能够支持单据对象间转换,包括转换规则和反写规则等,BOTP便成为需求兑现的关键途径。
但如果需要使用苍穹标准产品BOTP处理这个场景,仔细考虑兑现方案后,仍然会存在以下问题:
(1)财务应收单上没有物料重量信息,无法直接通过计算公式计算。
(2)如果在财务应收单上增加物料重量信息,则需要额外的二次开发工作。
解决方案
经过分析,财务应收单上的“金额”数据,是在暂估应收单生成财务应收单时,通过数量、实际单价及汇率自动计算得出的。有了“金额”数据作为基础,在财务应收单生成时,我们也就能够实现自动生成“销售单价”,计算公式为:销售单价=金额/物料净重。
对于单据转换过程中,目标单上字段之间的运算,常用的方式是通过配置单据转换业务规则实现。接下来为大家介绍详细操作步骤,实现财务应收单生成时,同步转换得到“实际销售单价“。
1、扩展出厂转换规则
路径:【开发服务云】→【单据转换开发】→【转换规则】。
在转换规则列表中查询“暂估应收下推财务应收”的转换规则,点击规则进入规则编辑界面,左侧选中该规则执行扩展操作,进入扩展规则编辑界面。
编辑扩展规则
2、创建业务规则
选择【业务规则】页签,点击“增行”新增业务规则,选择服务类型为“计算定义公式的值并填写到指定列”,如下图所示:
创建业务规则
3、配置计算公式
公式设置为:销售单价=金额(本位币)/物料净重。
业务规则配置
这里发现目标单字段列表中并没有物料净重字段,那么怎样获取物料的净重数值呢?
函数配置
我们可以通过函数来实现,使用通用函数中的“获取单据字段值(GetFieldValue)”函数。为方便理解,这里对此函数做一个说明:BOTP转换规则,可以使用GetFieldValue函数,取任意单据上的字段值。
(1)函数格式:
GetFieldValue(entityNumber, readProp, filterProp1, filterValue1)
(2)返回值:Object
(3)函数说明:
函数描述:根据传入的取值条件,读取单据字段值
函数格式:GetFieldValue(entityNumber, readProp, filterProp1, filterValue1)
函数参数:entityNumber, 读取单据; readProp, 读取字段; filterProp1, 条件字段; filterValue1, 条件值
(4)示例:GetFieldValue(‘demo_bill1’, ‘id’, ‘billno’, ‘JD-001’):
公式解读:根据单据编号”JD-001”,找到单据demo_bill1,输出单据内码。
在本案例中,需要获取物料的净重值,我们可以这样理解,生成财务应收单时,物料信息是携带生成,根据当前行的物料id,则能够获取其对应的净重值。
因此,我们将函数的参数设置如下:
读取单据:选择主数据下的“物料”业务对象(bd_material)
读取字段:选择物料上的“净重”字段
条件字段:选择物料id“单据头.内码(id)”
条件取值方式:这里是自动取值,需选择“取其他字段值”
条件值:选物料字段“物料编码(e_material)”
4、效果展示
完成业务规则配置后,进入【财务云】→【应收】,选择暂估财务应收单下推财务应收单,可自动生成销售单价。
暂估应收单下推
销售单价生成
方案的复用价值
1、单据转换为标准产品提供的通用函数,用户可按需配置,无需二次开发,使用更加灵活方便。
2、想要获取已知单据上的任意字段值,都可以使用“获取单据字段值”函数,例如“生成凭证时,需要根据客户分组分别进入不同的应收账款明细科目”。传统方式只能通过表单插件进行二次开发实现,而通过“获取单据字段值”函数则可以简单配置实现,大幅降低交付成本。
相关资料
BOTP专题文档:
https://vip.kingdee.com/knowledge/specialDetail/241164705052806912?productLineId=29
#往期推荐#
更多精彩内容,“码”上了解!↓
实践案例 | 单据转换中“获取单据字段值”函数妙用
本文2024-09-23 00:25:05发表“云苍穹知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-cangqiong-139326.html