1、Birt 报表使用浅谈作者：任小伟2011 年 09 月目录BIRT 报表使用 .10. 文档介绍 30.1 文档信息 30.2 版本信息 30.3 修订记录 30.4 术语与缩写解释 .41BIRT 初识 .42BIRT 设计 .42.1 下载及安装 Birt :：http:/download.eclipse.org/birt/downloads/ ， 42.2 新建一个报表的步骤： 52.2.1 新建报表工程。打开 eclipse 后,new-other-Business intelligence and reporting tools report project 如下图 .52.2.2
2、 新建报表。new-other-Business intelligence and reporting tools report62.2.3 设计报表之一构建数据源。 .62.2.4 新建数据集 .82.2.5 报表布局 .92.2.6 定义动态参数查询 .92.2.7 生成简单的报表 .112.2.8 编辑 JavaScript 事件处理程序 123 展示设计好的报表 .163.1WEB 容器生成方式 .173.1.1 直接使用 birt_runtime_2.1.2 中的 WebViewerExample 173.2WEB 调用相关动作及运行参数说明 .193.2.1 frameset 使用
3、 BIRT Report Viewer 浏览，提供带分页显示、导出数据到 csv功能、pdf 打印功能的导航条，加_format=pdf 参数后可生成 PDF。 193.2.2run 不带工具条，html 显示 193.2.3 可用参数列表 .193 3 使用 BIRT 提供的 Report Engine Api 来调用报表并展现报表（研究中） 190. 文档介绍0.1 文档信息审核 建立日期 文档编号 密级作者任小伟 2011/9/230.2 版本信息版本号 最近更新日期V1.0 2011/9/230.3 修订记录日期 修订说明 修订人2011-09-09 初始文档建立 任小伟0.4 术语与
4、缩写解释缩写、术语 解 释1Birt 初识BIRT (Business Intelligence and Reporting Tools), 是 为 Web 应 用 程 序 开 发 的 基 于 Eclipse 的 开 源 报 表 系 统 ， 特 别 之 处 在 于 它 是 以 Java 和 J2EE 为 基 础 。 BIRT 有 两 个 主要 组 件 ： 基 于 Eclipse 的 报 表 设 计 器 ， 以 及 部 署 到 应 用 服 务 器 上 的 运 行 时 组 件 。2Birt 设计2.1 下载及安装 Birt :：http:/download.eclipse.org/birt/dow
5、nloads/，最简单的就是下载其中的 birt-report-designer-all-in-one-XXX.zip 版本，直接运行就可。2.2 新建一个报表的步骤：2.2.1 新建报表工程。打开 eclipse 后,new-other-Business intelligence and reporting tools report project 如下图输入 project name：birt 即可。2.2.2 新建报表。 new-other-Business intelligence and reporting tools report输入文件名，选择 blank report 最后点击
6、 finish2.2.3 设计报表之一构建数据源。打开”data explorer ”将出现如下图，右击“data source”点击“manage dirver.”加上数据库的驱动.点击“Test Connection 。 。 ”测试连接是否成功。我用的现有工程 DB2。大家也可以用其他数据库，只不过要注意 JAR 包和数据库 URL 就可以了。2.2.4 新建数据集右击“data sets” new data set 从左边 drag 相应的字段，构成查询 sql 语句（其实就是 sql 语句）2.2.5 报表布局显示出”paletee” 选择“Report items” 将 table
7、拖到中间。将数据集中的字段拖放到表的 detail row 中的单元格内将数据集中的字段拖放到表的 detail row 中的单元格内最后点击“preview” ，就可在报表中显示数据这样一个简单的报表就完成了。2.2.6 定义动态参数查询定义动态参数查询其实就是给查询语句加上 where 条件。如 sql 语句有 where条件，则需要设置一个参数。新建报表参数 点击数据集,选择”parameters”将其绑定到定义的报表参数中去同时修改 Query，加上 where 条件2.2.7 生成简单的报表拖完后点击“预览” ，在编辑区就可以看到报表数据这样一个简单的报表就做好了。2.2.8 编辑
8、JavaScript 事件处理程序BIRT 设计器提供了一个 JavaScript 的开发和调试环境，开发者可以很方便地使用 JavaScript 来实现报表的事件响应处理程序。同时， BIRT 也具有直接调用 Java 编写的事件响应处理类的机制。如果要加 avaScript 事件，先选择某一 ，如 table,等.切换到 script直接在里面写就可以了,这里没有仔细研究，到时候用打的时候自己查阅资料即可。2.3 给报表添加统计图表2.3.1 准备工作 如 2 中一样： 1 新建报表工程； 2 新建报表；3 构建数据源； 4 新建数据集；5报表布局。只不过在第五步中在”paletee” -
9、选择“Report items”-将 chart 拖到中间。如下图：3.22.3.2 在”select chart type”下可以选择插入图形的种类，如：柱状图（bar） ,折线图（line） ，区域图（area） ，饼图（pie）等。2.3.3 在“ select data“页，使用数据集 1232，同时选中 role_name 列，将其拖入“类别（x）系列“ 。对于统计列，同样将其拖入 “类别 y 系列 “。这里还可以做数据筛选等操作；如下图：可以在 filter 中加过滤条件，过滤不合格的数据。2.3.4 在”Format chart”中生成合适的图形。点击“finish“按钮，这样一
10、个图形报表也就完成了。3 展示设计好的报表首先需要下载 BIRT 报表的运行环境包下载完成解压后文件结构如图：如果需要输出 PDF 格式，需要下载 itext-1.3.jar 支持包, 如果输出 PDF 要显示亚洲语言，需要下载 iTextAsian.jar 支持包，3.1WEB 容器生成方式3.1.1 直接使用 birt_runtime_2.1.2 中的 WebViewerExamplea.将其复制到%TOMCAT%webapps 目录下，并将其更改名称为 birtServer；b.如需生成 PDF 格式，在 birtServerWEB-INFplatformpluginscom.lowag
11、ie.itext 目录下新建文件夹 lib,并将 itext-1.3.jar 和 iTextAsian.jar 拷入其中；c.把所使用的数据库的 JDBC 驱动 jar 包复制到 birtServerWEB-INFplatformpluginsorg.eclipse.birt.report.data.oda.jdbc（后跟版本号）drivers 目录下；d.将设计好的报表，比如 test.rptdesign 放到 BirtServer 的根目录下，然后启动TOMCAT，即可通过 http:/localhost:8080/birtServer/frameset?_report=test.rptd
12、esign (相对路径)或者 http:/localhost:8080/birtServer/frameset?_report=C:/test.rptdesign (绝对路径)来访问。如果要生成 pdf 文件，如下：http:/localhost:8080/birtServer/frameset?_report=test.rptdesign&_format=pdf 如果报表有输入参数，只需在上述 url 后拼接参数及值即可，如下：http:/localhost:8080/birtServer/frameset?_report=test.rptdesign&name=whj&date=2007-
13、6-13；e. 如果需要和现有 WEB 项目集成，可直接把 WebViewerExample 目录下所有文件及文件夹复制到现有项目的 WebRoot 下部署运行即可。例如：New -other-web project 将 XXX. new_report.rptdesign copy 到 webContent 目录下。调用时“View Example2*Name 为参数名称，如果有参数，就加上参数。注意一点：发布时加上相应数据库的驱动.Add the jar files for your JDBC drivers to the Viewer. Copy the driver the follow
14、ing directory: If you are installing BIRT or later 你需要把驱动拷贝到WEB-INFplatformpluginsorg.eclipse.birt.report.data.oda.jdbcdrivers. 这个目录下。3.2WEB 调用相关动作及运行参数说明3.2.1 frameset 使用 BIRT Report Viewer 浏览，提供带分页显示、导出数据到 csv 功能、pdf 打印功能的导航条，加_format=pdf 参数后可生成 PDF。3.2.2run 不带工具条， html 显示3.2.3 可用参数列表参数名 参数说明 参数值
15、默认值_format 指定报表输出格式 html 或 pdf html_isnull指明一个参数是 null，常用于字符串类型。如果提供参数且值为空： - 对于日期和数字类型，BIRT 会将它们当作 null 处理。 - 对于字符串，BIRT 会将它作为空字符串。因此，为了说明某个字符串是 null，通常写为：_isnull=参数。报表输入参数名 None. Required._locale 本地化选项 en-us 或 ch-zh 虚拟机默认_report 指定 *.rptdesign 文件路径 None. Required.报表输入参数名 报表输入参数 具体的输入参数值 在设计报表时指定_svg指定是否使用 SVG 矢量图来显示图表。SVG 矢量图形是一种 XML 格式的文本文件，在 IE 下需要安装 Adodb SVG Viewer 插件才能浏览。true 或 false安装插件后浏览时frameset 下默认true，run 下默认false；不安装插件时默认为 false3 3 使用 BIRT 提供的 Report Engine Api 来调用报表并展现报表（研究中）
