脚本模式下的填报表制作

填报是报表工具不可或缺的功能之一,润乾报表不仅提供了多源 SQL 填报方式,而且提供了脚本模式填报,以便适应不同的填报数据处理需求。在线教程中对多源 SQL 方式做了详细的配置说明,这里就不再赘述了。(附在线教程地址:http://doc.raqsoft.com.cn/report/input/zzygwgstbb.html)

今天小编将带领大家解锁另外一种填报处理方式——脚本模式

以行式填报表实现雇员信息维护为例,我们来看一下脚本模式如何实现数据处理,请紧随小编的步伐:

第一步 新建填报表,编辑填报表内容和样式,如下图所示:

imagepng

报表工具会将连续两行数值格会自动识别为行式填报,所以需要将第三、四行的单元格类型设置为数值格,设置方法如下图所示:

imagepng

第二步 设置数据处理

依次点击“填报”---“数据处理”---“使用向导生成脚本”,会弹出如下图所示的向导配置页面,然后按照下图标示的顺序进行操作就可以自动生成脚本。!
imagepng

其中,对象名称用户可以自行修改,例如修改为 employee,那么自动生成的来源脚本和去向脚本如下图所示:
imagepng

其中,

A1:=connect(“demo”) 表示连接 demo 数据库

B1:>employee=A1.query(SQL) 表示在 demo 库中查询员工表信息,并将结果赋值给 employee 对象

C1:>A1.close() 表示关闭数据库连接

imagepng

其中,

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. 编号”。

imagepng

对数据采集规则不理解的同学,可以直接对每个数值格设置字段名称,规则是:对象名. 字段名。

这里分享一个【小技巧】,我们可以通过设计器的预览按钮查看填报表的分区识别结果:

imagepng

在制作填报表时,需要保证右侧识别到的对象、字段名称和来源脚本的对象结构是匹配的,这是将数据成功更新入库的必要条件之一。

第四步 其他设置

按照需求设置编辑风格、校验、自动计算、显示格式等。

其中,

校验设置可参考文章: 报表数据填报中的合法性校验 ](http://c.raqsoft.com.cn/article/1544091400841?r=xiaohuihui)

自动计算配置可参考文章: 报表数据填报中的自动计算 ](http://c.raqsoft.com.cn/article/1544091026876?r=xiaohuihui)

总结:

至此,一个简单的脚本模式填报表就制作完成了。实现过程也很简单,但是你可能会有疑问:脚本模式到底是个啥(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

二、常用选项:

imagepng

举个栗子:

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

以下是广告时间

对润乾产品感兴趣的小伙伴,一定要知道软件还能这样卖哟性价比还不过瘾? 欢迎加入好多乾计划。
这里可以低价购买软件产品,让已经亲民的价格更加便宜!
这里可以销售产品获取佣金,赚满钱包成为土豪不再是梦!
这里还可以推荐分享抢红包,每次都是好几块钱的巨款哟!
来吧,现在就加入,拿起手机扫码,开始乾包之旅



嗯,还不太了解好多乾?
猛戳这里
玩转好多乾