birt教程.docx

1、birt教程Birt使用说明目录1. 下载相关的软件12. 如何创建新的报表及报表模板 创建报表 发布模板3. 设置报表的属性1A、设置报表的样式表 设置数据信息 设置数据源。 设置数据集 设置输出的列 设置计算列 设置数据集的参数B、设置报表的布局 几种控件的介绍C、设置报表的样式表 倒入样式表单 设置的控件样式4. 报表的相关处理A、报表参数 新加参数 参数邦定B、数据排序分组过滤高亮显示 排序 分组 过滤 格式化指定的列显示C、预览打印报表 在开发环境下点击preview即可。 在tomcat的环境下 集成的自己的运用程序中5. 相关的网站及帮助的使用一、下载相关的软件下载地址：选择下面

2、的连接 开发环境 http:/download.eclipse.org/birt/downloads/build.php?build=R-R1-2_1_0-200606281351 AvailabilityPlatformDownloadWindowsbirt-report-designer-all-in-one-2_1_0.zip (md5) 下面的连接 运行环境AvailabilityPlatformDownloadAllbirt-runtime-2_1_0.zip (md5) 一、 在项目中如下图新建一个报表 创建报表在下面图中输入报表名称，点击下一步选择报表的类型，最后创建一个新报表。

3、这里面有不birt系统自带的几种类型也有自己做的模板 其中testTemplate是我做的一个简单模板 ，这里选择特testTemplate模板，将带一些基本的属性给新的报表如下图：包括数据源,数据集,页面的样式css,分页机制等.如果选择其他的样式类型这些属性将需要自己设置。 发布模板将做好的报表可以以模板的形式发布在以后的开发中使用建好的模板。在outline页面右击做好的报表选择 publish to template 如下图进入模板发布页面进行发布二、 设置报表的属性。创建一个空白报表1、设置数据信息 设置数据源。在dataExplorer标签下点击data Sources进入下图界面

4、输入你的驱动类，数据库的URL，数据库的用户名密码。点击testConnection测试是否能连接到数据库。 设置数据集点击dataSet进入如下界面 在数据源(data Source)一栏中选择你的数据源。Query 一栏中输入你的查询sql语句.在这里可以（一个以上的）带参数。如select * from lemis.aa01 where aaa001=? And aaa002=? 如果不带参数则点击 preview Result 查看数据集的情况。正确的如下图显示。 设置输出的列名 点击 output columns 进入下图界面 在display name栏中输入你要在数据表栏中显示的

5、名字。 设置计算列 ，在一些报表中可能要对一些列进行计算生成新的列。点击computer column 进入如下图： 在column name 一栏中输入你的列名，大厅data type中输入数据类型。在Expression 中点击按钮进入表达式生成界面 如下图： 这里提供了提供了 data sets(数据集)，javaScript ,birt , operators(运算)4种类型计算新列的方法。输入结束点击ok。 表达式设计界面 设置数据集的参数 注意：1它和报表的参数不一样。2在数据集查询中使用了”?”参数必须进行参数的设定。3 2者之间需要邦定见下面的描述。点击paraments 进入

6、如下界面，输入你的参数名字，数据类型，direction中选择input （表示是输入参数，一般都是input）,default value.其中default value.可以是表达式的计算结果。（点击default value的按钮可以进入表达式设计界面如上图）preview Result 查看数据集的查询结果。2、设置报表的布局 在palette 中有各种控件，将他们拖到空白的报表上(layout)就可以如下图： 几种控件的介绍 Lable 标签输入静态文本标签 Text 文本输入静态文本 DLable 动态文本标签显示变量或表达式的值 Dtext 动态文本显示变量或表达式的值 Imag

7、e 图片可以在报表中插入图片。 Grid 可以用它在报表中设置你的布局。List 用于在报表中显示list的信息 Table 用以显示你的数据集 。你将你预先定义的数据集拖到table的detail的row中华就可以显示你的数据集 grid和table支持行列的合并如下图 选中要合并的行列右击选择merger cells即可 Char 用于在报表中显示你的统计图3、设置报表的样式表 倒入样式表单Birt支持css样式表 你可以预先定义好各种控件的样式，在报表中统一应用 。在outline 中选择style 点击倒入按钮进入如下界面倒入你预先设计的css样式单你必须选择相应样式单前的复选框 设置

8、的控件样式 选中你要设置的控件或控件组 在属性页中点击style选择你倒入的样式也可以选中控件设置它的样式在property 和property Editor 2个页面中找到对应的样式进行设置。如果你的界面上没有相关的菜单如下进行设置，调出相应的栏目四、报表的相关处理1、 报表参数 新加参数在outline 中选择report Parmament 右击进入如下界面 Name 中输入参数名，prompt text栏中输入参数的显示名称，tada type 中输入数据类型。Display type 中选择显示形式，它有text ,list ,combo ,ratio 等几种显示方式. List,

