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

栏目:云苍穹知识作者:金蝶来源:金蝶云社区发布:2024-09-23浏览:1

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

小编推荐

为方便对账和审计,客户在生成财务应收单时需要获取物料的实际销售单价,但上下游单据只有含税单价。本期实践案例通过配置单据转换业务规则,妙用“获取单据字段”函数,实现客户诉求,无需二开,强烈推荐!


案例撰稿人:李涛。


业务背景


客户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



#往期推荐#

# 实践案例 | 揭秘单据转换:物料单位换算so easy

BOTP支持携带附件和图片,单据流转效率大提升

手把手带你实现“BOTP控制下推次数”

BOTP数据转录效率提升之路:分单合并图解


更多精彩内容,“码”上了解!↓


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

小编推荐为方便对账和审计,客户在生成财务应收单时需要获取物料的实际销售单价,但上下游单据只有含税单价。本期实践案例通过配置单据转换...
点击下载文档
确认删除?
回到顶部
客服QQ
  • 客服QQ点击这里给我发消息