商务智能BIRT中文指南

（商务智能)BIRT中文指南BIRT中文指南BIRT-简介BIRT是一个Eclipse-basedJava与J2EE的Web应用程序上。BIRTEclipse的报表设计和一个可以加到你应用服务的运行期组件。BIRT同时也提供一个图形报表制作引擎。URL:URL:BIRT报表中文指南前言这个指南将引导你设计一个简单的报表，令你对BIRT报表系统有个感性的认识，如果想进一步了解BIRT的使用可以参考BIRT在Eclipse中自带的帮助，SelectHelp→HelpContentsfromtheEclipsemenuandthenclickontheBIRTDeveloperGuide.个人体验BIRTXML源，布局，预览，脚本多个设计布局；功能并不逊色与商业报表工具；CSSCSS色的报表样式；灵活的条件格式定义(formattingrule)，可以方便的根据业务逻辑来动态格式话报表元素；集成在Eclipse中，不用再开启别的报表开发工具窗口；BIRE的本地化做的很好，安装以后操作界面就是中文的；开源的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制；不足之处，毕竟是国外的报表工具，与中国的报表在理念上还是有很多不同，国外要是作为个人业绩的的一种炫耀吧，更注重报表的样子而不是样式。所以早期的Html设计都喜欢采用table来作为元素定位的工具，而table的初衷可能只是作为数据显示的容器BIRT能增加一些符合国内报表开发的功能，比如说画线，带斜线的表头等等。BIRT-指南目录BIRTTutorialIntroductionCreatingaReportBriefUITourBuildingaDataSourceBuildingaDataSetBuildingaTableTestingYourReportSettingVisualPropertiesSettingDataPropertiesUsingStylesCascadingStylesUsingaGridUsingaTextItemNextStepsBIRT安装指南安装方式一下载一个BIRTAll-in-one版本的Eclipse，包含了运行BIRT系统所需的组件，URL:birt-report-designer-all-in-one-2_0_1.zip安装方式二假设你已经知道如何安装Eclispe插件(建议采用Link全部一股脑的将各种插件都解压到Eclipse的目录中去)运行BIRT报表系统需要以下软件或插件Java1.4.2/1.5JDK/JREEclipse-SDK-3.1.2-win32GraphicsEditorFramework(GEF)runtimeEclipseModelingFramework(EMF)runtimeBIRTiText1.3-复制itext-1.3.jar文件到plugins/...pdf_version/lib目录.v1.4.0-复制文件到plugins/..viewer_versionajax/lib目录其他BIRT提供的一个Flash格式的安装演示，也可以照着这个演示来安装：）BIRT网站提供的安装指南BIRT指南－介绍介绍这个简要的指南将引导你用BIRTUI特点和大多数BIRT,您应该能开始使用自己的数据库建立自己的报表。我们将创造一个简单的顾客目录报表,报表通过州和城市对用户进行分组。对于每一名顾客,我们将显示他的名字和电话号码。报表效果如下：安装BIRT如果您还没有这样做,请先安装EclipseGEFEMF和BIRTBIRT的安装页面发现完整的安装介绍。打开BIRTBIRT在Eclipse中以透视图（perspective）的方式显示。使用Eclipse主菜单Window“打开透视图（OpenPerspective,然后是“报表设计（ReportDesign“报表设计（ReportDesign“打开视图（OpenPerspective）选项卡中,可以选择其他（other）...所有的Perspective名单将会列出来。选择“报表设计”（ReportDesign）。Eclipse将切换显示BIRT视图。报表样板如果您想要立即看到一份已经完成的报表,只需要简单地下载下面那个链接:使用您的浏览器下载报表:.保存文件到一个Eclipse的项目目录。(如果您没有建立一个项目，请参见下一章节（将引导你如何建立一个项目）。)您的浏览器可能会将它作为一个XML文件保存。如果那样的话,将其重命名为上面的名称（）。在Eclipse中,在NavigatorView中选择您的项目，并通过鼠标右键单击弹出菜单，选择Refresh选项（将刚才复制到项目里面的文件刷新显示出来）。双击报表将会用BIRT报表设计器打开它。BIRT指南－创建一个报表创建一个报表创建一个项目创建一个报表选择模板创建一个项目Eclipse使用项目组织您的文件。因此,第一步将创建一个新项目。作为演示,我们创建项目叫做"MyReports":->选择File->New->Project。新项目（newproject）对话出现。->打开"业务智能和报表工具”（BusinessIntelligenceandReportingTools）组，并选择"报表项目"。->点击下一步（next）。->输入"MyReports"(不要有引号)作为项目名字。->点击结束（Finish）。->点击OK，提示你切换到报表设计视图。创建一个报表我们现在准备好创建我们的第一份报表:选择File->New->Report。新建报表（newreport）对话出现。在TreeView中选择我们之前创建的项目：MyReports接下来在文件名字段输入:点击next。:一个空白的报表,使用BIRT定义的报表模板,或复制您之前已经设计好的报表。在这份教学指南中我们将使用报表模板创建报表。选择模板,我们先来了解一下它们。->MyFirstReport(我的第一份报表)->空白报表-创建一个无预定义内容的空白报表。->简易列表-使用数据源中的字段创建列表报表。->分组列表-创建一个根据某些字段分组的列表报表。分组列表不会显示重复的记录。并且分组允许您创建一个子统计。->双列列表-创建带两个子组的分组报表。->图表和类标-创建分组报表，并附带直观表示每个组数据的图表。->双列图表和列表-创建带两个“图表和列表”子组的分组报表->并排图表和列表-创建一个分组报表，其中，每个组都并排包含一个图表和一个列表->信件-Aformletterinwhichdatabasedatais"mail-merged"intothetext.ThelettertextcanbeformattedusingasubsetofHTML.我们现在准备选择我们需要的模板：->选择GroupedListing.（分组列表）。->点击Finish。BIRT在Eclipse工作区打开您新建的报表。BIRT指南－UI漫游UI漫游->BriefUITour->CheatSheets->LayoutEditor（布局编辑器）->Views->DisplayingViews在我们开始在报表的工作之前,我们快速介绍一下BIRT到构建报表时候需要的大多数操作界面。CheatSheets注意在您的Eclipse工作区右边(这是默认配置)有一个CheatSheetsView"这个View会根据您所选择的模板引导你如何构建报表。（BIRT做的很人性化，操作界面也是国际化的，安装后你会发现界面是中文的:)）布局编辑器(LayoutEditor)中心地区是布局编辑器。这是您进行报表设计的主要地方。编辑器有三个分页:布局-您做报表设计的地方。预览-运行您的报表并在输出设备显示出来。脚本-增加JavaScript脚本到您的报表来定制它的行为。Views在编辑器附近有多个View:View可以部署在布局编辑器附近。->调色板（Palette）-显示标准的报表可视控件，您能够通过拖曳的方式添加到你的报表上。->概述（Outline）-使用treeview的形式显示您的报表结构。->导航（Navigator）-Eclipse将显示你的项目和项目内的报表文件。->数据资源管理器-BIRTView显示您的数据源(连接),数据集(queries)和报表参量。您也可以使用这个View增加数据集字段到您的报表布局（reportlayout->属性编辑器-显示报表项目所需的properties来组织properties。->PropertiesView-显示和报表相关Properties，这个view是可选的，我们在这个指南里面不会用到它。DisplayingViews您能安排您的Views已任意的方式布局。您能点击"X"按钮掩藏他们。如果您不小心隐藏了一个View,Window->ShowView人发现一种方便的布局方式，将调色板（Palette,Navigator,Outline,数据资源管理器(DataExplorer)放在您的工作区左边缘,PropertyEditor）和属性View(PropertiesView)靠在工作区的底部。BIRT指南－建立数据源建立数据源编辑您的数据源关于数据源和数据集关于数据源和数据集BIRT报表使用一个数据源连接到数据库或其它数据提供者。BIRT使用一个数据集从数据提供者处的检索数据。可以将数据源理解为连接,数据集作为query。建立数据源让我们建立一个数据源:打开数据资源管理器。选择数据源节点。用鼠标右键单击打开弹出菜单。选择新建数据源。新建数据源对话出现。选择ClassicModelsInc.示例数据库在数据源名称输入框,输入"Sample"。点击next。点击Finish。您的新建的数据源出现在数据资源管理器(DataExplorer)内。编辑您的数据源作为将来的参考,我们回顾一下您将如何改变数据源:打开数据资源管理器打开数据源节点。双击数据源。数据源编辑器被打开。您能做所有有需要的更改。点击OK保存您的变动。BIRT指南－建立数据集建立数据集数据集编辑器页数据库浏览器创造Query测试Query编辑一个数据集建立数据集现在我们准备好建立和测试我们的数据集。打开数据资源管理器选择数据集节点。用鼠标右键单击打开弹出菜单。选择新建数据集。新建数据集对话将出现。“在数据集名称”输入框，输入"Customers"。确保数据源下拉框显示的是我们之前创建的Sample数据源。确保数据集类型下拉框选中的是"SQLSelectQuery"。点击Finish。数据集编辑器页数据集编辑器现在打开了。我们将使用它来定义我们的quary。数据集编辑提供以下选项:查询-显示您的SQLSelectSQLquary的地方。一旦您有基本的quary,您能增加WHERE子句,调整所选择的字段集，等等。使用SQLSQL别名子句给这样的字段命一个名字。数据源-显示这个数据集所属的数据源名字，您能查看或改变它。预览结果-测试您的查询和观看输出的结果的地方。可以在您继续进行报告设计之前确保数据是正确的。计算列-计算字段由BIRTJavaScript表达式,及调用业务逻辑。参数-SQLSELECT中他们被标记为SQL的"?"符号。你可以各参数设置一个名字，设置一个默认值等操作。参数必须与你的SQL"?"符号一一对应。过滤器-附加的过滤器将应用于您的数据。过滤器约束传递到报表上的数据。Where子句也是过滤器:由数据库执行。这个选项卡让您使用BIRT的JavaScript脚本语言定义附加的过滤器。输出列-根据查询显示Columns,并让您定义一个Column别名给报表使用。注意这个view显示的Columns将是报表所能看见的。查询选项卡显示着能能从数据库选择的Columns。数据库浏览器切换到查询页。这个选项卡提供一个简单的数据库浏览器。展开Sample的数据源查看这个数据库的schemas。有一个:"CLASSICMODELS"。展开"CLASSICMODELS"查看数据库的tables列表。展开table看它的column。可以拖拽一个table或column增加它的名字到SQL编辑器。创造查询我们的查询非常简单,因此我们将键入:简单的查询SELECT*FROMCUSTOMERSWHERECOUNTRY='USA'测试查询打开数据集编辑器,跟着下面来做:点击预览结果选项。预览页将出现。这页显示了您在查询中选择的字段和查询结果。核实一下顾客名单列表是否正确。点击OK关闭数据集编辑器。如果错误对话出现,检查以下:您的Eclipse被安装在空间不足的目录。您是否依照上面输入正确的SQL语句。您未用分号结束您的语句。编辑一个数据集辑器改变数据集,并且测试它确保它返回正确的数据。找到或打开数据资源管理器。打开数据集节点。双击Customers数据集。数据集编辑被打开。BIRT指南－构建Table报表布局报表项构建Table细节构建StateGroup构建CityGroup增加TableColumn构建列标题（ColumnHeadings）报表布局我们的customerlistingreport将以“表”的形式显示客户信息:类似HTMLTable,附加了能够循环显示报表数据的能力。我们选择的GroupedListing模板预先为我们构建了一个“表”,我们只需要再填装一些细节。在开发报表之前,让我们介绍一下BIRT的报表项。报表项BIRT提供各种各样的报表项用于构建我们的报表。报表项出现在Paletteview。报表项有:标签-插入一个静态的文本。文本-插入文本块(纯文本或HTML信格式,"邮件合并"等。动态文本-插入带有可选CLOB数据表达式的文本块。支持通过表达式对advancedCLOB数据进行操作。数据-插入数据集列或表达式结果。图象-,或链接到你的网络服务器上的一个文件。网格-提供报表项的表格布局,很象HTMLTable。列表-在页眉、详细信息、页脚区段中插入数据集行的灵活格式表示。表-以Table的形式呈现数据集中的数据。图表-显示商业图表，如饼图、折线图,等。这个指南将使用到大多数元素,除了列表、图表和动态文本。构建明细表新建报表对话构建了一个已经包含“表的初始报表和一级分组。如果我们选择创建一个空白的报表,我们也能够通过简单地由palette扯拽得到Table。“表”detailband每一条记录。:浏览数据资源管理器，如果它还没有打开的话。展开数据集节点。展开我们构建的Customers数据集实体。这将显示数据集中可用到的columns。选择CUSTOMERNAMEcolumn。在“表”中找到明细数据行。(它是一个灰色"明细数据行"标签。)然后扯拽CUSTOMERNAMEcolumn到明细数据行的左边第二个单元格。注意,报表设计器自动地增加对应的表头。扯拽PHONEcolumn到明细数据行的最右边的单元格。构建State分组我们想要我们的客户报表根据State字段分组,然后按照city将导致所有具有同样State的数据行出现在一起。在“表”里面找到“组页眉行”。它有一个浅灰色的"组页眉行"标签。扯拽STATEcolumn到“组页眉行”的最左边的单元格。构建你自己的分组palette扯拽得到Table,一个分组之前您必须将Table,如果您自己构建了一个表,您能够在属性编辑器中使用“绑定”面板将一个表绑定到数据集。构建City分组其次,我们还将构建一个CityState后是City。将光标悬停在表上将会有一个“表”图表显示出来。点击“表用鼠标右键单击state组页眉的“行标题”，出现一个弹出菜单从弹出菜单选择“插入组->在下面”，弹出“新建组”对话框选择了“分组依据”中选择"CITY"，在名字字段输入"City"。点击OK。增加表列我们需要另一个表列来显示我们的组页眉:确保表的脚手架出现。用鼠标右键单击第一列的标题上方的阴影部分。在弹出菜单中选择“插入->往右侧插入列”。将出现一个新的列。拖拽row["CITY"]表达式，移动到第二个“组页眉行”的第二列，构建列标题我们需要重新定义一下我们的列标题。通常BIRT会为我们的每一个列增加一个默认的列标题。双击在第一列标题的文本改变它。输入"州"，按回车确定。从palette扯拽一个标签到第二个列标题,键入"城市"，按回车确定。将第三个列标题改为"名字"。将第最后一个列标题改为"电话"。BIRT指南－测试您的报表测试您的报表以HTML格式预览以PDF格式预览测试您的报表我们现在准备好测试报表布局。我们之前已经核实过数据集了,我们现在要做的就是验证一下报表是否向我们期望的那样将数据显示出来。我们点击报表编辑器左下角的“览预”分页。这个报表没有参量,如果有的话可以选择“显示报表参量”按钮来修改。这时会出现一个嵌入式的浏览器窗口,以HTML运行时最好使用较小的数据集。因为示例数据库有相当多的数据,所以我们之前使用了一个WHERE器限制数据每次的输出量。以下方式能改变报表的外观：在报表的上面增加一个标题。给列标题增加一些颜色。缩进city和state列。给city和state的主页眉行增添一些颜色。格式化电话号码。根据顾客名称排序。在我们做这些外观改进之前,我们看一下其它的报表预览方式。以HTML格式预览预览分页能够快速的预览你的报表。每当你切换至预览界面，BIRT将运行报表。但是,布局和预览分页一次只能显示一个，不能同时打开（不能向Dreamweaver等工具那样拆分设计窗口和预览窗口）。展开。你能够在一个独立的窗口以HTML形式预览报表。这允许您的布局编辑器和预览页面之间反复切换，而不用重新启用报表。在Web查看器中预览这个选项与上面相类似。它允许报表使用BIRT的WebViewer在一个独立的窗口以HTML形式预览报表。WebViewer提供强有力的导航功能，比如TOC,PreviousPage,NextPage,GotoPage以及search和export功能。预览报表在网观察者使用工具栏预览按钮和选择网观察者选择或供选择地祈求文件>Preview在网观察者。BIRT指南－设置可视化控件是属性重设表-页眉（TableColumns）尺寸设置背景颜色设置字体格式化数据设置边框更多在属性设置重设表-页眉（TableColumns）尺寸我们调整表-页眉的大小。表&列可以使用绝对大小(英寸,厘米),或相对大小(页的宽度的百分比。)这里,:点击布局切换回到布局窗口。然后点击“表”显示出"脚手架。可以看到城市"和"州"之间的列标题由一条黑色的线分隔开。将光标移动到这条线,可以拖动鼠标左键来重设尺寸。重覆上面的操作调整“城市”列的宽度。设置背景颜色让我们来装饰一下“州“颜色”。请跟着下面操作:选择row["STATE"]主页眉行(即第一个主页眉行)，点击这个主页眉行最左边的淡紫色格子。(记住首先要显示出表的脚手架。)打开属性编辑器。窗口的左边列出了一个属性类型列表。点击“常规。找到“背景色”输入框。点击空白的灰色按钮来显示一个颜色拾取器。从最上面一行往右第三个拾取框获得蓝色。这是一种标准颜色,但是颜色太深，不是我们想要的。点击"规定自定义颜色"按钮。滑动最右端的滑动条设置颜色的饱和度，获得一个浅兰色。点击确定。设置字体现在,我们给“州”设置一个较粗的字体。我们还将装饰row["CITY"]主页眉行，使用深蓝,较大,粗的字体。请跟着下面操作:选择row["STATE"]数据项。(它位于在“州”标签下。)切换到“属性编辑器”的“常规”选项。找到“字体大小。将字体改为"大"。点击[B]给字体加粗。选择row["CITY"]据项。再次切换到“属性编辑器”的“常规”选项。设置字体设置为"大"。点击字体颜色按钮。打开颜色拾取器。从最上面一行往右第三个拾取框获得蓝色。点击确定。格式化数据我们将要格式化电话号码，以便他们符合北美的电话格式:(123)555-1212将应用一个字符串格式到电话号码。格式还可以应用与日期和数字。选择电话号码列:row["PHONE"]。切换到“属性编辑器”的“字符串格式”选项。选择“字符串格式”为“自定义。选择“电话号码。在格式代码输入框中,出现以下格式:(@@@)@@@-@@@@设置边框这次,我们给表增添一个“"dropshadow”样式的边框。点击“表。切换到“属性编辑器”的“边框”选项。设置样式为实线。(这是缺省的。)设置颜色为黑色。(使用颜色下拉框,或选择左边的颜色拾取器。)(这是缺省。)设置宽度为细线条。点击上框线,下框线,左右框线按钮。一个细线条的边框出现在表周围。切换到Propertiesview(window>ShowView>Properties),出现一个更为详细的属性设置视图。点击“表”将会用“表”的属性来初始化这个Propertiesview。展开Propertiesview的属性节点，设置“框->下边框宽度和左边框宽度”为medium。更多属性设置BIRT提供了丰富的属性用来格式化报表项。属性是基于W3CCSS(级联样式表)的标准。如果您曾经使用过CSS格式化HTML,那您将很容易理解BIRT的格式。当前报表布局样式当前报表预览样式BIRT指南－级联样式关于级联样式设置报表属性其他默认样式检查报表关于级联样式我们曾经提及,BIRT使用CSS为报表项定义样式,并且我们演示了如何定义和应用一个我们自己的样式。BIRT同样遵循CSS的"级联":您一旦为报表或容器设置了属性,则这些属性值会级联应用于这个容器所包含的内容。在BIRT中,网格、列表和表都是容器:他们能够包含其他的报表项。报表本身是所有报表项最终的容器。设置报表属性我们的报表当前使用缺省字体:serif样式。(实际上,BIRT在您的浏览器中使用serif样式,但如果您改变了缺省的浏览器字体,那么报表将会如何显示呢。)我们改为使用sans-serif样式。我们使用一个BIRT预定义的样式调用报表,为报表项指定缺省样式。如果您熟悉CSS,就好像是在为HTMLbody标签定义样式。打开Outlineview。拖动滚动条到底部找到样式节点。打开样式结点。用鼠标右键单击和选择新建样式。在“常规”页,选中预定义样式的单选按钮并从下拉列表选择"report"。点击OK在Outlineview的样式结点找到一个命名为"report"打开样式编辑器。在字体区域,选择"SansSerif"作为字体类型。点击OK。您的报表的所有项都将变成sans-serif字体。"serif"和"sans-serif"是由CSS定义的:器上的特殊字体。CSS字体应避免依赖特殊的字体;如果您的报表将作为一个公开网站的一部分发布的话，这一点很重要。您可以在CSS定义一个字体名单。例如:"Helvetica,Arial,sans-serif"。其他默认样式BIRT为多数报表项定义了缺省样式。详细参考ROMStylesSpecification。样式结点显示的风格能够应用于每一个报表项。但是,还有一些附加样式是适用于组级别和其他内容的。如果您希望使用这当中一个,简单地创造样式和必需的名字。检查报表我们点击“预览”查看我们的报表样式。还不错,但我们还需要一个更好的报表标题。BIRT指南－使用网格创建一个网格行属性列属性插入一张图片插入运行期日期（即运行报表时候的日期）创建一个网格给我们的报表添加一个恰当的标题.我们使用经典的“左/中/右布局:logo放在左边,报表名称放在中间,当前日期放在右边.实现这个效果之前我们先把当前那个“ReportHeader”简陋的标题删除掉.请跟着下面操作:选中“表”上方那个包含“ReportHeader”文本的网格，单击右键，在弹出菜单中选择“删除”选项，将这个网格删掉。创建“左/中/右Html的table（早期我们常用table来做网页元素的定位），在这个例子中，我们插入一个两行三列的网格。从palette中拖拽“网格“表“插入网格”对话框选择两行三列。点击确定。行属性我们将使用第一行来包含标题内容，第二行作为标题与报表之间的间隔。选中网格的第一行（是整行选中，不是某个单元格）。在属性编辑器的“常规”属性页中，设置“垂直对齐”为“顶部”。选中网格的第二行。在属性编辑器的“常规”属性页中，设置“高度”为0.25英寸（我们一般不会用这种尺寸单位吧：））.列属性我们让三列各占报表页的1/3宽，并且居左，居中，居右对齐。列了）这时候会切换到“属性编辑器-列”的“常规”属性页中，注意到当前宽度是没有被设置的.向Html一样,如果列的宽度没有设置,BIRT将根据列中的内容来设置尺寸。设置列的宽度为33%.在“宽度”中输入33,在旁边的下来菜单中选择“%”。选择中间那列。重复上一步的操作，同样设置宽度为33%。在属性编辑器的“常规”属性页中,设置文本对齐方式