9、combo支持动态的值可以从数据集中选择。Default 中输入默认值。在下面选择参数的一些限制体条件 参数邦定将报表参数和数据集参数邦定，否则参数不起作用。 选择你的table控件 在property Editor （不是propertis中）页中选择binding 栏如下图。点击dataset paramenter binding 按钮进入邦定界面如下图点击value 的按钮进入如下界面进行操作，也可以计算。 其中parameter 表示你在数据集中定义的参数，value表示你在报表中定义的参数。 你可以对报表参数（传入的参数）进行处理，以满足数据集参数的要求。2、 数据排序分组过滤高亮显

10、示 排序 可以在sql语句中加入order by子句，也可以在table的属性中设置。选中要排序的table在property Edit页面点击sorting栏 进入下图：点击添加进入 在sort key 兰中选择相应的列，也可以点击按钮进入表达式设计界面 进行处理 sort Direction 兰中选择排序方式。 分组可以在sql语句中加入order by子句，也可以在table的属性中设置。选中要排序的table在property Edit页面点击group 栏 进入下图：点击add进入 下图，输入名字，分组的列，分页时的动作等。在group分组后table将发生变化如下图： 你可以进行相

11、应的处理。 过滤可以在sql语句中加入where子句，也可以在table的属性中设置。选中要排序的table在property Edit页面点击filter 栏 进入下图：diji 点击添加就可以进新相应的操做了，既可以是列也可以是表达式，变量等 格式化指定的列显示选择你要格式化的控件 在property edit 页面可以格式化你的数据显示形式如下图：3、 分页显示打印和简单的脚本 选中table控件 插入一行空白的detail Row ,将所有的单元格合并 点击script栏 进入 onPrepare 事件中定义变量如下：在空白的detail Row onCreate事件中输入如下代码，2

12、5表示每页最大显示的行数 在有数据detail Row onCreate事件中输入如下代码，style.pageBreakAfter = always; 表示分页时如何处理。如下图选中空白的detail Row 在property栏中选择visibilty，hidden element ,for specific output htnml pression 中输入.另外空白的detail Row 上下2边框必须是solid类型的线否则打印是会有一根线无法打印.4、 预览打印报表 在开发环境下点击preview即可。 在tomcat的环境下 把birt-runtime-2_1_0.zip 解压，

13、把WebViewerExample 拷贝到% tomcat-Home%webapps目录下。把你做好的*.rptdesign 和*.rptconfig文件放于% tomcat-Home%webapps report目录下输入以下的连接Run 是html 的形式显示，看不出分页效果，但利用ie的打印功能可以实现打印的。Frameset 是pdf形式显示，可以看到分页效果的。testEmploy.rptdesign 是你的报表名report 是相对路径的文件夹名http:/127.0.0.1:8080/WebViewerExample/run?_report=report/testEmploy.r

14、ptdesign http:/127.0.0.1:8080/WebViewerExample/frameset?_report=report/userTemplateA.rptdesign带参数时可以直接如下输入，不在调用birt的参数输入框http:/127.0.0.1:8080/WebViewerExample/run?_report=report/userTemplateA.rptdesign&testGroup=BZDLHDBL&testMultParament=6&testCOLMax=60&testColMix=0集成的自己的运用程序中把WebViewerExample 下的所有文

15、件拷贝到自己运用程序的根目录下。、在web.xml文件中的相应位置加入如下代码 BIRT_VIEWER_LOCALE en-US BIRT_VIEWER_WORKING_FOLDER WORKING_FOLDER_ACCESS_ONLY false BIRT_VIEWER_IMAGE_DIR BIRT_VIEWER_LOG_DIR BIRT_VIEWER_LOG_LEVEL OFF BIRT_VIEWER_SCRIPTLIB_DIR BIRT_RESOURCE_PATH BIRT_VIEWER_MAX_ROWS org.eclipse.birt.report.listener.ViewerSe

16、rvletContextListener ViewerServlet org.eclipse.birt.report.servlet.ViewerServlet EngineServlet org.eclipse.birt.report.servlet.BirtEngineServlet ViewerServlet /frameset EngineServlet /run EngineServlet /download EngineServlet /parameter 五、相关的网站点击菜单栏中的help按钮选择 help content 进入帮助页面http:/download.eclipse.org/birt/downloads/build.php?build=R-R1-2_1_0-200606281351http:/download.eclipse.org/birt/downloads/lang.php?build=R-R1-2_1_0-200606281351http:/www.eclipseworld.org/bbs/index.phphttp:/www.eclipseworld.org/bbs/simple/index.php?f73.html