birt教程

Birt使用说明目录1.下载相关的软件12.如何创建新的报表及报表模板●创建报表●发布模板3.设置报表的属性1A、设置报表的样式表●设置数据信息●设置数据源。

●设置数据集●设置输出的列●设置计算列●设置数据集的参数B、设置报表的布局●几种控件的介绍C、设置报表的样式表●倒入样式表单●设置的控件样式4.报表的相关处理A、报表参数●新加参数●参数邦定B、数据排序分组过滤高亮显示●排序●分组●过滤●格式化指定的列显示C、预览打印报表●在开发环境下点击preview即可。

●在tomcat的环境下●集成的自己的运用程序中5. 相关的网站及帮助的使用一、下载相关的软件下载地址：选择下面的连接开发环境/birt/downloads/build.php?build=R-R1-2_1_0-200606281351 Availability Platform DownloadWindows birt-report-designer-all-in-one-2_1_0.zip(md5)下面的连接运行环境Availability Platform DownloadAll birt-runtime-2_1_0.zip(md5)一、在项目中如下图新建一个报表创建报表在下面图中输入报表名称，点击下一步选择报表的类型，最后创建一个新报表。

这里面有不birt系统自带的几种类型也有自己做的模板其中testTemplate是我做的一个简单模板，这里选择特testTemplate模板，将带一些基本的属性给新的报表如下图：包括数据源,数据集,页面的样式css,分页机制等.如果选择其他的样式类型这些属性将需要自己设置。

发布模板将做好的报表可以以模板的形式发布在以后的开发中使用建好的模板。

在outline页面右击做好的报表选择publish to template 如下图进入模板发布页面进行发布二、设置报表的属性。

创建一个空白报表1、设置数据信息●设置数据源。

在dataExplorer标签下点击data Sources进入下图界面输入你的驱动类，数据库的URL，数据库的用户名密码。

点击testConnection测试是否能连接到数据库。

●设置数据集点击dataSet进入如下界面在数据源(data Source)一栏中选择你的数据源。

Query 一栏中输入你的查询sql语句.在这里可以（一个以上的）带参数。

如select * from lemis.aa01 where aaa001=? And aaa002>=?如果不带参数则点击preview Result 查看数据集的情况。

正确的如下图显示。

●设置输出的列名点击output columns 进入下图界面在display name栏中输入你要在数据表栏中显示的名字。

●设置计算列，在一些报表中可能要对一些列进行计算生成新的列。

点击computercolumn 进入如下图：在column name 一栏中输入你的列名，大厅data type中输入数据类型。

在Expression 中点击按钮进入表达式生成界面如下图：这里提供了提供了data sets(数据集)，javaScript ,birt , operators(运算)4种类型计算新列的方法。

输入结束点击ok。

表达式设计界面设置数据集的参数注意：1它和报表的参数不一样。

2在数据集查询中使用了”?”参数必须进行参数的设定。

3 2者之间需要邦定见下面的描述。

点击paraments 进入如下界面，输入你的参数名字，数据类型，direction中选择input （表示是输入参数，一般都是input）,default value.其中default value.可以是表达式的计算结果。

（点击default value的按钮可以进入表达式设计界面如上图）preview Result 查看数据集的查询结果。

2、设置报表的布局在palette 中有各种控件，将他们拖到空白的报表上(layout)就可以如下图：●几种控件的介绍Lable 标签输入静态文本标签Text 文本输入静态文本DLable 动态文本标签显示变量或表达式的值Dtext 动态文本显示变量或表达式的值Image 图片可以在报表中插入图片。

Grid 可以用它在报表中设置你的布局。

List 用于在报表中显示list的信息Table 用以显示你的数据集。

你将你预先定义的数据集拖到table的detail的row中华就可以显示你的数据集grid和table支持行列的合并如下图选中要合并的行列右击选择merger cells即可Char 用于在报表中显示你的统计图3、设置报表的样式表●倒入样式表单Birt支持css样式表你可以预先定义好各种控件的样式，在报表中统一应用。

在outline 中选择style 点击倒入按钮进入如下界面倒入你预先设计的css样式单你必须选择相应样式单前的复选框设置的控件样式选中你要设置的控件或控件组在属性页中点击style选择你倒入的样式也可以选中控件设置它的样式在property 和property Editor 2个页面中找到对应的样式进行设置。

如果你的界面上没有相关的菜单如下进行设置，调出相应的栏目四、报表的相关处理1、报表参数新加参数在outline 中选择report Parmament 右击进入如下界面Name 中输入参数名，prompt text栏中输入参数的显示名称，tada type 中输入数据类型。

Display type 中选择显示形式，它有text ,list ,combo ,ratio 等几种显示方式.List, combo支持动态的值可以从数据集中选择。

Default 中输入默认值。

在下面选择参数的一些限制体条件参数邦定将报表参数和数据集参数邦定，否则参数不起作用。

选择你的table控件在property Editor （不是propertis中）页中选择binding 栏如下图。

点击dataset paramenter binding 按钮进入邦定界面如下图点击value 的按钮进入如下界面进行操作，也可以计算。

其中parameter 表示你在数据集中定义的参数，value表示你在报表中定义的参数。

