脚本模式下的填报表制作

Posted 2021-03-19 shiguangshiyi

填报是报表工具不可或缺的功能之一，润乾报表不仅提供了多源 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. 编号”。

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

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

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

第四步 其他设置

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

其中，

校验设置可参考文章： 报表数据填报中的合法性校验

自动计算配置可参考文章： 报表数据填报中的自动计算

总结：

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