iReport 用户手册 www.CubeBI.com 立方开源商业智能
1
iReport 用户手册
Cube 立方 — 开源商业智能(BI)
www.CubeBI.com
iReport 用户手册 www.CubeBI.com 立方开源商业智能
2
序
本手册是一本 iReport 的入门教程,从前往后的顺序阅读,您能
一步一步从零开始到学会制作出复杂的报表。
本手册是一本 iReport 使用进阶书,从示例和理论两个方面,讲
解了 iReport 中几乎所有的功能。
本手册是一本 iReport 的工具书,里面包含有许多概念上的详细
参数定义,您可以在需要时查阅它。
立方开源商业智能 http://www.cubebi.com
这里有最流行,最
热门的开源商业智能产品,和详细的教程。
全国最专业的开源商业智能社区,http://bbs.cubebi.com/
如果你是 iReport 的新手,你可以来此提问,找寻答案。
如果你是 iReport 的爱好者,你可以来此交流,与大家一起分享
开源给您带来的快乐。
iReport 用户手册 www.CubeBI.com 立方开源商业智能
3
目 录
1 介绍 (Introduction)...............................................5
2 开始(Getting started).............................................6
2.1 环境要求(Requirements) ......................................6
2.3 下载(Download) ..............................................6
2.4 运行(Run) ...................................................6
3 JasperReports 的基础概念(Basic notions of JasperReports)..........8
3.1 Jasperreorts ................................................8
3.2 报表生命周期(The report life cycle) ........................8
4 报表结构(Report Structure)........................................9
4.1 栏(Bands) ...................................................9
5 报表元素(Report elements)........................................14
6 字体和样式(Fonts and Styles).....................................16
6.1 字体(font) .................................................16
6.2 样式(Styles) ...............................................18
7. 字段,参数,变量(Fields,Parameters,Variable)......................23
7.1 字段(Fields) ...............................................24
7.2 参数(Parameters) ...........................................29
7.3 变量(Variables) ............................................35
8 栏和组(Bands and groups).........................................38
8.1 栏(Bands) ..................................................39
8.2 组(Groups) .................................................40
9 子报表(SubReport)...............................................47
9.1 创建一个子报表(create a SubReport) .........................48
9.2 传递参数(Passage of the parameters) ........................49
9.3 子报表示例(SubReport sample) ..............................51
10 数据源(DataSource)..............................................60
10.1 iReport 中的数据源(DataSource in iReport)..................61
10.2 JDBC 连接(JDBC Connection).................................64
10.3 JRDataSource 接口(The JRDataSource Interface)..............67
10.4 使用 JavaBean 作为数据源(JavaBean set datasource) ..........68
10.5 JREmptyDataSource .........................................73
10.6 HQL 查询和 Hibernate 连接(HQL and Hibernate connection).....74
10.7 如何实现一个新的 JR 数据源(How to implement a new JRDataSource)
...............................................................75
11 国际化(Internationalication)....................................83
11.1 资源文件 (Resource Bundle Base Name) ......................83
11.2 获取本地化字符串 (Retrieval of localized strings) .........86
12 脚本(Scriptlet).................................................87
12.1 JRAbstractScriptlet .......................................87
13 模板 (Template).................................................90
13.1 模板结构 (Template structure) .............................90
iReport 用户手册 www.CubeBI.com 立方开源商业智能
4
13.2 使用自定义模板 (Using a custom template) ..................93
13.3 将模板放置在 jar 文件中 (Put templates in jar files) .......96
14 图表 (Chart)....................................................98
14.1 第一个图表 (First chart) ..................................98
14.2 数据集 (Datasets) ........................................105
14.3 图表属性 (Properties of the charts ) .....................106
15 子数据集 (SubDataset)..........................................107
15.1 创建一个数据集 (Creating a subdataset) ...................107
15.2 运行数据集 (Dataset runs) ................................109
16 CrossTabs......................................................118
16.1 交叉表向导 (Crosstab wizard) .............................118
16.2 列,行,单元格 (Columns,rows,cells) ......................123
16.2.1 行和列 (Rows and columns)...........................124
16.2.2 单元格 (cells)......................................132
16.2.3 特殊单元格 (Special cells)..........................133
16.2.4 度量 (Measures).....................................134
16.2.5 Crosstab element properties.........................135
16.2.6 交叉表参数 (Crosstab parameters)....................137
16.2.7 交叉表数据 (Crosstab data)..........................139
16.2.8 交叉表合计变量 (crosstab total variables)...........140
17 jrxm 文档介绍 (jrxml file introduce) ...........................142
iReport 用户手册 www.CubeBI.com 立方开源商业智能
5
【 更多开源商业智能项目 www.CubeBI.com 】
【 中文 iReport 首页 http://ireport.CubeBI.com
】
【 开源商业智能社区 http://bbs.CubeBI.com
】
1 介绍 (Introduction)
iReport 是一个能够创建复杂报表的开源项目。它 100%使用 Java 语言编写。
是目前全球最为流行的开源报表设计器。
由于它丰富的图形界面,你能够很快的创建出任何一种你想要的报表。
iReport 是开源报表引擎 JasperReport 的可视化设计工具,Jasperreports 是
用 LGPL license 提交的,因此使用 Jasperreports 时的局限性较小,这就意味
着我们可以在我们的商业软件中不用去购买它的 license 而使用它。
以下是 iReport 一些比较突出的功能:
• 拖拽式,所见即所得的报表编辑器。
• 多样的向导来简化复杂的报表设计任务。
• 超过 30 个排版和格式化工具。
• 报表可转换为 PDF HTML EXCEL FLASH CSV RTF TXT OpenOffice Java2D
JRViewer 等格式。
• 支持所有有效的数据源。如:JDBC,CVS,Hibernate,JavaBean 等
• 用户自定义数据源。
• 无限次数的 撤消/重做。
• 集成脚本(scriptlet)支持。
• 内置图表支持:超过 20 种的图表支持。并可扩展。
• 国际化:集成超过 15 种语言。
• 报表模板与报表库样式管理。
• 源文件的备份
• 文档结构浏览器