Birt使用经验谈
Birt使用经验谈
入门级
Michael 2006-03-01
Jiabiao011@https://www.360docs.net/doc/5b9818474.html,
到目前使用birt已经有快3个周了，在此谈谈本人在使用birt的一些心得，希望对新手有所帮助，本人不大会写文档，只是希望能跟大家一起分享。对于他的简介就不在这里重复了。
1. 环境
? 报表设计器：可以到https://www.360docs.net/doc/5b9818474.html,/birt/downloads/下载最新版本，当前的最新版是birt-rcp-report-designer-2_0_1。将下载来的zip压缩包解压到相应的目录，如：E:\birt-rcp-report-designer-2_0_1。
? 可运行环境：可以到https://www.360docs.net/doc/5b9818474.html,/birt/downloads/下载最新版本，当前的最新版是birt-runtime-2_0_1。将其解压到相应目录，如：E:\birt-runtime-2_0_1。
? 可运行服务器：本人采用的是Tomcat5.0，jdk1.4.2。
? 其他：下载所需要的jar包，包括iText1.3、prototype.js v1.4.0 ，这两个jar包都可以在https://www.360docs.net/doc/5b9818474.html,/birt/downloads/下载。将下载的iText1.3jar包放在E:\birt-runtime-2_0_1\Web Viewer Example\plugins\org.eclipse.birt.report.engine.pdf\lib目录下，prototype.js v1.4.0包放在E:\birt-runtime-2_0_1\Web Viewer Example\ajax\lib目录下。
2. 简单报表例子
步骤如下：
? 打开报表设计器：运行E:\birt-rcp-report-designer-2_0_1目录下的birt.exe文件。报表设计器页面如下图所示：
? 新建报表：打开菜单“文件——新建——新建报表”，如图所示：
弹出新报表属性设置框口，如下图所示：
在文件名输入框中输入报表名称：如：test.rptdesign.同时也可以设置报表文件的存放路径，本人采用默认设置：E:\birt-rcp-report-designer-2_0_1\workspace\。电击“next”进入下一步设置，如图所示：
选择新建报表所要采用的报表模板：空白报表。到此报表的基本信息已经设置完，如果不需要设置其他内容，则可以点击“Finish”按钮，如果还需要设置其他内容，点击“Next”按钮，进入下一步设置，如图所示：
此步的作用是：将报表内容转换成模板时所需要的信息，输入相应信息。也可以不用填写，点击“Finish”按钮完成新报表的基本信息设置。这样就建好了一张空白的报表。如图所示：
? 设置报表
选择“数据库资源管理器”视图，
如果没有，可以点击菜单“窗口”——“显示视图”——“数据库资源管理器”，同样也可以打开“数据库资源管理器”。如图所示：
1) 设置数据源：即连接数据库
右键单击“数据源”，选择“新建数据源”。
弹出数据源属性窗口，如图：
选择相应的数据源类型，如“JDBC Data Source”，输入数据源名称“Test”，电击“Next”按钮进入下一步设置，如图：
选择所需驱动程序类，如果所需驱动不存在，则可以点击“管理驱动程序…”按钮，如图：
点
击“添加…”按钮选择所需驱动程序所在的jar包。本人用的是“ojdbc14.jar”，此包为oracle数据的驱动包。添加完后点击“ok”进入到设置数据源的主页面，电击“驱动程序类”下拉框选择驱动程序类，刚添加的驱动已经存在，如图：
选择“oracle.jdbc.driver.OrableDriver(v1.0)”项，输入数据库URL、用户名及密码。输入完后，点击“测试连接”按钮，检测是否正确连上。点击“Finish”按钮完成数据源的设置。
2) 设置数据集：即设置查询的数据集
右键单击“数据集”，选择“新建数据集”，如图：
弹出设置数据集属性的对话框，如图：
输入数据集名称（Test）、选择数据源（Test）、选择数据集类型（SQL Select Query）.。点击“Finish”按钮，弹出编辑数据集窗口，如下所示：
在右边的空白编辑区输入查询SQL语句，点击左边的“预览结果”，可以看到查询处的结果集。如图：
点击左边“输出列”，设置输出列的显示名称，如图：
点击“ok”按钮完成数据集的设置。进入设计器页面。
3) 建报表项：
右键单击右边编辑区，选择“插入”——“表”，如图所示：
弹出表属性框：如图：
设置表的列数（3）及明细数据数（1），点击“ok”按钮完成插入表操作。在编辑区出现了表，如：
此表包含了页眉（表头），明细数据行（数据），页脚行。
拖动左边数据集“Test”下的列到表的相应明细数据行，如图：
拖完后点击“预览”，在编辑区就可以看到报表数据，如图：
这样一个简单的报表就做出来了。
? 运行报表
1) 将E:\birt-runtime-2_0_1\Web Viewer Example文件夹拷贝到应用服务器的E:\Tomcat5.0\webapps\目录下，并修改此文件夹名为“birt”。
2) 将驱动程序包“ojdbc.jar”拷贝到E:\Tomcat5.0\webapps\birt\WEB-INF\lib\下。
3) 将包“iText1.3.jar”拷贝到E:\Tomcat5.0\webapps\birt\WEB-INF\lib\下。
4) 将E:\birt-rcp-report-designer-2_0_1\workspace\包下的test.rptdesign文件拷贝到E:\Tomcat5.0\webapps\birt\下。
5) 启动服务器：运行E:\Tomcat5.0\bin\startup.bat文件
6) 打开浏览器，在地址栏输入：
http://127.0.0.1:8080/birt/frameset?__report=test.rptdesign，即可以看到数据，如图：
到此一张简单的报表完成。
在以后的时间里，我会尽力多写点这方面的文档，并且更深入的了解、分析birt报表工具。在下一遍文档里，我会更详细的描述报表的设计特性（布局、样式、表的嵌套…….）