你可以对报表参数（传入的参数）进行处理，以满足数据集参数的要求。

2、数据排序分组过滤高亮显示●排序可以在sql语句中加入order by子句，也可以在table的属性中设置。

选中要排序的table在property Edit页面点击sorting栏进入下图：点击添加进入在sort key 兰中选择相应的列，也可以点击按钮进入表达式设计界面进行处理sort Direction 兰中选择排序方式。

●分组可以在sql语句中加入order by子句，也可以在table的属性中设置。

选中要排序的table在property Edit页面点击group 栏进入下图：点击add进入下图，输入名字，分组的列，分页时的动作等。

在group分组后table将发生变化如下图：你可以进行相应的处理。

过滤可以在sql语句中加入where子句，也可以在table的属性中设置。

选中要排序的table在property Edit页面点击filter 栏进入下图：diji 点击添加就可以进新相应的操做了，既可以是列也可以是表达式，变量等格式化指定的列显示选择你要格式化的控件在property edit 页面可以格式化你的数据显示形式如下图：3、分页显示打印和简单的脚本选中table控件插入一行空白的detail Row ,将所有的单元格合并点击script栏进入onPrepare 事件中定义变量如下：在空白的detail Row onCreate事件中输入如下代码，25表示每页最大显示的行数在有数据detail Row onCreate事件中输入如下代码，style.pageBreakAfter = "always"; 表示分页时如何处理。

如下图选中空白的detail Row 在property栏中选择visibilty，hidden element ,for specific outputhtnml pression 中输入.另外空白的detail Row 上下2边框必须是solid类型的线否则打印是会有一根线无法打印.4、预览打印报表●在开发环境下点击preview即可。

●在tomcat的环境下把birt-runtime-2_1_0.zip解压，把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.rptdesignhttp://127.0.0.1:8080/WebViewerExample/frameset?__report=report/userTemplateA.rptdesig n带参数时可以直接如下输入，不在调用birt的参数输入框http://127.0.0.1:8080/WebViewerExample/run?__report=report/userTemplateA.rptdesign&te stGroup=BZDLHDBL&testMultParament=6&testCOLMax=60&testColMix=0集成的自己的运用程序中把WebViewerExample 下的所有文件拷贝到自己运用程序的根目录下。

、在web.xml文件中的相应位置加入如下代码<context-param><param-name>BIRT_VIEWER_LOCALE</param-name><param-value>en-US</param-value></context-param><context-param><param-name>BIRT_VIEWER_WORKING_FOLDER</param-name><param-value></param-value></context-param><!-- If usr can only access the reprot under working folder. Default is true --><context-param><param-name>WORKING_FOLDER_ACCESS_ONLY</param-name><param-value>false</param-value></context-param><!-- Absolute downloaded image/chart directory. Default to ${birt home}/report/images --><context-param><param-name>BIRT_VIEWER_IMAGE_DIR</param-name><param-value></param-value></context-param><!-- Absolute engine log directory. Default to ${birt home}/logs --><context-param><param-name>BIRT_VIEWER_LOG_DIR</param-name><param-value></param-value></context-param><!-- Report engine log level --><context-param><param-name>BIRT_VIEWER_LOG_LEVEL</param-name><param-value>OFF</param-value></context-param><!-- Absolute directory to store all birt report script libraries (JARs). Default to ${birthome}/scriptlib --><context-param><param-name>BIRT_VIEWER_SCRIPTLIB_DIR</param-name><param-value></param-value></context-param><!-- Absolute resource location directory. --><context-param><param-name>BIRT_RESOURCE_PA TH</param-name><param-value></param-value></context-param><!-- Preview report max rows limited. --><context-param><param-name>BIRT_VIEWER_MAX_ROWS</param-name><param-value></param-value></context-param><!-- V iewer Servlet Context Listener --><listener><listener-class>org.eclipse.birt.report.listener.ViewerServletContextListener</listener-cl ass></listener><servlet><servlet-name>ViewerServlet</servlet-name><servlet-class>org.eclipse.birt.report.servlet.V iewerServlet</servlet-class> </servlet><servlet><servlet-name>EngineServlet</servlet-name><servlet-class>org.eclipse.birt.report.servlet.BirtEngineServlet</servlet-class> </servlet><servlet-mapping><servlet-name>ViewerServlet</servlet-name><url-pattern>/frameset</url-pattern></servlet-mapping><servlet-mapping><servlet-name>EngineServlet</servlet-name><url-pattern>/run</url-pattern></servlet-mapping><servlet-mapping><servlet-name>EngineServlet</servlet-name><url-pattern>/download</url-pattern></servlet-mapping><servlet-mapping><servlet-name>EngineServlet</servlet-name><url-pattern>/parameter</url-pattern></servlet-mapping>五、相关的网站点击菜单栏中的help按钮选择help content 进入帮助页面/birt/downloads/build.php?build=R-R1-2_1_0-200606281351 /birt/downloads/lang.php?build=R-R1-2_1_0-200606281351 /bbs/index.php/developerworks/cn/opensource/os-ecl-birt//bbs/simple/index.php?f73.html/blog/more.asp?name=sixsun&id=13933。