1. 描述
组织树报表 中由 ID 与父 ID 来实现组织树报表,若层级数较多时,对每个单元格设置过滤条件和形态会比较繁琐,因此 FineReport 提供了一种特殊的数据集——树数据集,只需要简单的设置就能自动递归出层级,方便的实现如下图组织树报表:
图一:纵向组织树
图二:横向组织树
2. 构建树数据集
一般分两步构建树数据集:
1)添加带有层次关系的普通数据集;
2)基于普通数据集构建树数据集。
2.1 添加普通数据集
添加数据集 ds1 取出原始数据,SQL 语句为SELECT * FROM 公司部门。
2.2 构建树数据集
1)根据父字段构建树
使用情形:原始表结构中符合 ID、parentID 结构,我们可以通过父 ID 这个字段生成树,添加树数据集,如下图。
需要特别强调的是,此种情况,需要有唯一根节点(就是下图 parentID 为空的节点)。如果没有,那么构建树时会无法正常建立索引,最后在前台使用下拉树控件时容易出现一些功能问题,比如控件不能给默认值、比如不能模糊搜索等。
2)根据数据长度构建树
使用情形:原始表结构中所有ID都在一列中,且没有父 ID 字段,但是 ID 是有规律的,每组的长度相同,且子级的前N位就是父级编号,添加树数据集,如下图:
2.3 树数据集预览
预览树数据集,可看到已自动生成递归树数据,FR_GEN_0为最高层,依次往下,如下:
3. 实现示例
3.1 示例一:纵向组织树
1)模板设计
按照下图所示将对应的数据列拖入到单元格中,默认单元格纵向扩展并设置左父格:A2 单元格的左父格设置为 A1,A3 单元格的左父格设置为 A2:
2)条件属性隐藏空白行
有上面预览数据可以看到从二层 FR_GEN_1 开始,就会有空白数据,这是因为数据库中存储的数据有上一级部门本身的部门名称和部门 ID,其上一级部门的部门级数会低一级,比如说上述数据的第一行为总部,虽然总部下面有子部门,但是数据库中还是要存储总部这个部门的部门名称和部门ID的,总部对应的级数为一级,那么其对应的数据记录行里面就只有FR_GEN_0 层,下面的 FR_GEN_1和FR_GEN_2 这两层就会没有数据,显示为空白。
在模板制作过程中,从第二层级开始就会有空白数据,需要将空白数据隐藏掉,选中 A2 和 A3 单元格,添加条件属性,当数据为空时隐藏该行,如下图:
注:如果组织结构的层级结构不确定,即有的层级有子层,有的层级没有子层时,其组织树报表的实现方式请查看不规范组织树报表
3) 其他设置
由于自动生成的字段是编码,可以使用数据字典将其转为对应的部门名称,如下图:
3.2 示例二:横向组织树
1)模板设计
按照下图所示将对应的数据列拖入到单元格中,设置单元格横向扩展并设置父格:B1 单元格的左父格设置为 A1,C1 单元格的左父格设置为 B1:
2)条件属性隐藏空白列
有上面预览数据可以看到从二层 FR_GEN_1 开始,就会有空白数据,这是因为数据库中存储的数据有上一级部门本身的部门名称和部门 ID,其上一级部门的部门级数会低一级,比如说上述数据的第一列为总部,虽然总部下面有子部门,但是数据库中还是要存储总部这个部门的部门名称和部门ID的,总部对应的级数为一级,那么其对应的数据记录列里面就只有FR_GEN_0 层,下面的 FR_GEN_1和FR_GEN_2 这两层就会没有数据,显示为空白。
在模板制作过程中,从第二层级开始就会有空白数据,需要将空白数据隐藏掉,选中 B1 和 C1 单元格,添加条件属性,当数据为空时隐藏该列,如下图:
3)其他设置
由于自动生成的字段是编码,可以使用数据字典将其转为对应的部门名称,如下图:
3.3 示例三:存储过程创建树数据集
1)问题描述
存储过程直接生成树数据集无效,如图:
2)实现方法
先建立数据库查询数据集 ds1,然后数据集 ds1 里 “call 存储过程名 存储过程参数”,再用 ds1 生成树数据集 。
注:若是调用数据库存储过程取数,官方只支持查询语句 select 进行取数,其他写法(例如下面的写法), 返回的结果不能保证,不建议使用 。
具体操作步骤如下:
新建一个数据库查询,输入:{call username.package.procedure('${p1}','${p2}','${p3}',?)},然后设置下参数的初值,这样就产生了一个普通的数据集 ds1。
再通过数据集 ds1,设置树数据集就好了,此时就可以正常生成树数据集了,如图:
其余操作和本文描述一样了,只不过是通过存储过程实现组织树报表,需要增加调用存储过程的这一步,详情请参考:调用存储过程
4. 效果预览
4.1 PC 端预览效果(示例一)
4.2 移动端预览效果(示例一)
1)App
2)H5
5. 已完成模板
示例一
模板效果在线查看请点击 树数据集组织树报表.cpt
已完成的模板,可参见%FR_HOME%\webroot\WEB-INF\reportlets\doc\Advanced\GroupReport\树数据集组织树报表.cpt。