ireport中文用户手册

目录iReport用户手册..............................................................................................................................1iReport用户手册-介绍..........................................................................................................1iReport报表结构......................................................................................................................1iReport报表元素......................................................................................................................5iReport字体和样式(FontsandStyles)..................................................................................6iReport字段,参数,变量..........................................................................................................12iReport栏和组(Bandandgroup)...........................................................................................23iReport子报表(SubReport)....................................................................................................30ireport数据源........................................................................................................................39常规问题解决方案..................................................................................................................104iReportJasperReports深入讲解.........................................................................................110iReport报表结构完全掌握...................................................................................................119iReport报表元素大全..........................................................................................................131iReport中字体编码说明.......................................................................................................154iReport字段，参数和变量精解............................................................................................156iReportBandsandgroups...................................................................................................166iReport用户手册iReport用户手册-介绍CubeBI.com立方开源商业智能iReport是一个能够创建复杂报表的开源项目。它100%使用Java语言编写。是目前全球最为流行的开源报表设计器。由于它丰富的图形界面，你能够很快的创建出任何一种你想要的报表。以下是iReport一些比较突出的功能：•拖拽式,所见即所得的报表编辑器。•多样的向导来简化复杂的报表设计任务。•超过30个排版和格式化工具。•报表可转换为PDFHTMLEXCELFLASHCSVRTFTXTOpenOfficeJava2DJRViewer等格式。•支持所有有效的数据源。如:JDBC,CVS,Hibernate,JavaBean等•用户自定义数据源。•无限次数的撤消/重做。•集成脚本（scriptlet）支持。•内置图表支持：超过20种的图表支持。并可扩展。•国际化：集成超过15种语言。•报表模板与报表库样式管理。•源文件的备份•文档结构浏览器iReport报表结构CubeBI.com立方开源商业智能在本章中我们将一起来分析一下报表的结构，看一下报表中每一部分的作用是什么，以及在生成报表的时候每一部分将产生什么样的效果。4.1栏(Bands)报表被垂直分成若干个部分，每一个部分我们叫它为“band”。每一个band都有自己的特性，在报表生成的时候有些会打印一次，有些会打印多次。如下图。图4.1接下来我们就对每一种类型的band分别进行介绍。TitleBand：title段只在整个报表的第一页的最上面部分显示，除了第一页以外，不管报表中共有多少个页面也不会再出现Titleband中的内容。pageHeaderBand：顾名思义，pageHeader段中的内容将会在整个报表中的每一个页面中都会出现，显示在位置在页面的上部，如果是报表的第一页，pageHeader中的内容将显示在TitleBand下面，除了第一页以外的其他所有页面中。pageHeader中的内容将显示在页面的最上端。pageFooterBand：显示在所在页面的最下端。DetailBand：报表内容段，在这个Band中设计报表中需要重复出现的内容，Detail段中的内容每页都会出现。columnHeaderBand：针对DetailBand的表头段，一般情况下在这个段中画报表的表头。columnFooterBand:针对DetailBand的表尾段。SummaryBand:表格的合计段，出现在整个报表的最后一页中的Detailband的后面，一般用来统计报表中某一个或某几个字段的合计值。为了实际演示各个band的生成效果，我们可以在报表中的各个band里添加不同的对象，以测试各个band的作用。从示例数据库的employee表里取数据，在queryeditor里输入下面的语句：selecttop10*fromemployee图4.2在报表中的各个band分别放置如下内容：图4.3启动报表，生成的效果如下：图4.4生成的报表第一页图4.5生成的报表第二页，也是最后一页iReport报表元素CubeBI.com立方开源商业智能在本章中我们将要解释可以在报表中使用的对象及他们的相关属性。我们所说的元素主要是一些图形对象，比如text，rectangle等。在iReport中没有段落，表格或分页的概念，在报表中最基本的对象主要有七个：-Line-Rectangle-Ellipse-Statictext-Textfield-Image-Subreport-Crosstab-Chart通过以上这些组件的组合我们可以做出各种各样复杂的报表样式。iReport提供两种特殊的图形对象：chart和barcode。每一种类型的对象都有一些通用的属性，如高度、宽度、位置、所在的band等。除此之外还有一些针对不同元素的特殊属性。每一个元素都必须在一个band内部，如果一个元素跨了一个以上的band，那么在编译的时候将会抛出元素位置错误的异常。要添加一个元素到报表中，我们可以从主工具栏中选择相应的工具，然后添加到报表区域中即可。图5.1我们可以通过双击对象或右键菜单打开元素的属性设置窗口。图5.2属性窗口由若干个标签页构成，“Common”标签里包含每一个组件都具有的通用属性，其它的标签页是针对不同元素的属性设置。在下面的章节中，我们将对每一个对象的使用做详细的介绍。iReport字体和样式(FontsandStyles)CubeBI.com立方开源商业智能一个style是一个预定义的属性的集合用来控制元素的外观（比如背景色、边框线、字体等）。我们可以为我们的报表定义一个默认的style。要为一个元素应用一个style，我们可以选择该元素并从元素的属性窗口common标签里的style列表选择你需要的style。Fonts是用来描述text的外观特征。此外，你可以定义一个名为“Reportfont”的全局字体。6.1字体(font)通常定义一个字体，我们需要做下面几件事情：-Fontname(字体名称)-Fontdimension(字体大小)-Attribute(属性，诸如bold-faced,italics,underlined,barred)如果我们需要导出PDF格式的报表，需要为字体添加下面的信息：PDFFontName：PDF字体名称（预先定义PDF字体或一个在classpath里的TIF文件的名称）。PDFEmbedded：当使用一个外部的TTF类别的字体文件生成报表时是否把它包含在PDF文件里的一个标志。PDFEncoding：指定一个字体编码名称。如果我们需要将报表导出成PDF格式，将会使用指定的PDF字体，其它属性将会被忽略掉。如果我们使用扩展的TTF（TrueTypeFont），那么扩展的字体文件（以.ttf结尾的文件名）必须放置在classpath当中。图6.1在“Fontname”下拉框中，仅显示的是java虚拟机管理的系统默认字体，因此，如果要选择一个扩展的TTF字体在非PDF格式报表中，那么我们首先需要在使用之前在系统中把这些字体安装好。图6.2上面的字体列表中显示是内置的PDF字体集合，如果直接去编辑下拉框里的字体但这些字体在设计时候不可用，如果字体文件在启动的时候找不到，那将会产生一些错误。如果我们选择的字体是一个扩展的TTF格式字体，要保证在导出PDF格式时显示正确，请勾选“PDFEmbedded”复选框。如果要导出PDF格式报表选择正确的字体编码至关重要。Encoding指定字体如何被编译。举个例子，如果使用意大利语，要打印正确的重音符（比如：è,ò,a,ù）我们必须使用CP1252编码格式。iReport在下拉框里有一些预定义的编码格式。当报表导出PDF时包含一些非标准的字符时，要保证所有的fields都有相同的编码格式并且检查从数据库里读出的数据采用的字符集格式。6.2样式(Styles)我们可以选择主菜单的“FormatStyles”来定义一个style。如下图所示：图6.3点击“New”按钮添加一个新的style。在弹出的窗口中我们可以定义一些属性，如果我们需要某个属性的值，我们可以点击按钮来实现。图6.4在每个元素属性窗口的“Common”标签里有一个style属性下拉框，如果我们需要为一个元素设置一个st