Birt报表使用浅谈.doc

Birt报表使用浅谈作者：任小伟2011年 09月目录BIRT报表使用10. 文档介绍30.1文档信息30.2版本信息30.3修订记录30.4 术语与缩写解释41BIRT初识42BIRT设计42.1下载及安装Birt :：/birt/downloads/，42.2新建一个报表的步骤：52.2.1新建报表工程。打开eclipse后,new-other-Business intelligence and reporting tools report project 如下图52.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中的WebViewerExample173.2WEB调用相关动作及运行参数说明193.2.1 frameset 使用BIRT Report Viewer浏览，提供带分页显示、导出数据到csv功能、pdf打印功能的导航条，加_format=pdf参数后可生成PDF。193.2.2run 不带工具条，html显示193.2.3可用参数列表1933使用BIRT提供的Report Engine Api来调用报表并展现报表（研究中）190. 文档介绍0.1文档信息作者任小伟审核建立日期文档编号密级2011/9/230.2版本信息版本号最近更新日期V1.02011/9/230.3修订记录日期修订说明修订人2011-09-09初始文档建立任小伟0.4 术语与缩写解释缩写、术语解 释1Birt初识BIRT (Business Intelligence and Reporting Tools), 是为 Web 应用程序开发的基于 Eclipse 的开源报表系统，特别之处在于它是以 Java 和 J2EE 为基础。BIRT 有两个主要组件：基于 Eclipse 的报表设计器，以及部署到应用服务器上的运行时组件。2Birt设计2.1下载及安装Birt :：/birt/downloads/，最简单的就是下载其中的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 最后点击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 拖到中间。将数据集中的字段拖放到表的detail row中的单元格内将数据集中的字段拖放到表的detail row中的单元格内最后点击“preview”，就可在报表中显示数据这样一个简单的报表就完成了。2.2.6定义动态参数查询定义动态参数查询其实就是给查询语句加上where条件。如sql语句有where条件，则需要设置一个参数。新建报表参数 点击数据集,选择”parameters”将其绑定到定义的报表参数中去同时修改Query，加上where条件2.2.7生成简单的报表拖完后点击“预览”，在编辑区就可以看到报表数据这样一个简单的报表就做好了。2.2.8编辑JavaScript 事件处理程序BIRT设计器提供了一个 JavaScript 的开发和调试环境，开发者可以很方便地使用 JavaScript 来实现报表的事件响应处理程序。同时， BIRT也具有直接调用 Java 编写的事件响应处理类的机制。如果要加avaScript 事件，先选择某一 ，如table,等.切换到script直接在里面写就可以了,这里没有仔细研究，到时候用打的时候自己查阅资料即可。2.3给报表添加统计图表2.3.1准备工作 如2中一样：1新建报表工程；2新建报表；3构建数据源；4新建数据集；5报表布局。只不过在第五步中在”paletee” -选择“Report items”-将chart拖到中间。如下图：在”select chart type”下可以选择插入图形的种类，如：柱状图（bar）,折线图（line），区域图（area），饼图（pie）等。2.3.3在 select data页，使用数据集1232，同时选中role_name列，将其拖入类别（x）系列。对于统计列，同样将其拖入类别y系列。这里还可以做数据筛选等操作；如下图：可以在filter中加过滤条件，过滤不合格的数据。2.3.4在”Format chart”中生成合适的图形。点击“finish“按钮，这样一个图形报表也就完成了。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.lowagie.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.rptdesign (相对路径)或者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-6-13；e. 如果需要和现有WEB项目集成，可直接把WebViewerExample目录下所有文件及文件夹复制到现有项目的WebRoot下部署运行即可。例如：New -other-web project 将XXX. new_report.rptdesign copy到webContent目录下。调用时a href=View Example2*Name为参数名称，如果有参数，就加上参数。注意一点：发布时加上相应数据库的驱动.Add the jar files for your JDBC drivers to the Viewer. Copy the driver the following 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可用参数列表参数名参数说明参数值默认值_format指定报表输出格式html 或 pdfhtml_isnull指明一个参数是null，常用于字符串类型。如果提供参数且值为空： - 对于日期和数字类型，BIRT会将它们当作null处理。 - 对于字符串，BIRT会将它作为空字符串。因此，为了说明某个字符串是null，通常写为：_isnull=参数。报表输入参数名None. Required._locale本地化选项en-us 或 ch-zh虚拟机默认_report指定 *.rptdesign文件路径None.