金蝶BOS开发指南_BOTP
注意:定义界面不是所有的目标单属性都会在此列出,只有目标实体上的属性设置了相应的扩展属性,才会显示在设置界面,具体请参考”扩展属性设置”一节;
3.4 单据体属性设置
与单据头部分类似, 单据体属性部分列出了目标实体单据体(即各个分录)的各项属性,可以对各个属性分别设置转换映射关系:
目标单每个分录对应一个页签,可以通过点击对应页签来切换相应分录的设置界面; 每个分录可以设置多条转换规则,右侧有相应的分录规则的增、删、复制按钮;
注意: 如果配置了多条分录规则,那么生成的目标单也会有多个分录,因此通常针对多个分录会通过在转换公式中设置条件来避免重复数据; 3.5 公式平台
如果需要设置复杂的转换映射关系,在属性设置界面上有”脚本编辑”按钮,点击可以进入公式平台界面:
16 / 59
金蝶BOS开发指南_BOTP
公式平台界面依赖于KScript脚本提供了更加丰富的单据转换映射功能,界面主要分几个部分,上方是公式定义框及脚本查看部分,界面中间是已定义的公式变量,界面左下方是公式元素选择部分,右下方是逻辑符定义部分;
3.6 计算公式定义 典型的计算公式定义:
17 / 59
金蝶BOS开发指南_BOTP
计算公式的定义一般性原则如下:
? 必须要返回公式结果, 常见定义格式如 公式结果 = xxx ; ? 公式定义的最后必须要用”;”结束;
? 公式中可以使用源单实体属性,也可以使用系统提供的各种函数; ? 不要直接在界面上拷贝/粘贴公式的某一部分; ? 对于使用”如果。。。否则。。。”类似语法的情况,对于每个大括号,其内部都必须要有返回”公式结果”并用”;”
号结束, 格式例:
? 如果是判断相等,请直接点击选择”等于”或手工输入”==”, 而不是用”=”;
3.7 使用函数
在公式平台中除了可以使用源对象上的各个属性外,还可以使用各种预定义的函数, 选择“函数”页签进入函数列表,所有函数分为几类,其中主要有基础资料函数、业务组织函数、数学函数等,还有一些各个单据自定义的函数;
18 / 59
金蝶BOS开发指南_BOTP
选择所需要的函数后,右侧会出现函数的说明信息,包括函数的定义及参数列表等; 双攻击函数名可以选择函数,然后需要移动光标到输入参数的地方, 再选择输入参数:
注意使用函数需要满足前述的公式平台定义各项基本原则; 3.8 分组合并规则
单据的分组合并规则是为了,将分组字段相同的数值进行合并,比如借款单生成报销单,按报销人相同分组,将已申请金额合并:
19 / 59
金蝶BOS开发指南_BOTP
合并分组规则定义界面如下:
在分组属性后打上勾,就表示按此属性分组。
如果有单头单体多个属性在分组属性栏,可以定义多级分组。如界面可以定义按公司一级分组、按分录、科目、币别、借贷方向进行二级分组。
合并属性定义同理,勾上了合并属性会按分组后的数据,将合并字段对应的值进行汇总。
选中分组合并属性后,则意味着当一次转换中产生的,多条记录的分组属性都相同时,就会进行合并生
成目标单据中的一条分录。 3.9 反写源单
20 / 59