树数据集实现组织树报表

Bertha 。 2022-10-02 07:59 166阅读 0赞

## 1. 描述 ##

[组织树报表][Link 1] 中由 ID 与父 ID 来实现组织树报表，若层级数较多时，对每个单元格设置过滤条件和形态会比较繁琐，因此 FineReport 提供了一种特殊的数据集——树数据集，只需要简单的设置就能自动递归出层级，方便的实现如下图组织树报表：

图一：纵向组织树

![1530584874E0gL1EZm.gif][]

图二：横向组织树

![1530584592oG9s3aUr.gif][]

## 2. 构建树数据集 ##

一般分两步构建树数据集：

1）添加带有层次关系的普通数据集；

2）基于普通数据集构建树数据集。

### 2.1 添加普通数据集 ###

添加数据集 ds1 取出原始数据，SQL 语句为SELECT \* FROM 公司部门。

### 2.2 构建树数据集 ###

1）根据父字段构建树

使用情形：原始表结构中符合 ID、parentID 结构，我们可以通过父 ID 这个字段生成树，添加树数据集，如下图。

需要特别强调的是，此种情况，需要有唯一根节点(就是下图 parentID 为空的节点)。如果没有，那么构建树时会无法正常建立索引，最后在前台使用下拉树控件时容易出现一些功能问题，比如控件不能给默认值、比如不能模糊搜索等。

![20180703102831_3768.png][]  
![20180703102832_1786.png_version_1_modificationDate_1508125543000_api_v2][]

2）根据数据长度构建树

使用情形：原始表结构中所有ID都在一列中，且没有父 ID 字段，但是 ID 是有规律的，每组的长度相同，且子级的前N位就是父级编号，添加树数据集，如下图：  
![20180703102832_1779.png][]  
![20180703102832_3962.png_version_1_modificationDate_1508125543000_api_v2][]

### 2.3 树数据集预览 ###

预览树数据集，可看到已自动生成递归树数据，FR\_GEN\_0为最高层，依次往下，如下：

![20180703102832_5878.png][]

## 3. 实现示例 ##

### 3.1 示例一：纵向组织树 ###

1）模板设计

按照下图所示将对应的数据列拖入到单元格中，默认单元格纵向扩展并设置左父格：A2 单元格的左父格设置为 A1，A3 单元格的左父格设置为 A2：  
![20180703102832_5424.png][]

2）条件属性隐藏空白行

有上面预览数据可以看到从二层 FR\_GEN\_1 开始，就会有空白数据，这是因为数据库中存储的数据有上一级部门本身的部门名称和部门 ID，其上一级部门的部门级数会低一级，比如说上述数据的第一行为总部，虽然总部下面有子部门，但是数据库中还是要存储总部这个部门的部门名称和部门ID的，总部对应的级数为一级，那么其对应的数据记录行里面就只有FR\_GEN\_0 层，下面的 FR\_GEN\_1和FR\_GEN\_2 这两层就会没有数据，显示为空白。

在模板制作过程中，从第二层级开始就会有空白数据，需要将空白数据隐藏掉，选中 A2 和 A3 单元格，添加条件属性，当数据为空时隐藏该行，如下图：  
![20180703102832_9072.png_version_1_modificationDate_1508125542000_api_v2][]

注：如果组织结构的层级结构不确定，即有的层级有子层，有的层级没有子层时，其组织树报表的实现方式请查看[不规范组织树报表][Link 2]

3） 其他设置

由于自动生成的字段是编码，可以使用数据字典将其转为对应的部门名称，如下图：

![1530583725w3t52gCH.png][]

### 3.2 示例二：横向组织树 ###

1）模板设计

按照下图所示将对应的数据列拖入到单元格中，设置单元格横向扩展并设置父格：B1 单元格的左父格设置为 A1，C1 单元格的左父格设置为 B1：

![20180703102832_8389.png_version_1_modificationDate_1508125542000_api_v2][]

2）条件属性隐藏空白列

有上面预览数据可以看到从二层 FR\_GEN\_1 开始，就会有空白数据，这是因为数据库中存储的数据有上一级部门本身的部门名称和部门 ID，其上一级部门的部门级数会低一级，比如说上述数据的第一列为总部，虽然总部下面有子部门，但是数据库中还是要存储总部这个部门的部门名称和部门ID的，总部对应的级数为一级，那么其对应的数据记录列里面就只有FR\_GEN\_0 层，下面的 FR\_GEN\_1和FR\_GEN\_2 这两层就会没有数据，显示为空白。

在模板制作过程中，从第二层级开始就会有空白数据，需要将空白数据隐藏掉，选中 B1 和 C1 单元格，添加条件属性，当数据为空时隐藏该列，如下图：  
![20180703102832_5968.png_version_1_modificationDate_1508125542000_api_v2][]

3）其他设置

由于自动生成的字段是编码，可以使用数据字典将其转为对应的部门名称，如下图：  
![15305842831CEMjnbG.png][]

