Eclipse Birt报表指南.doc

BIRT -简介BIRT是一个Eclipse-based开放源代码报表系统。它主要是用在基于Java与J2EE的Web应用程序上。BIRT主要由两部分组成：一个是基于Eclipse的报表设计和一个可以加到你应用服务的运行期组件。BIRT同时也提供一个图形报表制作引擎。 URL: /birt/ 前言这个指南将引导你设计一个简单的报表，令你对BIRT报表系统有个感性的认识，如果想进一步了解BIRT的使用可以参考 BIRT在Eclipse中自带的帮助， Select HelpHelp Contents from the Eclipse menu and then click on the BIRT Developer Guide.如图个人体验 操作界面友好大方，小图标都很漂亮：）； 功能并不逊色与商业报表工具； CSS提供了强大灵活的样式定义，对于属性CSS的设计人员来说，应该可以设计出相当出色的报表样式； 集成在Eclipse中，不用再开启别报表开发工具窗口； BIRE的本地化做的很好，安装以后操作界面就是中文的； 开源的报表产品，降低开发成本，一些报表开发工具除了价格昂贵以外，还有用户限制； BIRT 安装指南安装方式一下载一个BIRT All-in-one版本的 Eclipse，包含了运行BIRT系统所需的组件，最方便了（如果是将报表工具培训一下让非开发人员参与定制话可以这样做：） URL:birt-report-designer-all-in-one-2_1_1.zip 安装方式二假设你已经知道如何安装Eclispe插件(建议采用Link的方式安装插件，不至于全部一股脑的将各种插件都解压到Eclipse的目录中去) 运行BIRT报表系统需要以下软件或插件 Java 1.4.2/1.5 JDK/JRE Eclipse-SDK-3.1.2-win32 及以上版本 Graphics Editor Framework (GEF) runtime Eclipse Modeling Framework (EMF) runtime BIRT iText 1.3 - 复制 itext-1.3.jar 文件到 plugins/org.eclipse.birt.report.engine.emitter.pdf_version/lib 目录. prototype.js v1.4.0 - 复制prototype.js 文件到 plugins/org.eclipse.birt.report.viewer_version/birt/ajax/lib 目录 其他 BIRT提供的一个Flash格式的安装演示，也可以照着这个演示来安装：） BIRT 网站提供的安装指南 运行报表（tomcat/weblogic/jboss）Birt使用入门1. 环境l 报表设计器：可以到/birt/downloads/下载最新版本，当前的最新版是birt-rcp-report-designer-2_1_1。将下载来的zip压缩包解压到相应的目录，如：E:birt-rcp-report-designer-2_1_1。l 可运行环境：可以到/birt/downloads/下载最新版本，当前的最新版是birt-runtime-2_1_1。将其解压到相应目录，如：E:birt-runtime-2_1_1。l 可运行服务器：本人采用的是Tomcat5.0weblogic8.1.4及以上版本，jdk1.4.2。其他：下载所需要的jar包itext-1.3.jar，iTextAsian.jar和，Copy itext-1.3.jar, iTextAsian.jar to brit/WEB-INF/platform/plugins/com.lowagie.itext/lib.2. 简单报表例子步骤如下：l 打开报表设计器：运行E:birt-rcp-report-designer-2_1_1目录下的birt.exe文件。报表设计器页面如下图所示：l 新建报表：打开菜单“文件新建新建报表”，如图所示：弹出新报表属性设置框口，如下图所示：在文件名输入框中输入报表名称：如：test.rptdesign.同时也可以设置报表文件的存放路径，本人采用默认设置：E:birt-rcp-report-designer-2_1_1workspace。电击“next”进入下一步设置，如图所示：选择新建报表所要采用的报表模板：空白报表。到此报表的基本信息已经设置完，如果不需要设置其他内容，则可以点击“Finish”按钮，如果还需要设置其他内容，点击“Next”按钮，进入下一步设置，如图所示：此步的作用是：将报表内容转换成模板时所需要的信息，输入相应信息。也可以不用填写，点击“Finish”按钮完成新报表的基本信息设置。这样就建好了一张空白的报表。如图所示l 设置报表选择“数据库资源管理器”视图，如果没有，可以点击菜单“窗口”“显示视图”“数据库资源管理器”，同样也可以打开“数据库资源管理器”。如图所示：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”下的列到表的相应明细数据行，如图：拖完后点击“预览”，在编辑区就可以看到报表数据，如图：这样一个简单的报表就做出来了。l 运行报表（tomcat5.0以上）1) 将E:birt-runtime-2_1_1Web Viewer Example文件夹拷贝到应用服务器的E:Tomcat5.0webapps目录下，并修改此文件夹名为“birt”。2) 将驱动程序包“或classes12.jar”拷贝到E:Tomcat5.0webappsbirtWEB-INFlib下。3) Copy itext-1.3.jar to brit/WEB-INF/platform/plugins/com.lowagie.itext/lib.4) Copy iTextAsian.jar to / brit /WEB-INF/platform/plugins/com.lowagie.itext/lib. 5) 将E:birt-rcp-report-designer-2_1_1workspace包下的test.rptdesign文件拷贝到E:Tomcat5.0webappsbirt下。6) 启动服务器：运行E:Tomcat5.0binstartup.bat文件7) 打开浏览器，在地址栏输入：:8080/birt/frameset?_report=test.rptdesign，即可以看到数据，如图：到此一张简单的报表完成。l 运行报表（weblogic8.1.4以上）8) 将E:birt-runtime-2_1_1WebViewerExample部署到应运服务器，并修改此文件夹名为“birt”。9) 将驱动程序包“ojdbc.jar或classes12.jar”以及拷贝commons-logging.jar到E:birt-runtime-2_1_1birtWEB-INFlib下。10) Copy itext-1.3.jar to brit/WEB-INF/platform/plugins/com.lowagie.itext/lib.11) Copy iTextAsian.jar to / birt /WEB-INF/platform/plugins/com.lowagie.itext/lib. 12) 启动服务器：运行weblogic13) 打开浏览器，在地址栏输入：:7001/birt/frameset?_report=test.rptdesign，即可以看到数据BIRT 指南介绍介绍这个简要的指南将引导你用BIRT建立一个简单的报表。 它介绍了主要的UI 特点和大多数 BIRT 报表元素。 完成这份教学指南, 您应该能开始使用自己的数据库建立自己的报表。 我们将创造一个简单的顾客目录报表, 报表通过州和城市对用户进行分组。 对于每一名顾客, 我们将显示他的名字和电话号码。 报表效果如下： 安装BIRT如果您还没有这样做, 请先安装Eclipse、GEF 、EMF 和BIRT 。 您会在 BIRT 的安装页面发现完整的安装介绍 。 打开BIRTBIRT 在Eclipse中以透视图（perspective ）的方式显示。 使用Eclipse主菜单的（Window ）选项打开它。 选择“打开透视图”（Open Perspective）, 然后是“报表设计”（Report Design）。 如果“报表设计”（Report Design） 没直接出现在“打开视图”（Open Perspective）选项卡中, 可以选择其他（other）. 所有的 Perspective 名单将会列出来。 选择“报表设计”（Report Design）。 Eclipse将切换显示BIRT视图。 BIRT 指南创建一个报表创建一个报表 创建一个项目 创建一个报表 选择模板 创建一个项目Eclipse 使用项目组织您的文件。 因此, 第一步将创建一个新项目。 作为演示, 我们创建项目叫做My Reports: 选择 File-New-Project 。 新项目（new project ）对话出现。 打开业务智能和报表工具”（Business Intelligence and Reporting Tools）组，并选择报表项目 。 点击下一步（next）。 输入My Reports (不要有引号) 作为项目名字。 点击结束（Finish）。 点击 OK ，提示你切换到报表设计视图。 创建一个报表我们现在准备好创建我们的第一份报表: 选择File-New-Report 。 新建报表（new report ）对话出现。 在Tree View中选择我们之前创建的项目：My Reports 接下来在文件名字段输入: Customers.rptdesign 点击 next。 您能创建一个报表用三种方式: 一个空白的报表, 使用BIRT 定义的报表模板, 或复制您之前已经设计好的报表。 在这份教学指南中我们将使用报表模板创建报表。 选择模板新建报表对话框显示了一些现成的模板模板。 在我们选择使用哪个报表模板之前, 我们先来了解一下它们。 My First Report(我的第一份报表) 空白报表- 创建一个无预定义内容的空白报表。 简易列表- 使用数据源中的字段创建列表报表。 分组列表- 创建一个根据某些字段分组的列表报表。 分组列表不会显示重复的记录。 并且分组允许您创建一个子统计。 双列列表- 创建带两个子组的分组报表。 图表和类标- 创建分组报表，并附带直观表示每个组数据的图表。 双列图表和列表- 创建带两个“图表和列表”子组的分组报表 并排图表和列表- 创建一个分组报表， 其中，每个组都并排包含一个图表和一个列表 信件- A form letter in which database data is mail-merged into the text. The letter text can be formatted using a subset of HTML. 我们现在准备选择我们需要的模板： 选择Grouped Listing.（分组列表）。 点击 Finish。 BIRT 在Eclipse工作区打开您新建的报表。 报表样板如果您想要立即看到一份已经完成的报表, 只需要简单地下载下面那个链接: 使用您的浏览器下载报表: customers.rptdesign. 保存文件到一个Eclipse的项目目录。 (如果您没有建立一个项目，请参见下一章节（将引导你如何建立一个项目）。) 您的浏览器可能会将它作为一个XML 文件保存。 如果那样的话, 将其重命名为上面的名称（customers.rptdesign）。 在Eclipse中, 在Navigator View中选择您的项目，并通过鼠标右键单击弹出菜单，选择 Refresh 选项（将刚才复制到项目里面的customers.rptdesign文件刷新显示出来）。 双击报表将会用 BIRT 报表设计器打开它。 BIRT 指南UI 漫游UI 漫游 Brief UI Tour Cheat Sheets Layout Editor（布局编辑器） Views Displaying Views 在我们开始在报表的工作之前, 我们快速介绍一下BIRT的开发界面。 我们会接触到构建报表时候需要的大多数操作界面。 Cheat Sheets注意在您的Eclipse工作区右边(这是默认配置)有一个Cheat Sheets View。这个 View 会根据您所选择的模板引导你如何构建报表。 （BIRT做的很人性化，操作界面也是国际化的，安装后你会发现界面是中文的:)） 布局编辑器(Layout Editor)中心地区是布局编辑器。 这是您进行报表设计的主要地方。 编辑器有三个分页: 布局- 您做报表设计的地方。 预览- 运行您的报表并在输出设备显示出来。 脚本- 增加 JavaScript 脚本到您的报表来定制它的行为。 Views在编辑器附近有多个View: View可以部署在布局编辑器附近。 调色板（Palette）- 显示标准的报表可视控件，您能够通过拖曳的方式添加到你的报表上。 概述（Outline）- 使用tree view的形式显示您的报表结构。 导航（Navigator）- Eclipse将显示你的项目和项目内的报表文件。 数据资源管理器 - BIRT View 显示您的数据源(连接), 数据集 (queries) 和报表参量。 您也可以使用这个View增加数据集字段到您的报表布局（report layout）。 属性编辑器 - 显示报表项目所需的properties。 它拥有标签和分组，用分类的形式来组织properties。 PropertiesView - 显示和报表相关Properties ，这个view是可选的，我们在这个指南里面不会用到它。 Displaying Views您能安排您的Views已任意的方式布局。 您能点击 X 按钮掩藏他们。 如果您不小心隐藏了一个View, 您能再次显示它，使用Window-Show View 菜单选项。 许多人发现一种方便的布局方式，将调色板（Palette）, Navigator, Outline , 数据资源管理器(Data Explorer)放在您的工作区左边缘,属性编辑器（Property Editor）和属性View(Properties View)靠在工作区的底部。 BIRT 指南建立数据源 建立数据源 编辑您的数据源 关于数据源和数据集 关于数据源和数据集BIRT 报表使用一个数据源连接到数据库或其它数据提供者。 BIRT 使用一个数据集从数据提供者处的检索数据。 可以将数据源理解为连接, 数据集作为query。 建立数据源让我们建立一个数据源: 打开数据资源管理器。 选择数据源节点。 用鼠标右键单击打开弹出菜单。 选择新建数据源。 新建数据源对话出现。 选择 Classic Models Inc. 示例数据库 在数据源名称输入框, 输入Sample 。 点击 next。 点击 Finish。 您的新建的数据源出现在数据资源管理器(Data Explorer) 内。 编辑您的数据源作为将来的参考, 我们回顾一下您将如何改变数据源: 打开数据资源管理器 打开数据源节点。 双击数据源。 数据源编辑器被打开。 您能做所有有需要的更改。 点击 OK 保存您的变动。 BIRT 指南建立数据集 建立数据集 数据集编辑器页 数据库浏览器 创造Query 测试Query 编辑一个数据集 建立数据集现在我们准备好建立和测试我们的数据集。 打开数据资源管理器 选择数据集节点。 用鼠标右键单击打开弹出菜单。 选择新建数据集。 新建数据集对话将出现。 “在数据集名称”输入框，输入Customers。 确保数据源下拉框显示的是我们之前创建的 Sample 数据源。 确保数据集类型下拉框选中的是SQL Select Query 。 点击Finish。 数据集编辑器页数据集编辑器现在打开了。 我们将使用它来定义我们的quary。 数据集编辑提供以下选项: 查询 - 显示您的SQL Select的语句。 这是您创造和改变您的 SQL quary 的地方。 一旦您有基本的quary, 您能增加WHERE 子句, 调整所选择的字段集，等等。 使用 SQL 编辑器增加计算字段，由数据库引擎负责计算。 使用SQL 别名子句给这样的字段命一个名字。 数据源- 显示这个数据集所属的数据源名字，您能查看或改变它。 预览结果- 测试您的查询和观看输出的结果的地方。 可以在您继续进行报告设计之前确保数据是正确的。 计算列- 计算字段由 BIRT 来实现计算， 您能使用 JavaScript 表达式, 及调用业务逻辑。 参数- SQL SELECT 语句能包含输入参数，传递数据到查询语句。 在查询语句中他们被标记为SQL的 ? 符号。 你可以各参数设置一个名字，设置一个默认值等操作。参数必须与你的SQL ? 符号一一对应。 过滤器- 附加的过滤器将应用于您的数据。 过滤器约束传递到报表上的数据。 Where 子句也是过滤器: 由数据库执行。 这个选项卡让您使用BIRT 的 JavaScript 脚本语言定义附加的过滤器 。 输出列- 根据查询显示Columns, 并让您定义一个Column别名给报表使用。 注意这个view显示的Columns 将是报表所能看见的。 查询选项卡显示着能能从数据库选择的Columns。 数据库浏览器切换到查询页。 这个选项卡提供一个简单的数据库浏览器。 展开Sample的数据源查看这个数据库的schemas 。 有一个: CLASSICMODELS 。 展开CLASSICMODELS 查看数据库的tables 列表。 展开table看它的column。 可以拖拽一个table或column 增加它的名字到SQL 编辑器。 创造查询我们的查询非常简单, 因此我们将键入: 简单的查询SELECT * FROM CUSTOMERS WHERE COUNTRY = USA 测试查询打开数据集编辑器, 跟着下面来做: 点击预览结果选项。 预览页将出现。 这页显示了您在查询中选择的字段和查询结果。 核实一下顾客名单列表是否正确。 点击OK关闭数据集编辑器。 如果错误对话出现, 检查以下: 您的Eclipse被安装在空间不足的目录。 您是否依照上面输入正确的SQL 语句。 您未用分号结束您的语句。 编辑一个数据集您新建的数据集与您的数据源一起出现在数据资源管理器。 我们能使用数据集编辑器改变数据集, 并且测试它确保它返回正确的数据。 找到或打开数据资源管理器。 打开数据集节点。 双击 Customers 数据集。 数据集编辑被打开。 BIRT 指南 构建Table 报表布局 报表项 构建Table细节 构建State Group 构建City Group 增加Table Column 构建列标题（Column Headings） BIRT 指南-报表布局我们的customer listing report 将以“表”的形式显示客户信息: 类似HTML Table, 附加了能够循环显示报表数据的能力。 我们选择的Grouped Listing 模板预先为我们构建了一个“表”, 我们只需要再填装一些细节。 在开发报表之前, 让我们介绍一下BIRT 的报表项。 报表项BIRT 提供各种各样的报表项用于构建我们的报表。 报表项出现在Palette view。 报表项有: 标签- 插入一个静态的文本。 文本- 插入文本块(纯文本或HTML格式）和计算列值。 常用来创建标题, 信格式, 邮件合并 等。 动态文本- 插入带有可选 CLOB 数据表达式的文本块。 支持通过表达式对 advanced CLOB 数据进行操作。 数据- 插入数据集列或表达式结果。 图象- 任何由浏览器支持的图象。 图象可能被内嵌在一个报表文件中, 或链接到你的网络服务器上的一个文件。 网格- 提供报表项的表格布局, 很象HTML Table。 列表- 在页眉、详细信息、页脚区段中插入数据集行的灵活格式表示。 表- 以Table的形式呈现数据集中的数据。 图表- 显示商业图表，如饼图、折线图, 等。 这个指南将使用到大多数元素,除了列表、图表和动态文本。 构建明细表新建报表对话构建了一个已经包含“表”的初始报表和一级分组。 如果我们选择创建一个空白的报表, 我们也能够通过简单地由palette扯拽得到Table。 下步将增加内容到“表”。 我们将用 明细数据行（detail band） 显示数据集中的每一条记录。: 浏览数据资源管理器，如果它还没有打开的话。 展开数据集节点。 展开我们构建的 Customers 数据集实体。 这将显示数据集中可用到的 columns 。 选择CUSTOMERNAME column。 在“表”中找到明细数据行。 (它是一个灰色明细数据行 标签。) 然后扯拽CUSTOMERNAME column 到明细数据行的左边第二个单元格。 注意, 报表设计器自动地增加对应的表头。 扯拽PHONE column 到明细数据行的最右边的单元格。 构建 State 分组我们想要我们的客户报表根据State字段分组, 然后按照 city字段分组。 使用组将导致所有具有同样 State 的数据行出现在一起。 在“表”里面找到“组页眉行”。 它有一个浅灰色的组页眉行 标签。 扯拽STATE column 到 “组页眉行” 的最左边的单元格。 构建你自己的分组我们之前使用的分组是报表模板自动为我们添加的。 如果我们从palette扯拽得到Table, 需要我们自己来添加分组，下面将会解释如何添加一个分组。 在你添加一个分组之前您必须将Table绑定到一个数据集。 绑定会自动发生在当我们将第一个数据集字段添加到表的时候。 但是, 如果您自己构建了一个表, 您能够在属性编辑器中使用 “绑定” 面板将一个表绑定到数据集。 构建 City 分组其次, 我们还将构建一个 City 分组。 这样将会先按照State 对数据进行分组，然后是City。 将光标悬停在表上将会有一个“表”图表显示出来。 点击“表”图标将显示出表的脚手架（就是最左和最顶端淡紫色的部分）。 用鼠标右键单击 state 组页眉 的 “行标题”，出现一个弹出菜单 从弹出菜单选择“插入组-在下面”，弹出“新建组”对话框 选择了“分组依据”中选择 CITY ，在名字字段输入 City。 点击OK。 增加表列我们需要另一个表列来显示我们的组页眉: 确保表的脚手架出现。 用鼠标右键单击第一列的标题上方的阴影部分。 在弹出菜单中选择“插入-往右侧插入列”。 将出现一个新的列。 拖拽rowCITY 表达式，移动到第二个“组页眉行”的第二列， 构建列标题我们需要重新定义一下我们的列标题。 通常BIRT 会为我们的每一个列增加一个默认的列标题。 双击在第一列标题的文本改变它。 输入州 ，按回车确定。 从palette 扯拽一个标签到第二个列标题, 键入城市，按回车确定。 将第三个列标题改为名字 。 将第最后一个列标题改为电话 。 BIRT 指南测试您的报表 测试您的报表 以HTML格式预览 以PDF格式预览 测试您的报表 我们现在准备好测试报表布局。 我们之前已经核实过数据集了, 我们现在要做的就是验证一下报表是否向我们期望的那样将数据显示出来。 我们点击报表编辑器左下角的“览预”分页。 这个报表没有参量, 如果有的话可以选择“显示报表参量”按钮来修改。 这时会出现一个嵌入式的浏览器窗口,以HTML 格式显示报表。 报表只显示为一页。 运行时最好使用较小的数据集。 因为示例数据库有相当多的数据, 所以我们之前使用了一个WHERE 子句限制结果的输出。 我们还能够使用报表参量和数据集过滤器限制数据每次的输出量。 以下方式能改变报表的外观： 在报表的上面增加一个标题。 给列标题增加一些颜色。 缩进 city 和 state 列。 给city 和 state的主页眉行增添一些颜色。 格式化电话号码。 根据顾客名称排序。 在我们做这些外观改进之前, 我们看一下其它的报表预览方式。 以HTML格式预览 预览分页能够快速的预览你的报表。 每当你切换至预览界面，BIRT将运行报表。 但是, 布局和预览分页一次只能显示一个，不能同时打开（不能向 Dreamweaver等工具那样拆分设计窗口和预览窗口）。 我们能在一个独立的窗口预览报表。 在工具栏找到预览按钮。 使用下拉箭头将它展开。 你能够在一个独立的窗口以HTML形式预览报表。 这允许您的布局编辑器和预览页面之间反复切换，而不用重新启用报表。 在Web查看器 中预览这个选项与上面相类似。 它允许报表使用BIRT 的Web Viewer在一个独立的窗口以HTML形式预览报表。Web Viewer提供强有力的导航功能，比如 TOC, Previous Page, Next Page, Goto Page 以及search 和 export 功能。 预览报表在网观察者使用工具栏预览按钮和选择网观察者 选择或供选择地祈求文件Preview 在网观察者。 以PDF格式预览您能以PDF格式的形式预览 。 这将布局转换成一个多页PDF 格式。 BIRT 指南设置可视化控件属性 重设表-页眉（Table Columns ）尺寸 设置背景颜色 设置字体 格式化数据 设置边框 更多在属性设置 重设表-页眉（Table Columns ）尺寸我们调整表-页眉的大小。 表& 列可以使用绝对大小(英寸, 厘米), 或相对大小(页的宽度的百分比。) 这里, 我们将在报表布局器中直接调整列宽。 请跟着下面操作: 点击布局切换回到布局窗口。 然后点击“表”显示出脚手架。 可以看到城市 和 州之间的列标题由一条黑色的线分隔开。 将光标移动到这条线, 可以拖动鼠标左键来重设尺寸。 重覆上面的操作调整“城市”列的宽度。 设置背景颜色让我们来装饰一下“州”主页眉行。 我们通过设置行的背景颜色给它增添一个“颜色”。请跟着下面操作: 选择rowSTATE主页眉行(即第一个主页眉行)， 点击这个主页眉行最左边的淡紫色格子。 (记住首先要显示出表的脚手架。) 打开属性编辑器。 窗口的左边列出了一个属性类型列表。 点击“常规”。 找到“背景色”输入框。 点击空白的灰色按钮来显示一个颜色拾取器 。 从最上面一行往右第三个拾取框获得蓝色。 这是一种标准颜色, 但是颜色太深，不是我们想要的。 点击规定自定义颜色 按钮。 滑动最右端的滑动条设置颜色的饱和度，获得一个浅兰色。 点击确定。 设置字体现在, 我们给“州”设置一个较粗的字体。 我们还将装饰rowCITY主页眉行， 使用深蓝, 较大, 粗的字体。 请跟着下面操作: 选择rowSTATE数据项。 (它位于在“州”标签下。) 切换到“属性编辑器”的“常规”选项。 找到“字体大小”。 将字体改为大 。 点击 B 给字体加粗。 选择rowCITY据项。 再次切换到“属性编辑器”的“常规”选项。 设置字体设置为大 。 点击字体颜色按钮。 打开颜色拾取器。 从最上面一行往右第三个拾取框获得蓝色。 点击确定。 格式化数据我们将要格式化电话号码，以便他们符合北美的电话格式: (123) 555-1212 。 我们将应用一个字符串格式到电话号码。 格式还可以应用与日期和数字。 选择电话号码列 : rowPHONE。 切换到“属性编辑器”的“字符串格式”选项。 选择“字符串格式”为“自定义”。 选择“电话号码”。 在格式代码输入框中, 出现以下格式: () - 设置边框这次, 我们给表增添一个“drop shadow”样式的边框。 点击“表”。 切换到“属性编辑器”的“边框”选项。 设置样式为实线。 (这是缺省的。) 设置颜色为黑色。 (使用颜色下拉框, 或选择左边的颜色拾取器 。) (这是缺省。) 设置宽度为细线条。 点击上框线, 下框线, 左右框线按钮。 一个细线条的边框出现在表周围。 切换到 Properties view (windowShow ViewProperties) , 出现一个更为详细的属性设置视图。 点击“表”将会用“表”的属性来初始化这个Properties view。 展开Properties view的属性节点，设置“框-下边框宽度和左边框宽度”为medium。 更多属性设置BIRT 提供了丰富的属性用来格式化报表项。 属性是基于 W3C CSS (级联样式表)的标准。如果您曾经使用过CSS 格式化HTML, 那您将很容易理解BIRT的格式。 当前报表布局样式当前报表预览样式BIRT 指南设置数据属性 关于数据属性 设置明细数据排序 关于数据属性除可视化控件外, BIRT 还提供了与各个报表项数据相关的属性。 我们将使用这些来控制我们的顾客报表排序。 数据集在BIRT中是可重复使用的: 您能够多次使用同样的数据集。 例如, 假设您想要以三种方式显示(YTD) 销售报表: 月, 销售情况,和图表。在BIRT中, 您只要定义数据集一次, 但却可以显示它三次。 Each use of the data set can provide data properties that customize the data set to that particular use. 数据属性: 数据集捆绑: 让您指定数据集到任意一个指定的报表项。 参量捆绑: 您能传递数据到数据集。 例如, 您能创造 master/detail 子报表， 从当前主报表的当前行传递数据参数到detail获得子报表 。另一个例子, 您能从一个数据库获得顾客名单报表, 然后从另外一个数据库获得订单子报表。 过滤器: 提供过一个过滤条件。 组: 除了我们目前为止所看到视觉效果外，还可以提供创建子统计的功能。 排序: 可以控制表中的明细数据的排序。 这个属性我们将会用到。 设置明细数据排序我们准备给客户报表指定排序次序。 选择“表”。 (在布局边界器中选中表) 选择“属性编辑器”的“排序”选项。 (注意: “排序”是属性编辑器的一个tab。) 点击增加按钮增加一个新行。 使用下拉菜单选择CUSTOMERNAME作为排序键。 设置排序方向为升序。 BIRT 指南应用样式 关于样式 创造样式 应用样式 编辑样式 关于样式我们曾经提及, BIRT 使用CSS 为报表项目定义样式。 BIRT 允许您在样式表定义属性, 然后将样式应用与报表项, 就好像HTML一样。 结果是, 您只要创造样式一次就可以多次的使用它们。 如果您需要改变报表的风格, 您只要在一个地方修改就可以将效果应用于许多不同的报表项。 如果您曾经在创造 HTML页时定义过自己的样式表, 您将很容易理解BIRT的 样式系统。 样式可以被放置入BIRT lib中(使用Themes)，并且被报表共享。 创造样式我们使用样式来格式化表-页眉。 我们将表-页眉设置成蓝色和文字有个对比。 而不是一个一个的去格式化每个标签, 我们将定义样式, 然后应用它。请跟着下面操作: : 选择表-页眉上的第一个标签(“州”标签) 。 用鼠标右键单击，从弹出菜单选择“样式- 新建样式”。 弹出新建样式对话框 在“常规”页的“自定义样式”中输入“Header” , 确定“自定义样式”单选按钮被选中。 在左边的样式对话选择“背景”。 点击背景颜色按钮并选择蓝色。 切换到字形。 设置颜色为白色。 设置粗细为粗体。 点击OK。 注意, 这个新建的样式已经应用于当前的标签了。 应用样式其次, 我们向其它三个标签赋予样式。 (我们可以重复上面的操作4次完成4个表头的设置，现在我们只要两个步骤就可以达到同样的效果) 选择其它三个标签: 点击“城市”标签, 并使用Ctrl+click 同时选择其余两个表头。 从弹出菜单中 “选择样式-应用样式-Header”。 其它三个单元格现在也都被格式化了。 编辑样式假设我们想改变我们创造的样式。 我们如何找到并改变它呢。 打开Outline view。 拖动滚动条到底部找到样式节点。 打开样式节点会显示出我们之前定义的样式。 双击您想要编辑的样式。 BIRT 指南级联样式 关于级联样式 设置报表属性 其他默认样式 检查报表 关于级联样式我们曾经提及, BIRT 使用CSS为报表项定义样式, 并且我们演示了如何定义和应用一个我们自己的样式。 BIRT 同样遵循 CSS的级联 : 您一旦为报表或容器设置了属性, 则这些属性值会级联应用于这个容器所包含的内容。 在BIRT中,网格、列表和表都是容器: 他们能够包含其他的报表项。 报表本身是所有报表项最终的容器。 设置报表属性我们的报表当前使用缺省字体: serif 样式。 (实际上, BIRT 在您的浏览器中使用字体设置。 许多浏览器使用serif 样式, 但如果您改变了缺省的浏览器字体, 那么报表将会如何显示呢。) 我们改为使用sans-serif 样式。 我们使用一个BIRT预定义的样式调用报表, 为报表项指定缺省样式。 如果您熟悉CSS, 就好像是在为HTML body 标签定义样式。 打开Outline view。 拖动滚动条到底部找到样式节点。 打开样式结点。 用鼠标右键单击和选择新建样式。 在“常规”页, 选中预定义样式的单选按钮并从下拉列表选择report。 点击OK 在Outline view的样式结点找到一个命名为report的风格 。 双击它，会打开样式编辑器。 在字体区域, 选择Sans Serif 作为字体类型。 点击OK。 您的报表的所有项都将变成sans-serif 字体。 serif 和sans-serif 是由CSS 定义的: 他们是通用字体，不依赖于安装了在机器上的特殊字体。 CSS 字体应避免依赖特殊的字体; 如果您的报表将作为一个公开网站的一部分发布的话，这一点很重要。 您可以在CSS定义一个字体名单 。 例如: Helvetica, Arial, sans-serif 。 其他默认样式BIRT 为多数报表项定义了缺省样式。 详细参考 ROM Styles Specification。 样式结点显示的风格能够应用于每一个报表项。 但是, 还有一些附加样式是适用于组级别和其他内容的。 如果您希望使用这当中一个, 简单地创造样式和必需的名字。 检查报表我们点击“预览”查看我们的报表样式。 还不错, 但我们还需要一个更好的报表标题。 BIRT 指南使用网格 创建一个网格 行属性 列属性 插入一张图片 插入运行期日期（即运行报表时候的日期） 创建一个网格给我们的报表添加一个恰当的标题. 我们使用经典的“左/中/右”布局: logo 放在左边, 报表名称放在中间, 当前日期放在右边. 实现这个效果之前我们先把当前那个“ Report Header ”简陋的标题删除掉. 请跟着下面操作: 选中“表”上方那个包含“Report Header”文本的网格， 单击右键，在弹出菜单中选择“删除”选项，将这个网格删掉。 创建“左/中/右”这样一个布局最简单的方式是使用网格。网格类似于Html的table（早期我们常用table来做网页元素的定位），在这个例子中，我们插入一个两行三列的网格。 从palette中拖拽“网格”到你报表的“表”上方。将会弹出“插入网格”对话框 选择两行三列。 点击确定。 行属性我们将使用第一行来包含标题内容，第二行作为标题与报表之间的间隔。 选中网格的第一行（是整行选中，不是某个单元格）。 在属性编辑器的“常规”属性页中，设置“垂直对齐”为“顶部”。 选中网格的第二行。 在属性编辑器的“常规”属性页中， 设置“高度”为0.25 英寸（我们一般不会用这种尺寸单位吧：）. 列属性我们让三列各占报表页的1/3宽，并且居左，居中，居右对齐。 选择第一列的表头（就是网格上面的淡紫色的单元格，这样就能选中这一列了） 这时候会切换到“属性编辑器-列”的“常规”属性页中， 注意到当前宽度是没有被设置的. 向Html一样,如果列的宽度没有设置, BIRT将根据列中的内容来设置尺寸。 设置列的宽度为33%. 在“宽度”中输入33, 在旁边的下来菜单中选择“%”。 选择中间那列。 重复上一步的操作，同样设置宽度为33%。 在属性编辑器的“常规”属性页中,设置文本对齐方式为居中。 选择最右边那列。 重复上一步的操作，同样设置宽度为33%。 在属性编辑器的“常规”属性页中,设置文本对齐方式为靠右。 插