birt报表高级进阶-库及模板使用.doc

前言 BIRT 是一个基于 Eclipse 的开源报表插件，特别适用于给 J2EE 的 WEB 应用程序创建报表。随着 BIRT 的不断完善，采用 BIRT 进行报表设计的人也越来越多。而随着 BIRT 应用的深入，很多人都碰到了这样一些问题： 在一个团队中，不同的设计者设计报表的时候，如何能够保证报表风格的统一？ 如何能够使得您的设计得到重用，从而提高工作效率？ 如何能够集中定义一些常用的资源，从而避免一处资源的变动，所有报表都要修改的情况发生？ 由于BIRT的官方文档还不是很完善，很多问题都还不能在官方文档找到详细的说明。本文将会试图通过实际的例子，帮助读者解决以上一些问题。 BIRT的主要组件分为两部分： BIRT 报表设计器和 BIRT 运行引擎。本文将主要介绍 BIRT报表设计器中的一些功能。作为 BIRT 的进阶教程，本文将不会涉及到如何用 BIRT 创建简单报表的内容，需要读者对 BIRT 有一些初步的认识，并且掌握 BIRT 报表的基本设计方法。 示例项目及相关设置介绍 为了方便读者理解，在开始介绍正式内容之前，先简单介绍一下本文中将会用到的 BIRT 示例项目和相关设置。 本文中用到的项目名称为 BirtIntroduction ，项目结构如下图： 图 1：示例项目层次结构 其中： JavaScripts 文件夹用于存放用户自定义的 JavaScript 文件。 lib 文件夹用于存放用户建立的库（ Library ）文件。 pic 文件夹用于存放所有报表中会用到的图片。 template 文件夹用于存放用户建立的模板文件。 所有的报表文件都会建立在 BirtIntroduction 下面。 在开始使用这些资源之前，还需要在Eclipse里面设置资源所在的位置。具体设置方法如下： 在Eclipse中选择 Window - Preference ，打开 Eclipse 设置窗口，选择 Report Design - Resource 设置资源文件夹为当前项目所在位置，如下图： 图 2：设置资源位置根目录 “ D:/BIRTReport/BirtIntroduction/ ” 是这个项目的绝对路径。 相关设置做好后，就可以开始我们的正式内容了。 在报表中使用用户自定义的 JavaScript 文件 BIRT给设计者提供了强大的数据控制功能，它不仅提供了一些常用的函数，而且还允许设计者在报表中自定义 JavaScript方法，并利用这些函数对报表输出样式，数值等因素进行修改，计算。但是，在大型项目中，如果很多功能相同的 JavaScript 方法的定义分布在各个报表中，对设计者来说，修改报表中的 JavaScript 将会成为噩梦一样的事情。那么 BIRT 能不能把这些功能相同的函数集中定义在一个 JS 文件中，并在 BIRT 中得以应用呢？答案是肯定的。 由于 BIRT 并没有给使用者提供 GUI 的方式为报表添加用户自定义的 JS 文件。所以我们只能通过修改 .rptdesign 文件的源文件进行 JS 文件的添加，删除工作。请看下面的详细步骤： 首先，我们要先创建自己的 JavaScript 文件。如下图： 图 3：创建 JavaScript 文件 创建的 JavaScript 文件名为 demo_scripts.js 。接下来，在新建的 JavaScript 文件中写入自定义的方法。下面是将在本文中用到的一个简单的方法，主要目的是把传入的两个数字参数通过下划线连接在一起，并且返回。 清单 1. 自定义的 JavaScript 方法 function combine(num1, num2) { var str = num1 + _ + num2; return str; } JavaScript 文件定义好了以后，就可以在报表中使用了，具体使用方法是： 打开报表定义文件，并且在主编辑区切换到” XML Source ”标签，然后在报表定义文件中加入如下语句。 清单 2. 把用户自定义的 JavaScript 文件加入到报表中 list-property name=includeScripts propertyJavaScripts/demo_scripts.js/property /list-property 如下图： 图 4：在报表中使用 JavaScript 文件 由于在文章开始的地方已经设置好了资源根目录，所以” JavaScripts/demo_scripts.js ”这个相对路径映射的绝对路径就是“ D:/BIRTReport/BirtIntroduction/JavaScripts