treelayer函数

语法：treelayer(TreeObject, Int, Boolean, String)

定义：返回一个树对象 TreeObject 第 n 层的值，一般为树数据集，或下拉树、视图树等树对象，并且可以设置返回值类型及分隔符。

详细解释：

以一个下拉树控件展示 FRDemo 数据库中的部门层级树为例，来讲解 treelayer 函数的作用。

2.1 新建数据集

2.1.1 新建数据库查询

新建普通报表，新建数据集 ds1，SQL 语句为：select * from department，如下图所示：

2.1.2 新建树数据集

新建一个树数据集 Tree1，数据集为 ds1，依赖字段为 did，父标记字段为 fid，如下图所示：

2.1.3 数据集预览

树数据集效果预览如下图所示：

2.2 添加控件

在参数栏添加两个控件：一个下拉树控件和一个文本控件，如下图所示：

2.2.1 下拉树控件

下拉树控件的控件名称修改为 tree。勾选 多选和结果返回完整层次路径。

数据字典选择自动构建，依靠树数据集 Tree1 构建，实际值和显示值都选择 department。如下图所示：

2.2.2 文本控件

文本控件的控件值选择公式：treelayer($tree, true, "\',\'")，如下图所示：

2.4 效果预览

保存模板，点击预览，勾选总部>人力资源部>人力资源文员、总部>市场部>业务员，如下图所示：

根据文本控件值中填入的公式，预览时的返回值和分隔符也会有所不同，详情如下表所示：

公式	返回值	分隔符	图示
treelayer($tree, true, "\',\'")	人力资源文员 业务员	','
treelayer($tree, 2)	人力资源部 市场部	,
treelayer($tree, 2, true, "\',\'")	人力资源部 市场部	','

点击下载模板：treelayer函数.cpt