Pentaho Report Designer 入门教程(一)

PentahoReport Designer 入门教程

采用Pentaho Report Designer5.1版本，也是最新的版本。

一、安装和介绍

介绍部分内容略，首先安装jdk，并配置java相关环境变量，下载pentaho report并解压，直接运行即可。

二、第一个示例

本示例是《Pentaho Reporting 3.5 for Java Developers》第二章中的例子，比较容易上手；在报表中显示11个java库及其大小（最新版本5.1已经不是11库了），同时对java库数量和大小进行汇总。首先要新建一个文件夹chapter2，存储我们创建的报表文件。

报表的环境及基本内容暂时就不介绍了，用到的时候在详细说明。

1、创建和配置数据源

首先我们需要给报表定义数据集，为了简化示例，我们使用表格数据集。在报表设计器右边的，点击data选项卡，右击在弹出菜单中选择table。点击加号图标，创建一个表格数据集，命名为libDs，默认有两列，在点击增加列按钮，增加一列并命名为Library Size，并设置类型为java.lang.Integer。点击增加行，添加表格数据，数据内容如下表。

填写完成，内容如下：

点击确定后，右边data视图内容如下：

2、报表布局

数据集定义完成后，我们开始设计报表，内容包括报表标题、列标题以及明显内容，最后是报表汇总内容。

2.1、创建报表标题

从左边工具栏拖动Label图标到Report Header段，双击修改其内容为Pentaho Report EngineLibrary Repor，修改字体大小为16px，同时也可以通过format菜单下的font修改字体。点击Label控件，也可以拖动改变其他大小。

2.2、创建列标题

在报表标题下面，增加三个label作为列的标题；分别为Library Name,Library Description, 和Library Size。选择view菜单下GuidesàSnap,这样启动自动捕捉，让label更容易对齐到网格；同时我们可以在标尺上双击添加标尺线；如下图所示；在左边工具栏上拖动横线，在列标题的下面添加一条横线，通过右边structure选项卡下面的Style属性修改横线的样式，主要是stock修改线的样式及粗细，text-color属性修改线的颜色。

2.3、填充明细段内容

明细段的内容根据数据集的行数自动填充，本示例有11行数据，故明细段自动会往下重复显示11行的内容。

把数据集的字段拖动到明细段即可，调整大小和对齐方式。可以按shift键，通过鼠标划动范围选中多个控件，统一设置对齐方式，在格式菜单下的对齐方式。

2.4、设计报表汇总部分

最后是创建报表汇总部分，包括java 库的个数和java库大小之和。我们在report footer段顶部增加一个横线，再增加两个Label，内容为：Library Count和Total Library Size。可以选中控件，按方向键（上下左右）进行微调。

下面创建函数计算库的数量和库大小总和。点击右边data选项卡，右击树节点的function项，选中Add Functions，选择Count (Running类别)，修改function name属性并命名为Library Count。再次增加函数，选中Sum (Running)，修改function name属性为Total Library Size，同时修改汇总字段为Library Size。

最后拖动两个函数到报表footer段，并调整位置。

2.5、预览并保存报表

点击画布上面工具栏左边的眼睛图标预览按钮，预览报表；也可以通过文件菜单或工具栏的绿色三角形符号预览，确保设计的内容正确显示。

如果你已经满意你的设计，保存报表为后面集成做准备，通过文件菜单保存到chapter2/data/chapter2_1.prpt。

报表文件保存成类似OpenOffice.orgs的OpenDocumnet格式，是包括一个主xml文件及一些其他资源文件组成的zip压缩文件。下面章节来集成该报表。

三、在Swing程序中集成

四、在j2ee程序中集成