Rave Reports概述.doc

Rave Reports概述 Rave Reports是一个基于组件的可视化报表设计工具，它简化了在应用程序加入报表的步骤.你可以是用Rave Reports去创建各种报表,从简单的条状报表到高度自定义的报表.报表功能包括: 翻转文字注释 全图示显示 版面调整 页面精确定位 打印配置 字体控制 打印预览 可重利用的报表内容 对PDF,HTML,RTF,和text报表的显示支持 Rave结构 1.Data connection 组件: Rave数据来源于你的应用程序这些标准数据连接组件，TRvCustomConnection,TrvDataSetConnection和TRvTableConnection在Rave可视组件和你的应用程序之间作为数据连接桥TRvCustomConnection组件可以用来访问象内存数组和二进制记录文件这样的非数据库数据TRvDataSetConnection可用来提供访问TDataSet派生的组件包括第三方数据组件TRvTableConnection常用于特定的TTable组件或他们的各个派生组件2.TRvProject 组件 这个组件提供报表和它们所拥有的组件的访问。

TRvProject组件包含许多属性和方法允许你创建、修改、打印和设计你的报表项目在每个应用程序中，你只需要一个TRvProject，但是对于多个使用则不作限制3.Report project file (.RAV file) 报表项目文件用来储存Rave visual designer中的报表定义它是二进制文件，类似于Delphi的.DFM文件所有的报表，报表项目的global pages和data views被储存到这单个文件中你可以导出或导入项目使用TRvProject组件的方法，你也可以储存报表项目文件到数据库的blob字段或其他地方4.Reports Reports储存在报表项目的报表库中一个Rave报表由报表页面和储存在这些页面的可视报表组件组成你可以随意创建许多页面定义，然后在各种方法中组合它们 5.Global Pages Global Pages储存在报表项目的Global Pages分类中，组件包含在Global Pages上，不象其他那些报表页面里面的组件，它们对于所有报表都是可见的Global Pages对于储存模板用于其他报表页面非常有用。

6.Data Views Data Views储存在报表项目的Data Views Dictionary中Data Views给提供数据连接组件提供一个接口当创建新的Data Views时，你必须有活动的数据连接组件在正在运行的应用程序中或者在一个已加载的Delphi或C++ Builder表单上Data Views然后将让数据连接组件去检索元数据(meta-data)信息比如字段名，数据类型，等等字段组件包含在每个Data Views中，可用来设置每个数据列的属性Rave Reports初步入门 你可以在VCL或CLX应用程序中使用Rave Reports去实现来自数据库或非数据库数据的报表.下面的过程说明怎样增加一个简单的报表到已存在的数据库应用程序中. 1.在Delphi中打开一个数据库应用程序. 2.从组件面板的Rave页,假如TRvDataSetConnection组件到应用程序的表单. 3.在Object Inspector中,设置DataSet的属性为一个已在你的应用程序中定义的dataset组件.使用Rave Visual Designer 4.去设计你的报表然后并创建一个report project文件(.rav file). 选择Tools|Rave Designer运行Rave Visual Designer. 选择File|New Data Object显示Data Connections对话框. 在Data Object Type列表,选择Direct Data View然后单击Next. 在Active Data Connections列表,选择RVDataSetConnection1然后单击Finish. 在Rave Visual Designer窗口左边的Project Tree中,展开Data View Dictionary结点,燃后展开刚创建的DataView1结点. 你要使用的数据字段显示在DataView1结点下. 选择Tools|Report Wizards|Simple Table显示Simple Table wizard. 选择DataView1然后单击Next. 选择你想要在这个报表中显示的两个或三个字段然后单击Next. 按照随后的向导页提示区设置要在这个报表中使用的字段的排序, 页边距,首部文本,以及字体. 在最后向导页上,单击Generate完成这个向导然后在页面设计器中显示报表. 选择File|Save as显示Save As对话框. 把Rave project存到你的Delphi应用程序的目录下并命名为MyRave.rav. 最小化Rave Visual Designer窗口返回Delphi. 5.从组件面板的Rave页,添加一个项目组件TRvProject到表单. 6.在Object Inspector,设置ProjectFile属性为刚才创建的report project文件(MyRave.rav). 7.从组件面板的Standard页,添加TButton到表单. 8.在Object Inspector,单击Events标签然后双击OnClick事件. 9.在事件处理程序中使用ExecuteReport方法去执行Rave project组件. 10.按F9运行应用程序. 11.单击在第七步添加的按钮. 12.Output Options对话框被显示出来,单击OK显示报表.Rave报表介绍之二: 可视报表设计器 可视报表设计器 Rave有自己的可视报表设计器,以自己的文件格式保存报表。

