金蝶BOTP脚本转换,对SQL语句的支持

BOTP脚本中允许通过短名称调用常用函数调用(目前只支持SQL函数);

提供简单易用的sql函数,简化数据库访问。
SQL函数语法
假定,sql是表示SQL语句的变量。

1.#sql_val 从数据库获取一个值(OBJECT);
java.lang.Object value = #sql_value(sql); 

2.#sql_row 从数据库获取一行记录(MAP);
java.util.Map row = #sql_row(sql);
注:以SQL语句中的列名的小写形式作为Map的key,对应列的值作为与key关联的值。

3.#sql_col 从数据库表获取多行记录的某一列值(ARRAY);
java.lang.Object[] array = #sql_list(sql);

4.#sql_list 从数据库表获取结果集(由MAP组成的List);
java.util.ArrayList list = #sql_list(sql);
注:list中的每一个元素是一个java.util.Map对象,Map的内容以SQL语句中的列名的小写形式作为Map的key,对应列的值作为与
该key关联的值。

5.#sql_exec 执行修改/插入/删除SQL(返回影响的行数)。
int updated = #sql_exec(sql);
注意以上sql中,不能包含空格或其他字符,并且 必须使用小写形式(原文档上的注释,测试没发现空格的特殊影响)

需要#sql_val 几乎能实现目前所有业务函数!

1.函数举例:
a.弱类型关联函数
公式结果 = __BOTGetProperty(销售出库单.销售出库单分录.核心单据行ID,"entry.taxRate");
可以替换为:
公式结果 = #sql_val("select ftaxRate from **核心单据分录表名称 where fid ='"+销售出库单.销售出库单分录.核心单据行ID+"'");

2.利用sql的集合函数做一些之前没有实现的逻辑!在分录集合处理中能很好利用:

a.金额汇总 以汇总销售出库单分录单位实际成本为例:
公式结果 =#sql_val("select sum(funitactualcost) from t_im_saleissueentry where fparentid='"+销售出库单.ID+"'");
b.使用count()获取某种类型,或某字段值为指定值的分录的条数,在此不举例。

3.性能问题
如上对弱类型关联函数的修改,对于单字段的转换,能够减少查询的数据量(弱类型关联函数会取出整个分录或单据对象)。但是在转换过程中,每个脚本段可能被执行多次,造成不必要的查询重复消耗。对于公式函数,转换引擎有做函数级别的缓存。因此,若使用
sql宏函数代替BOTP原有内置的业务函数,强烈建议增加缓存处理。
处理方法:使用BOTP转换过程中的对象线程缓存BOTObjectCache:

具体公式平台脚本:
var result = com.kingdee.eas.base.botp.util.BOTObjectCache.getInstance(__bosContext).get("_BOTGetProperty"+销售出库单.销售出库单分录.核心单据行ID+"entry.taxRate"); //先从缓存取数
如果(result 不等于 null) {
公式结果 = result;
}
否则{
result = #sql_val("select ftaxRate from **核心单据分录表名称 where fid ='"+销售出库单.销售出库单分录.核心单据行ID+"'");
com.kingdee.eas.base.botp.util.BOTObjectCache.getInstance(__bosContext).put("_BOTGetProperty"+销售出库单.销售出库单分录.核心单据行ID+"entry.taxRate",result); //将查询结果存入缓存
公式结果 = result;
}

补充说明:
发现存在宏函数不生效的场景,如新增的“自定义公式”中的测试功能,可通过以下方式处理:
在参数中新增一个“__bosContext” 参数,不设置初始值再点测试即可。

你可能感兴趣的:(金蝶EAS,BOS开发笔记)