润乾报表集成到Eclipse开发环境.docx

目录1 将润乾报表整合到 Eclipse Web 项目 .............................................................................11.1 拷贝润乾报表所需文件 .......................................................................................11.2 修改配置文件 ......................................................................................................31.3 添加数据源 ..........................................................................................................51.4 多数据源配置 ......................................................................................................62 润乾报表模板配置 ..........................................................................................................62.1 新建数据源 ..........................................................................................................62.2 新建报表 ..............................................................................................................82.3 给报表添加过滤条件 .........................................................................................132.4 分组报表 ............................................................................................................182.5 多数据源报表 ....................................................................................................212.6 子报表 ................................................................................................................252.7 引用子报表内容 .................................................................................................312.8 设置报表样式 ....................................................................................................323 在 JSP 中引用报表 .........................................................................................................341 将润乾报表整合到 Eclipse Web 项目1.1 拷贝润乾报表所需文件打开润乾报表程序根目录下的 webapps\demo\WEB-INF\lib, 将目录下的所有 jar 包拷贝到 Web 项目的 lib 目录下:打开润乾报表程序根目录下的 webapps\demo\WEB-INF, 将以下文件拷贝到 Web 项目的 WEB-INF 目录下:打开润乾报表程序根目录下的 webapps\demo, 将以下文件拷贝到 Web 项目的WebContent 目录下 :在 WebContent 目录下新建 reportFiles 目录用来存放报表文件:将润乾报表 Designer 授权文件拷贝到 Web 项目的 src 目录下 :1.2 修改配置文件web.xml打开 Web 项目的 web.xml 文件, 在 web-app 节点内添加如下内容 :SetContextServletcom.runqian.util.webutil.SetContextServlet2reportServletcom.runqian.report4.view.ReportServletconfigFile/WEB-INF/reportConfig.xml1DMServletcom.raq.web.view.DMServletconfigFile/WEB-INF/dmConfig.xml10reportServlet/reportServletDMServlet/DMServletDMServlet/DMServletAjax/WEB-INF/runqianReport4.tld/WEB-INF/runqianReport4.tldreportConfig.xml打开 Web 项目的 reportConfig.xml 文件, 将 license 的值修改为刚才拷贝到 src 目录下的授权文件的名称:将 reportFileHome 的值修改为刚才新建的用来存放报表文件的目录的名称:JNDIPrefix 属性表示查找数据源时的环境串前缀，在不同的 WEB 服务器中不同, 如Tomcat 中是 java:/comp/env, 而 Weblogic 和 Websphere 中均不需要, 可以不填.dataSource 表示用户在 WEB 应用中要用到的数据源配置, 其格式如下:数据源的 JNDI 名称, 数据库类型[,取数时是否需要转换编码 ,数据库字符集编码,显示报表时的字符集编码][,SQL 是否需要转码];[重复]……数据库类型按下表填写:注: 上表中不存在的数据库类型, 参数值都写为写 unknown. 1.3 添加数据源以 tomcat 为例, 找到%TOMCAT_HOME%/conf\Catalina\localhost\项目名称.xml 文件, 没有则新建一个, 内容为:红色标记为需要配置的地方, 其他配置参数, 按照自己项目的需求进行配置.其中 name 的值请与 reportConfig.xml 中的 dataSource 的数据源名称保持一致.1.4 多数据源配置如果报表中需要使用多个不同数据源, 可以参照上一步在 web 容器中添加一个数据源:然后在 reportConfig.xml 的 dataSource 中追加一条配置:多条数据源之间以半角分号隔开.至此 Web 项目已经完成了与润乾报表的整合.2 润乾报表模板配置2.1 新建数据源打开润乾报表设计器, 点击菜单配置--数据源点击新建—关系数据库填写数据库信息点击 连接 按钮连接数据源2.2 新建报表点击菜单 文件—新建报表填报类型选择普通报表, 数据源填写上一步定义的数据源名称, 数据集类型选择 SQL检索:选中需要的表选中需要的列:检索条件暂时不填, 选取排序字段可以在语法内看到生成的语句如下点击确定, 报表类型向导页面可以调整字段显示顺序报表定义页面可以隐藏不需要显示的字段点击生成网格报表后生成的报表样式如下2.3 给报表添加过滤条件例如上例中报表需要一个过滤条件 where contry like ‘%中国%’, 首先右键点击生成的报表的第 00 单元格 , 选择参数 选项:新增一个参数 contry, 数据类型为字符串 可以给定一个预设值为’中国’:右键点击 00 格, 选择数据集:点击编辑, 可以看到之前定义的数据集选择检索条件, 选择需要添加的字段, 在右边的窗口中填写表达式, 参数使用占位符?代替, 语法与 HQL 相同:选择参数, 点击 增加按钮添加一个参数, 双击参数表达式栏会弹出表达式编辑窗口数据栏会列出当前报表已定义的参数, 双击可添加到报表表达式栏.点击浏览数据可预览当前数据集查询结果:此处数值会自动填写定义参数时所填写的预设值. 点击确定预览数据:点击文件—预览 可预览报表效果:2.4 分组报表例如上例中报表需要按照国家—省份— 城市进行分组, 首先调整一下字段顺序, 然后将报表数据区内需要分组的字段改为 =数据集.group(字段) 格式:函数说明： 根据分组表达式，从数据集中选出一组组集。

语法： datasetName.group( , , ) //适用于不需要排序或数据集中已排好序 datasetName.group(selectExp{,descExp{,filterExp{,sortExp{,groupSortExp{,groupDescExp{,rootGroupExp}}}}}})参数说明： selectExp 选出的分组表达式，可以是字段列名 /列号，也可以是表达式列号用 #n 表示，例如 #0 代表第 0 列， #1 代表第 1 列，依此类推 descExp 分组前记录的排序顺序， true 为逆序， false 为顺序 filterExp 过滤表达式 sortExp 分组前记录的排序依据表达式 groupSortExp 分组后对组的排序表达式，一般是汇总运算的表达式，如组合计等 groupDescExp 组排序顺序， true 为逆序， false 为顺序 rootGroupExp 是否 root 数据集表达式返回值： 一组数据的集合，数据类型由 selectExp 的运算结果来决定示例：例 1： ds1.group(class) 把数据集 ds1 中所有记录按照 class 字段进行分组，并返回每组的 class 值组成的集合例 2： ds1.group(class, true ) 把数据集 ds1 中所有记录按照 class 字段降序排列，然后根据 class 进行分组，并返回每组的 class 值组成的集合例 3： ds1.group(class,false,sex=='1') 从数据源 ds1 中选取性别为 "1"的记录，按照 class字段升序排列，然后根据 class 进行分组，并返回每组的 class 值组成的集合例 4： ds1.group(class, true, sex=='1', id ) 从数据源 ds1 中选取性别为 "1"的记录，按照 id字段降序排列，然后根据 class 进行分组，并返回每组的 class 值组成的集合例 5： ds1.group(省份 ,true,,,ds1.sum(工业产值 ),true) 对数据集 ds1 按照省份进行分组，分组后求出每组的 sum(工业产值 )，然后按照这个汇总值对组进行逆序排列预览数据如下会发现少了一条数据并且没有正确分组. 这是由于没有对分组字段进行排序 , 并且未分组字段只选取了符合条件的第一条数据. 给每个分组字段加上排序选项 , 并为没有进行。