交叉报表示例 - CUBA 框架报表生成器

7.2. 交叉报表示例

要创建交叉报表，请在报表编辑界面的 Report structure 标签页上选择 Crosstab 带区方向。此方向将自动添加三个数据集到报表带区：

<band_name>_dynamic_header - 这个数据集的数据将向右复制，类似于包含表格列标题的垂直带区。
<band_name>_master_data - 这个数据集的数据向下复制，类似于包含表格行标题的水平带区。
<band_name> - 与其所属带区名称相同的数据集。它是实现单元格矩阵的主内容带区。

这些数据集可以是任何可用的数据集类型： SQL、JPQL、Groovy 等等。

例如， Sales 示例应用程序的 Order 实体的交叉报表可能具有以下结构：

Figure 61. 交叉报表

报表数据结构

我们看看报表的带区。

这里，orders_dynamic_header 数据集将返回月份名称列表：

orders_dynamic_header 数据集

import java.text.DateFormatSymbols

List result = new ArrayList()
DateFormatSymbols dateFormatSymbols = DateFormatSymbols.getInstance(Locale.ENGLISH)
for (i in 0..dateFormatSymbols.months.length - 1) {
    result.add(["header_id" : i + 1, "month_name" : dateFormatSymbols.months[i]])
}
return result

orders_master_data 数据集返回根据外部 user 参数选择的客户名称和标识符：
orders_master_data 数据集
```
select name as name, id as customer_id
from SALES_CUSTOMER
where id in (${selected_customers})
```
orders 数据集将提供单元格矩阵的数据，这个数据统计出特定用户在特定月份的订单金额总额。它将 orders_master_data@customer_id （客户 id）作为单元格的垂直坐标,并将 orders_dynamic_header@header_id （月份名称）作为水平坐标，使用 amount 值填充单元格矩阵。

在下面的示例中，报表还有两个外部参数：start_date 和 end_date 用于定义订单日期的范围。通过参数交叉验证来确保参数值在合理的范围是一个很好的主意。
orders dataset
```
select
        o.customer_id as orders_master_data@customer_id,
        month(o.date_) as orders_dynamic_header@header_id,
        sum(o.amount) as "amount"
from sales_order o
where o.date_ >= ${start_date} and o.date_ <= ${end_date}
and o.customer_id in (${orders_master_data@customer_id})
and month(o.date_) in (${orders_dynamic_header@header_id})
group by o.customer_id, month(o.date_)
order by o.customer_id, month(o.date_)
```

报表参数

Parameters and Formats 标签页包含声明的 3 个报表外部参数 - selected_customers，start_date，end_date：

Figure 62. 报表参数

当运行报表时，用户需要输入这些参数。用户可以通过应用程序的 sales_Customer.browse 界面选取。
报表模板

最后可以使用 Microsoft Office 或 LibreOffice 创建报表模板。

报表模板应包含交叉带区的所有三个数据集的命名区域以及列标题的命名区域： <band_name>_header。在这个例子中，它是 orders_header。

下面是一个模板示例，它在垂直方向输出 客户 列表，在水平方向输出按下单日期汇总的每个月的 订单 金额。

Figure 63. 交叉表模板

Figure 64. 命名区域

这样，报表可以纵向和横向扩展，并汇总每个客户和每个月的订单金额：

Figure 65. 交叉表输出

如果想为报表添加总计，应该在单独带区中执实现，并且为这个带区定义汇总数据集。