这有一些优势，你可以把报表独立于应用程序之外，可独立进行升级，甚至可以通过网络进行更新,或者使用Nevrona的Rave Report Server当然，你也可以把报表保存为标准的DFM文件格式 为了启动可视报表设计器,防止一个TRvProject部件在form上，这个TRvProject部件将是你的应用程序和你即将要创建的报表的联系 如果需要，可加一个TRvSystem部件到窗体上，通过设定RvProject的Engine属性与它挂接RvSystem部件是作为一个通用的报告系统配置部件：可通过它设置将要使用的打印机，边界，页数等等为了开始一个新的报表项目，双击RvProject部件,或者通过敏感菜单选择"Rave Visual Designer..." 一个Rave项目文件将可能由多个报表组成通过全局页面(Global Pages)可以保存一些报表间共享的品项 如果一个属性从缺省值改变为特定值，在属性编辑器中会显示成粗体 当在可视报表设计器设计好报表后，返回到delphi的IDE中，改变RvProject部件的ProjectFile属性为你刚才完成并保存的报表文件名为了运行报表,加一个调用RvProject对象的Execute方法的过程即可。

如果我们设计的报表项目中只有一个报表，我们仅仅调用RvProject.Execute即可如果我们的报表项目中有多个报表，我们不得不在调用Execute前，调用SelectReport来选择特定的报表，或者调用直接调用ExecuteReport方法 与报表项目进行交互 参数(Parameters) 参数可以存在于报表项目，报表，报表页面这三个地方，可通过对应对象的parameters属性进行设定 你仅能通过报表项目的对象树来选择报表项目和特定的报表对于报表页面可以通过报表项目的对象树或页面设计的标题来选择 参数可通过DataText部件来输出在页面上加一个DataText组件,打开属性编辑器的DataField属性你能在此选择项目变量、参数、后初始化变量 procedure TFormMain.btnExecuteClick(Sender: TObject); begin RvProject.Open; //打开报表项目 RvProject.SelectReport('ParametrizedReport',False); //通过报表名称选择特定的报表 RvProject.SetParam('Name','Leonel'); //给特定参数设定值 RvProject.Execute; //执行报表 RvProject.Close; //关闭报表项目 end; 后初始化变量 后初始化变量是只有在报表已经被打印了才知道值的变量。

比如页的总数(TotalPages)就是后初始化变量，其使用方式类同于一般变量，也是通过DataTexts来打印的 全局页面 如果有些报表的部分在两个或更多报表中是相同的公用的，你能把这些放置到全局页面中比如公司名称、日期和时间、当前页号和总页数等我们需要每个报表都有这些东西，我们应该怎么做？ 首先，加一个全局页面到报表项目中在这个页面中，加一个section组件Sections组件用于组件的逻辑分组 在section组件中加入我们想要共享的东西 在特定报表的特定页，增加另一个section组件设定该组件的Mirror属性为前面那个全局页面中的Section组件你能看见全局页面中的Section组件及其包含的对象均被映射进来了对于其它特定的页面，同法炮制，现在多个页面就可以共享一些组件了 条件打印 有时我们会根据特定的条件打印报表的特定部分Rave对此提供了强劲的支持我们可以根据字段值和参数的条件映射一些sections 在新的一个页面中创建一个参数HeaderKind 它可能的值为H0 (无页头), H1(第一种页头), H2 (第二种页头)在全局页面中增加一个新的section组件,它具有第二种页头风格。

返回到ConditionalReport报告Page1的页面，加一个DataMirrorSection部件，设定它的DataField字段为Param.HeaderKind打开它的DataMirrors属性编辑器，增加两个Data Mirrors: 如果值是H1,将打印第一种页头；值是H2, 将打印第二种页头；因为值为H0并不匹配任何mirrors,将不打印页头 procedure TFormMain.btnExecuteClick(Sender: TObject); begin RvProject.Open; //打开报表项目 RvProject.SelectReport(cmbReports.Text,False。