历史版本19 :树数据集实现组织树报表 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
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 移动端预览效果（示例一）
2）H5
5. 已完成模板编辑
示例一
模板效果在线查看请点击树数据集组织树报表.cpt
已完成的模板，可参见%FR_HOME%\webroot\WEB-INF\reportlets\doc\Advanced\GroupReport\树数据集组织树报表.cpt。