套打.动态字段.基础资料字段使用指南
新版套打功能:套打支持单据实体动态字段(基于Python表达式进行配置)
小tips:
1.如果要文本和非文本一起显示(如数字、日期),那么应该将非文本转换为文本,其中str()为python函数,.ToString()为C#函数,看情况使用
<1>基础资料默认默认取名称字段(名称-》编码-》内码)
实现细则:平台自动优化,当数据包作为脚本返回时在运行过程中为数据包,控件绑定时自动隐式转换为调用.ToString(),输出为名称字段(名称-》编码-》内码);同时,支持显式调用.ToString()输出;特别的,python脚本调用的str()也将由重写的ToString接管;
性能:ToString()>str()>implicit operator
插件干预时的数据包:
<2>基础资料支持按照字段标识、属性名称取数据,使用更加便捷;支持取内码、编码、名称、嵌套字段
实现细则:对于不太熟悉的用户建议使用字段标识,字段标识能够解决字段位于不同层级的优化处理(如子单据头、单据体);表达式返回类型与数据包中的数据结构相关,如上图中最后一个示例为在采购订单上取“供应商”基础资料的“默认税率”,返回的则为数据表对象,控件绑定时使用隐式转换转为名称显示
<3>判断基础资料是否为空的实现(xxx == null /xxx != null)
实现细则:重点关注基础资料为空时访问基础资料内部变量的问题,使用字段名隐式转换显示的不会中断(显示空),显式显示字段名的会中断异常(若不确定是否一定有值,那么就要做空异常判断,堆栈异常的表达式可以快速定位错误的表达式,进行相关的修复)
在可能为空的基础资料,使用三元运算符输出如(空仅仅只是为了验证表达式执行,原则上输出''空串):
FAssignSupplierId.Id if FAssignSupplierId != null else '空'
<4>判断基础资料字段绑定的字段是否相等(f_base1 == f_base2/f_base1 != f_base2)
实现细则:建议不要自己写判断表达式,应该使用平台重载的相等、不等运算符,处理了基础资料类型是否匹配,是否为空的场景,代码上更加简约;(目前是想不到到有什么需要自己写判断相等表达式的场景,难道有可能针对两者都空,任一为空输出不同的值吗?)
<5>判读单据上的基础资料的嵌套基础资料是否等于某特殊值
使用内码、编码、名称判断值是否匹配,其中名称是具有多语言的特性的,如果名称在不同语言下进行值类型匹配,那么需要考虑公式仅在部分语言下才能匹配成功;
案例分享:采购订单上的供应商的默认税率,如果为13%和6%是增值税专用,1%的普票,其他显示其他;
名称匹配表达式(查找子字符串,值不为空版本):
'增值税' if (FSupplierId.FTaxRateId.FName.find('13%')>=0 or FSupplierId.FTaxRateId.ToString().find('6%')>=0) else ('普票' if FSupplierId.FTaxRateId.FName.find('1%')>=0 else '其他种类')
编码匹配表达式(查找是否在集合内,值不为空版本):
'增值税' if (FSupplierId.FTaxRateId.Number in ('SL02_SYS','SL06_SYS')) else ('普票' if FSupplierId.FTaxRateId.Number == 'SL001' else '其他种类')
编码匹配表达式(值可能为空版本)
'' if FSupplierId == null or FSupplierId.FTaxRateId == null else ('增值税' if (FSupplierId.FTaxRateId.Number in ('SL02_SYS','SL06_SYS')) else ('普票' if FSupplierId.FTaxRateId.Number == 'SL001' else '其他种类'))
<6>注意事项
a):目前不支持嵌套两级的基础资料内的数据取数(如采购订单.供应商.默认税率.税率,目前取不到,只建议使用编码、名称匹配);后续考虑在按需加载且性能可控的情况下,放开多级嵌套取数。
b):各表达式之间不要构建依赖关系,一个表达式完整的执行一个计算逻辑(由于性能的问题,表达式之间是采用并行运算的,在并行运算下,无法保证每一个表达式之间的计算顺序,如果依赖中间量可能会导致部分行表达式有值部分行没有值的可能);暂时不会考虑改为串行,如果需要后续会动态构建表达式按依赖关系计算。
c):如果不确定是否为空,那么都应该在表达式做非空判断运算。
d):值匹配更多的使用编码匹配。
e):名称字段建议只用作在输出时替换用,不建议在表达式用作判定条件(多语言相关)。
套打.动态字段.基础资料字段使用指南
本文2024-09-23 04:12:53发表“云星空知识”栏目。
本文链接:https://wenku.my7c.com/article/kingdee-k3cloud-163861.html