birt教程.docx
《birt教程.docx》由会员分享,可在线阅读,更多相关《birt教程.docx(23页珍藏版)》请在冰豆网上搜索。
![birt教程.docx](https://file1.bdocx.com/fileroot1/2023-5/28/6cc45bac-f2ed-40a2-baf2-fa38d7cc3794/6cc45bac-f2ed-40a2-baf2-fa38d7cc37941.gif)
birt教程
Birt使用说明
目录
1.下载相关的软件1
2.如何创建新的报表及报表模板
●创建报表
●发布模板
3.设置报表的属性1
A、设置报表的样式表
●设置数据信息
●设置数据源。
●设置数据集
●设置输出的列
●设置计算列
●设置数据集的参数
B、设置报表的布局
●几种控件的介绍
C、设置报表的样式表
●倒入样式表单
●设置的控件样式
4.报表的相关处理
A、报表参数
●新加参数
●参数邦定
B、数据排序分组过滤高亮显示
●排序
●分组
●过滤
●格式化指定的列显示
C、预览打印报表
●在开发环境下点击preview即可。
●在tomcat的环境下
●集成的自己的运用程序中
5.相关的网站及帮助的使用
一、下载相关的软件
下载地址:
选择下面的连接开发环境
http:
//download.eclipse.org/birt/downloads/build.php?
build=R-R1-2_1_0-200606281351
Availability
Platform
Download
Windows
birt-report-designer-all-in-one-2_1_0.zip (md5)
下面的连接运行环境
Availability
Platform
Download
All
birt-runtime-2_1_0.zip (md5)
一、在项目中如下图新建一个报表
●创建报表
在下面图中输入报表名称,点击下一步选择报表的类型,最后创建一个新报表。
这里面有不birt系统自带的几种类型也有自己做的模板其中testTemplate是我做的一个简单模板,这里选择特testTemplate模板,将带一些基本的属性给新的报表如下图:
包括数据源,数据集,页面的样式css,分页机制等.如果选择其他的样式类型这些属性将需要自己设置。
●发布模板
将做好的报表可以以模板的形式发布在以后的开发中使用建好的模板。
在outline页面右击做好的报表选择publishtotemplate如下图
进入模板发布页面进行发布
二、设置报表的属性。
创建一个空白报表
1、设置数据信息
●设置数据源。
在dataExplorer标签下点击dataSources进入下图界面输入你的驱动类,数据库的URL,数据库的用户名密码。
点击testConnection测试是否能连接到数据库。
●设置数据集
点击dataSet进入如下界面在数据源(dataSource)一栏中选择你的数据源。
Query一栏中输入你的查询sql语句.在这里可以(一个以上的)带参数。
如select*fromlemis.aa01whereaaa001=?
Andaaa002>=?
如果不带参数则点击previewResult查看数据集的情况。
正确的如下图显示。
●设置输出的列名点击outputcolumns进入下图界面在displayname栏中输入你要在数据表栏中显示的名字。
●设置计算列,在一些报表中可能要对一些列进行计算生成新的列。
点击computercolumn进入如下图:
在columnname一栏中输入你的列名,大厅datatype中输入数据类型。
在Expression中点击按钮进入表达式生成界面如下图:
这里提供了提供了datasets(数据集),javaScript,birt,operators(运算)4种类型计算新列的方法。
输入结束点击ok。
表达式设计界面
●设置数据集的参数
注意:
1它和报表的参数不一样。
2在数据集查询中使用了”?
”参数必须进行参数的设定。
32者之间需要邦定见下面的描述。
点击paraments进入如下界面,输入你的参数名字,数据类型,direction中选择input(表示是输入参数,一般都是input),defaultvalue.
其中defaultvalue.可以是表达式的计算结果。
(点击defaultvalue的按钮可以进入表达式设计界面如上图)
previewResult查看数据集的查询结果。
2、设置报表的布局
在palette中有各种控件,将他们拖到空白的报表上(layout)就可以如下图:
●几种控件的介绍
Lable
标签输入静态文本标签
Text
文本输入静态文本
DLable
动态文本标签显示变量或表达式的值
Dtext
动态文本显示变量或表达式的值
Image
图片可以在报表中插入图片。
Grid
可以用它在报表中设置你的布局。
List
用于在报表中显示list的信息
Table
用以显示你的数据集。
你将你预先定义的数据集拖到table的detail的row中华就可以显示你的数据集grid和table支持行列的合并如下图选中要合并的行列右击选择mergercells即可
Char
用于在报表中显示你的统计图
3、设置报表的样式表
●倒入样式表单
Birt支持css样式表你可以预先定义好各种控件的样式,在报表中统一应用。
在outline中选择style点击倒入按钮进入如下界面倒入你预先设计的css样式单
你必须选择相应样式单前的复选框
●设置的控件样式
选中你要设置的控件或控件组在属性页中点击style选择你倒入的样式
也可以选中控件设置它的样式在property和propertyEditor2个页面中找到对应的样式进行设置。
如果你的界面上没有相关的菜单如下进行设置,调出相应的栏目
四、报表的相关处理
1、报表参数
●新加参数
在outline中选择reportParmament右击进入如下界面
Name中输入参数名,prompttext栏中输入参数的显示名称,tadatype中输入数据类型。
Displaytype中选择显示形式,它有text,list,combo,ratio等几种显示方式.
List,combo支持动态的值可以从数据集中选择。
Default中输入默认值。
在下面选择参数的一些限制体条件
●参数邦定将报表参数和数据集参数邦定,否则参数不起作用。
选择你的table控件在propertyEditor(不是propertis中)页中选择binding栏如下图。
点击datasetparamenterbinding按钮进入邦定界面如下图
点击value的按钮进入如下界面进行操作,也可以计算。
其中parameter表示你在数据集中定义的参数,value表示你在报表中定义的参数。
你可以对报表参数(传入的参数)进行处理,以满足数据集参数的要求。
2、数据排序分组过滤高亮显示
●排序
可以在sql语句中加入orderby子句,也可以在table的属性中设置。
选中要排序的table在propertyEdit页面点击sorting栏进入下图:
点击添加进入在sortkey兰中选择相应的列,也可以点击按钮进入表达式设计界面进行处理sortDirection兰中选择排序方式。
●分组
可以在sql语句中加入orderby子句,也可以在table的属性中设置。
选中要排序的table在propertyEdit页面点击group栏进入下图:
点击add进入下图,输入名字,分组的列,分页时的动作等。
在group分组后table将发生变化如下图:
你可以进行相应的处理。
●过滤
可以在sql语句中加入where子句,也可以在table的属性中设置。
选中要排序的table在propertyEdit页面点击filter栏进入下图:
diji点击添加就可以进新相应的操做了,既可以是列也可以是表达式,变量等
●格式化指定的列显示
选择你要格式化的控件在propertyedit页面可以格式化你的数据显示形式如下图:
3、分页显示打印和简单的脚本
选中table控件插入一行空白的detailRow,将所有的单元格合并
点击script栏进入onPrepare事件中定义变量如下:
在空白的detailRowonCreate事件中输入如下代码,25表示每页最大显示的行数
在有数据detailRowonCreate事件中输入如下代码,style.pageBreakAfter="always";表示分页时如何处理。
如下图选中空白的detailRow在property栏中选择visibilty,hiddenelement,
forspecificoutput
htnmlpression中输入.
另外空白的detailRow上下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.rptdesign
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下的所有文件拷贝到自己运用程序的根目录下。
、
在web.xml文件中的相应位置加入如下代码
BIRT_VIEWER_LOCALE
en-US
BIRT_VIEWER_WORKING_FOLDER
--Ifusrcanonlyaccessthereprotunderworkingfolder.Defaultistrue-->
WORKING_FOLDER_ACCESS_ONLY
false
--Absolutedownloadedimage/chartdirectory.Defaultto${birthome}/report/images-->
BIRT_VIEWER_IMAGE_DIR
--Absoluteenginelogdirectory.Defaultto${birthome}/logs-->
BIRT_VIEWER_LOG_DIR
--Reportengineloglevel-->
BIRT_VIEWER_LOG_LEVEL
OFF
--Absolutedirectorytostoreallbirtreportscriptlibraries(JARs).Defaultto${birthome}/scriptlib-->
BIRT_VIEWER_SCRIPTLIB_DIR
--Absoluteresourcelocationdirectory.-->
BIRT_RESOURCE_PATH
--Previewreportmaxrowslimited.-->
BIRT_VIEWER_MAX_ROWS
--ViewerServletContextListener-->
org.eclipse.birt.report.listener.ViewerServletContextListener
ViewerServlet
org.eclipse.birt.report.servlet.ViewerServlet
EngineServlet
org.eclipse.birt.report.servlet.BirtEngineServlet
ViewerServlet
/frameset
EngineServlet
/run
EngineServlet
/download
EngineServlet
/parameter
五、相关的网站
点击菜单栏中的help按钮选择helpcontent进入帮助页面
http:
//download.eclipse.org/birt/downloads/build.php?
build=R-R1-2_1_0-200606281351
http:
//download.eclipse.org/birt/downloads/lang.php?
build=R-R1-2_1_0-200606281351
http:
//www.eclipseworld.org/bbs/index.php
http:
//www.eclipseworld.org/bbs/simple/index.php?
f73.html