润乾集算报表的集算器数据集部署（I）

    润乾集算报表提供了集算器数据集，允许用户使用集算器脚本完成数据的进一步计算和加工，为报表提供数据源支持，从而简化报表开发，提升报表性能。

    集算器脚本的编辑需要借助第三方集算编辑器（非报表工具）完成，而后嵌入到报表工具和报表应用中完成报表开发和部署。

下面来看一下集算器数据集的使用和以及报表部署过程。

1、开发环境使用

集算报表使用集算器数据集时，首先需要设置集算器授权信息和配置数据源连接（如果需要从数据库中取数）。

1.1、设置授权信息

启动集算报表设计器，选择工具-选项，切换到“集算器选项”，分别设置集算器注册码，寻址路径和主目录。

• 注册码： 集算器的版本通过注册码来控制，在该菜单为集算器设置注册码；

• 寻址路径：指定网格程序中引用的一些文件相对的路径，可设置多个，用分号分隔；

• 路径文件和远程文件的根目录，集算器中未设置主目录时使用当前程序文件所在目录。

1.2、配置数据源（可选）

如果集算器脚本中连接了数据库，集算报表调用时还需建立相应数据源，选择工具-数据源，“新建”数据源，如：

特别的，新建数据源之前应将相应数据库驱动拷贝到[集算报表安装目录]\common\jdbc下。通过如上步骤即可在集算报表设计器中调用集算器脚本（dfx）使用集算器数据集，下面通过两个具体实例说明使用过程。

1.3、实例

1.3.1、报表说明

    根据学生总成绩排名后，按照蛇形分布进行分班（分两个班），1班是1,4,5,8,…名，2班是2,3,6,7,…名。现根据班级参数查询本班学生名单。以下为实现步骤。

1.3.2、编辑集算脚本

首先使用集算器编辑集算脚本，根据参数从数据库取数完成数据计算，为报表返回计算后的结果集。

配置数据源

在编辑脚本过程中往往要进行编辑调试，实时查看运行结果，这时需要配置集算器数据源，数据源配置与报表数据源需要完全一致（包括数据源名称）。打开集算器编辑器，菜单栏选择“工具-数据连接”，新建数据源如下：

    设置参数

    使用集算编辑器，新建脚本（demo1.dfx），设置参数class，用于接收报表传递的班号。

    编辑脚本内容

     A1：使用上述配置的数据源demo2，建立数据库连接；与集算报表的脚本数据集可以直接使用报表数据源不同，集算器数据集中的脚本必须使用connect(db)语句建立连接；

    A2：执行sql查询所有学生名单及成绩等信息；

    A3：按照学生成绩降序排列；

    A4：为排序后的记录增加排名字段；

    A5：使用A.step()函数取子集，这里根据参数class来动态获取某个班级的成员；

    A6：为报表返回结果集。

1.3.3、设置报表模板

    设置报表参数

设置数据集

     在数据集类型中选择“集算器数据集”，调用上面编辑好的dfx。

     值得注意的是，DFX文件路径可以使用绝对路径，也可以使用相对路径，相对路径是相对在选项中设置的“主目录”（见1.1中截图），本例相对的主目录为：D:\Program Files\raqsoft\report\webapps\demo\reportFiles。

     参数中，class为集算脚本参数，classNum为报表参数，将报表参数传递给集算脚本用于数据计算。这里为了方便区分设置了不同参数名，实际使用中可以设置同名参数。

 

设置报表表达式

     最后在报表模板中编辑报表表达式完成报表制作。

    预览报表，班级参数分别输入1和2，得到1班和2班学生名单，如下：