### 3.3 示例三：存储过程创建树数据集 ###

1）问题描述

存储过程直接生成树数据集无效，如图：

![20180703102832_5543.png_version_1_modificationDate_1508125541000_api_v2][]

2）实现方法

先建立数据库查询数据集 ds1，然后数据集 ds1 里 “call 存储过程名 存储过程参数”，再用 ds1 生成树数据集 。

注：若是调用数据库存储过程取数，官方只支持查询语句 select 进行取数，其他写法（例如下面的写法）， 返回的结果不能保证，不建议使用 。

具体操作步骤如下：

新建一个数据库查询，输入：\{call username.package.procedure('$\{p1\}','$\{p2\}','$\{p3\}',?)\}，然后设置下参数的初值，这样就产生了一个普通的数据集 ds1。

再通过数据集 ds1,设置树数据集就好了，此时就可以正常生成树数据集了，如图：

![20180703102833_2719.png_version_1_modificationDate_1508125541000_api_v2][]

其余操作和本文描述一样了,只不过是通过存储过程实现组织树报表，需要增加调用存储过程的这一步，详情请参考：[调用存储过程][Link 3]

## 4. 效果预览 ##

### 4.1 PC 端预览效果（示例一） ###

![20180703102833_2931.png][]

### 4.2 移动端预览效果（示例一） ###

1）App

![loading.gif][]  
2）H5

![loading.gif][]

## 5. 已完成模板 ##

示例一

模板效果在线查看请点击 [树数据集组织树报表.cpt][.cpt]

已完成的模板，可参见%FR\_HOME%\\webroot\\WEB-INF\\reportlets\\doc\\Advanced\\GroupReport\\树数据集组织树报表.cpt。

[点击下载模板][Link 4]

[Link 1]: http://help.finereport.com/doc-view-359.htm
[1530584874E0gL1EZm.gif]: /images/20220113/c29787c582074fc688dcb776d6907651.png
[1530584592oG9s3aUr.gif]: /images/20220113/88f0349c26904cde823548cc49fed5df.png
[20180703102831_3768.png]: /images/20220113/84e35ccc181042099543ec11db277c2f.png
[20180703102832_1786.png_version_1_modificationDate_1508125543000_api_v2]: /images/20220113/b5442891b59a4dbfab8691c8a165fad2.png
[20180703102832_1779.png]: /images/20220113/dd72d0fcacb04fa5aafd641c59ed95b2.png
[20180703102832_3962.png_version_1_modificationDate_1508125543000_api_v2]: /images/20220113/c2f1cf9fef7a440aabee53b709c02f33.png
[20180703102832_5878.png]: /images/20220113/3b9ddf61f85b4aeb8493ec35579cb9b2.png
[20180703102832_5424.png]: /images/20220113/19658b52d82b4343aed955e227c95ba5.png
[20180703102832_9072.png_version_1_modificationDate_1508125542000_api_v2]: /images/20220113/1f67658efa544d57b875a7dd9ea79b0f.png
[Link 2]: http://help.finereport.com/doc-view-357.html
[1530583725w3t52gCH.png]: /images/20220113/58cfa831c1dc483cb90cfae9ebbed394.png
[20180703102832_8389.png_version_1_modificationDate_1508125542000_api_v2]: /images/20220113/71d81a7c26a04fde9abba29693204d48.png
[20180703102832_5968.png_version_1_modificationDate_1508125542000_api_v2]: /images/20220113/10538707681049868ba33d71b3cbbb0d.png
[15305842831CEMjnbG.png]: /images/20220113/9f56ff5c9824403c94ac809e62db5d69.png
[20180703102832_5543.png_version_1_modificationDate_1508125541000_api_v2]: /images/20220113/eba0c24040e84149a1bea250082865fb.png
[20180703102833_2719.png_version_1_modificationDate_1508125541000_api_v2]: /images/20220113/fc7cf10236854c2dadf24f9ba7439e52.png
[Link 3]: http://help.finereport.com/doc-view-1438.html
[20180703102833_2931.png]: /images/20220113/1ddbd6a8b0f941719109c5c29c59012a.png
[loading.gif]: /images/20220113/89c6f501256c48c780552d69cd785afb.png
[.cpt]: http://www.finereporthelp.com:8889/demo/ReportServer?reportlet=doc/Advanced/GroupReport/%E6%A0%91%E6%95%B0%E6%8D%AE%E9%9B%86%E7%BB%84%E7%BB%87%E6%A0%91%E6%8A%A5%E8%A1%A8.cpt
[Link 4]: http://www.finereporthelp.com:8021/download/demo/9.0demo/doc/Advanced/GroupReport/%E6%A0%91%E6%95%B0%E6%8D%AE%E9%9B%86%E7%BB%84%E7%BB%87%E6%A0%91%E6%8A%A5%E8%A1%A8.cpt