1. 描述编辑
组织树报表 中由 ID 与父 ID 来实现组织树报表,若层级数较多时,对每个单元格设置过滤条件和形态会比较繁琐,因此 FineReport 提供了一种特殊的数据集——树数据集,只需要简单的设置就能自动递归出层级,方便的实现如下图组织树报表:
图一:纵向组织树
图二:横向组织树
2. 构建树数据集编辑
一般分两步构建树数据集:
1)添加带有层次关系的普通数据集;
2)基于普通数据集构建树数据集。
2.1 添加普通数据集
添加数据集 ds1 取出原始数据,SQL 语句为SELECT * FROM 公司部门。
2.2 构建树数据集
1)根据父字段构建树
原始表结构中符合 ID、parentID 结构,我们可以通过父 ID 这个字段生成树,添加树数据集,如下图。
需要特别强调的是,此种情况,需要有唯一根节点(就是下图 parentID 为空的节点)。如果没有,那么构建树时会无法正常建立索引,最后在前台使用下拉树控件时容易出现一些功能问题,比如控件不能给默认值、比如不能模糊搜索等。
2)根据数据长度构建树
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。
6.未知层级的情况
评论中很多人问到了层级未知的情况。我们不妨用递归的思路来梳理一下什么是组织树:数据之间是有明显父子关系的。
从某个层级开始假如我们向上递归查找,总能找到有限的父层级,这时候不存在层级未定,我们以最大的父层级作为层级数。
假如我们向下递归查找,实际情况当中子层级也是有限的,假如出现子层级不断增长的情况,无论增长到多少级,最终也能找到最深的那个子层级。
有人会杠精说假如无限增长呢?不好意思查询死循环,就不用考虑什么组织树了。