填报是报表工具不可或缺的功能之一,润乾报表不仅提供了多源 SQL 填报方式,而且提供了脚本模式填报,以便适应不同的填报数据处理需求。在线教程中对多源 SQL 方式做了详细的配置说明,这里就不再赘述了。(附在线教程地址:http://doc.raqsoft.com.cn/report/input/zzygwgstbb.html)
今天小编将带领大家解锁另外一种填报处理方式——脚本模式
以行式填报表实现雇员信息维护为例,我们来看一下脚本模式如何实现数据处理,请紧随小编的步伐:
第一步 新建填报表,编辑填报表内容和样式,如下图所示:
报表工具会将连续两行数值格会自动识别为行式填报,所以需要将第三、四行的单元格类型设置为数值格,设置方法如下图所示:
第二步 设置数据处理
依次点击“填报”---“数据处理”---“使用向导生成脚本”,会弹出如下图所示的向导配置页面,然后按照下图标示的顺序进行操作就可以自动生成脚本。!
其中,对象名称用户可以自行修改,例如修改为 employee,那么自动生成的来源脚本和去向脚本如下图所示:
其中,
A1:=connect(“demo”) 表示连接 demo 数据库
B1:>employee=A1.query(SQL) 表示在 demo 库中查询员工表信息,并将结果赋值给 employee 对象
C1:>A1.close() 表示关闭数据库连接
其中,
A1:=connect@e(“demo”) 表示连接 demo 数据库,@e 选项表示出错时返回错误信息由代码自行处理,否则将中断
B1:>A1.update@k(新对象: 旧对象, 更新表名称, 更新字段列表; 主键) 表示根据新旧对象的数据差异智能更新表的字段数据(关于 update 函数使用心得参见附录)
C1:=A1.error@m() 表示获取数据库异常信息
D1:>if(C1==null,A1.commit(),A1.rollback()) 表示如果没有异常抛出,则更新入库,否则回滚处理
E1:>A1.close() 表示关闭数据库连接
第三步 配置字段名称
选中 A3 单元格,在右侧属性列表的字段名称中输入“employee. 编号”。
对数据采集规则不理解的同学,可以直接对每个数值格设置字段名称,规则是:对象名. 字段名。
这里分享一个【小技巧】,我们可以通过设计器的预览按钮查看填报表的分区识别结果:
在制作填报表时,需要保证右侧识别到的对象、字段名称和来源脚本的对象结构是匹配的,这是将数据成功更新入库的必要条件之一。
第四步 其他设置
按照需求设置编辑风格、校验、自动计算、显示格式等。
其中,
校验设置可参考文章: 报表数据填报中的合法性校验 ](http://c.raqsoft.com.cn/article/1544091400841?r=IBelieve)
自动计算配置可参考文章: 报表数据填报中的自动计算 ](http://c.raqsoft.com.cn/article/1544091026876?r=IBelieve)
总结:
至此,一个简单的脚本模式填报表就制作完成了。实现过程也很简单,但是你可能会有疑问:脚本模式到底是个啥(What)?我为什么需要它(Why)?它适合什么样的场景(Where)?
What?脚本模式是基于集算器 (SPL) 语法的填报模式,通过内置函数实现数据获取、数据处理、数据回填等操作。
Why?脚本模式可以让开发人员更加明确需要维护的内容,也可以让开发人员处理填报数据时更加自由,让填报本身更加 open 和 free。
Where?多源填报场景下,多源 SQL 的配置步骤比较多,而脚本模式可以简化此配置;同时,从文件系统中获取数据、多表关联取数、动态取数等情况多源 SQL 是无法支持的,此时需要通过脚本模式实现。讲真,80% 的填报场景需要通过脚本模式制作实现。
附录:
脚本模式的核心函数:update()
一、语法:
db.update(新对象: 旧对象, 更新表名称, 字段: 更新值,…; 主键,…)
有旧对象时,新旧对象的数据先进行对比,将差异数据更新入库,例如,根据主键对比数据后,新增了的主键会进行插入操作;主键相同,其他字段不同时执行修改操作;主键字段减少时,则执行删除操作。
如果只有新对象,那么将直接将新对象的数据按照主键设置更新入库,此时只涉及修改和插入操作,无删除操作。
update 函数详细说明可参考:http://doc.raqsoft.com.cn/esproc/func/dbupdate.html
二、常用选项:
举个栗子:
1)根据新旧对象差异数据执行智能更新
demo.update( 对象 1: 对象 1_old,EMPLOYEE,EID,NAME,SURNAME,GENDER,
SALARY:SALARY+1000;EID)
说明:根据主键 EID 对比对象 1 和对象 1_old 的数据差异,并将差异数据智能更新到 demo 库的物理表 EMPLOYEE 中,更新字段为 EID、NAME、SURNAME、GENDER、SALARY,其中 SALARY 字段的更新值为 SALARY+1000
智能更新时,程序会自行判断执行 insert、update 或者 delete 操作。
2)根据新对象数据执行插入更新
demo.update@i( 对象 1,EMPLOYEE,EID,NAME,SURNAME,GENDER,
SALARY:SALARY+1000;EID)
说明:对比主键 EID,将对象 1 的数据插入 demo 库的 EMPLOYEE 表中,插入数据的字段为 EID、NAME、SURNAME、GENDER、SALARY,其中 SALARY 字段的更新值为 SALARY+1000
三、注意事项:
1)必须设置主键字段
2)更新的字段内容需要在新旧对象中都存在
3)自增字段的选项写法是 @1,注意:这里是数字 1 而不是字母 l