spagobi系列文章-07 自定义报表(图表)

1 QBEEngine

简介：QBE引擎是一个通过自定义表、字段及查询条件的形式来生成图表或者报表的工具。它是通过可视化配置的形式来自定义SQL，此时的SQL是隐式的。

1.1 先决条件

要使用QBE引擎需要先定义数据表的表结构和说明。下边以一个订单汇总表为例进行介绍。

假设订单汇总表表结构如下：

图8-1

订单汇总表包括订单所属部门，平台，订单的日期，金额，数量等字段。

1. 创建该表的java bean类和hibernate配置文件

例如：

图8-2

和

图8-3

此步骤可以通过myeclipse或者jboss hibernate tools自动生成。

2. 创建对该表字段的描述文件

例如：

图8-4

这里既有对表的描述也有对表中字段的描述。其中：XXXX.label为表或字段标签名，XXXX.tooltip为表或者字段的帮助文字，或者对字段含义的说明文字。

3. 创建对该表字段配置文件

例如：

图8-5

其中XXXX.visible为表或字段是否可见，XXXX.type为表或字段的类型（dimension一般指表，attribute一般指表中的字段），XXXX.position是指表或字段展示位置。是否可视和展示位置用于在设计器中显示使用。

以上三步完成后，如下图：

图8-6

然后将代码和配置文件打包为datamart.jar（必须为此文件名）并放置到

Tomcat_home\resources\qbe\datamarts\XXXX\下。

1.2 配置文档(document)

配置如下图：

图8-7

其中引擎必须选为qbeEngine，在datamart Model类型下。

这时选择的数据源必须定义了方言：

图8-8

这时也可以在document中定义查询参数。Document的模板文件如下：

图8-9

DATAMART name="wansindw"定义的是datamart.jar文件所在的目录名称

Tomcat_home\resources\qbe\datamarts\ wansindw \

Table定义的是表的java bean类名全路径。Filter中定义的是过滤条件。其中p{}中的内容必须与document中定义参数的url相一致。

1.3 报表定义

Document定义完成后如果没有定义参数的话，执行document后会打开如下页面：

图8-10

如果左侧树中显示了定义的数据表名称则说明配置成功，否则请仔细检查以上步骤是否配置正确。

设计器页面中包含四个tab。分别是：

查询，定义查询语句功能。

结果，展示查询语句的执行结果。

工作表设计，定义工作表。

工作表预览，预览定义的工作表。

在查询页面中包含两大区域：

图解：展示已定义的数据表及表结构内容。

查询编辑器：查询语句的定义页面。

查询编辑器页面包含三部分：

选择字段：选择需要查询语句的字段。

过滤条件子句：定义查询语句的where条件子句。

Having子句：定义查询语句的having条件子句。

假设我们要按照日期汇总订单数量功能，则需要做以下步骤：

1. 选择订单数量、订单日期字段，并拖动到选择字段区域

图8-11

2. 定义订单数量的操作方式为sum，订单日期的操作方式为分组和排序，如下图：

图8-12

3. 如果需要其他过滤条件，可以在过滤条件子句中增加条件，如下图：

图8-13

4. Having子句也可以定义如下：

图8-14

以上步骤完成后可以点击右上角的执行按钮查看查询结果：

图8-15

执行后会自动打开结果页面。某一个查询语句定义完成后也可以保存下来，以供下次查询时快速打开，点击右上角保存按钮保存：

图8-16

输入保存名称等信息：

图8-17

查询语句定义完成后接着定义工作表，打开工作表设计tab，如下图：

图8-18

刚进入页面时左上角的选择字段区域是空的，这时只需要点击选择字段后边的刷新按钮，自定义的查询语句中的字段就会显示出来了。

在这个页面中我们可以定义多种报表或者图表，包括柱状图、饼状图、曲线图，table和类型olap的pivot列表。

假设我们想定义一个曲线图，这时需要断则曲线图图标-line chart，并拖动到右侧大片空白区域。然后拖动选择字段栏中的两个字段到曲线图中的横纵坐标上。注意，曲线图的纵坐标必须是可以计算的数值型。如下图：

图8-19

这时也可以选择曲线图的样式，曲线颜色等配置。

这一步骤完成后点击上方的“工作表预览”tab就可以看到曲线图的实际内容了，如下图：

图8-20

在工作表中我们可以定义多个工作表，这些个工作表类似excel的sheet。在工作表设计页面的下方点击

图8-21

加号增加工作表。

这样工作表就设计完成后。如果以后想快速的访问这个工作表，可以点击上方的保存图标(图8-16)，填写相关信息

图8-22

后就可以在选择的目录下创建一个WorkSheet引擎的document了。这样直接点击这个自动创建的document就可以快速访问工作表了。

自定义工作表建议：

1. 工作表使用的数据表尽量只有一个表，避免关联多表，减轻系统负担。

2. 自定义工作表功能还较弱，不能实现较复杂的报表只适合简单图表的定义。