关于帆软FineReport中的FR11下拉树控件,以下是对其详细的解答:
一、概述
下拉树控件是一种具有多层树状结构的数据选择控件,广泛应用于填报报表和参数面板中。用户可以通过该控件方便地选择所需的数据,并录入或查询相关信息。
二、应用场景
填报控件:在填报报表中,用户可以通过下拉树控件选择具有多层树状结构的数据,并录入填报的数据。
参数控件:在参数面板处,用户同样可以通过下拉树控件选择数据,并键入查询参数。
三、添加方式
填报控件:选中需要添加下拉树控件的单元格后,点击右侧属性面板的“控件设置”,在“选择控件”处下拉选择“下拉树”控件。
参数控件:将参数面板控件工具栏中的“下拉树”控件拖入到参数面板中即可。
四、控件属性
下拉树控件具有丰富的属性设置,以满足不同用户的需求。以下是一些主要属性的介绍:
基本控件名称:控件的名称,手动输入,通常与参数结合使用。
可用:控件是否可用。勾选后,填报时控件可编辑;不勾选,填报时控件灰化,不可编辑。
可见:控件是否可见。勾选后,填报时页面显示控件;不勾选,填报时页面不显示控件。
数据字典:可以定义下拉树实际值与显示值。有三种构建方式:自动构建、普通分层构建、极速分层构建。
自动构建:根据树数据集层级关系自动构建出下拉树,无需一层一层定义数据。
普通分层构建:通过数据字典一层一层定义下拉树,需要数据集中定义一些layer参数配合完成。将上一层的值作为参数值,过滤下一层的数据。普通分层构建时,提供“性能优先”选项,勾选后会提高加载效率。
极速分层构建:通过数据集来定义下拉树的层级。相比普通分层构建,不需要layer参数配合,而是将数据按分类排列,每一层绑定数据列即可。
水印:填报时控件内显示的浅灰色水印文字,手动输入,以提示用户需要输入的信息。点击控件编辑区域后消失。
多选:勾选后,填报时可选择下拉树的多个选项;不勾选,填报时只可一个选项。
节点加载逻辑:会影响性能。默认勾选。勾选后,首次只加载父节点的数据,所有子节点默认不展开,适用于数据量大的情况。不勾选,所有子节点默认一次性展开,适用于数据量小的情况。
只返回叶子节点:多选时,选择父节点后,是否会自动选择子节点。默认勾选。勾选后,勾选父节点时自动勾选子节点;不勾选,当勾选父节点时不自动勾选。
结果返回完整路径:下拉树是一种有层次结构的控件,每个最末端的叶子节点都有其完整的层次路径。勾选后,选择值后会返回其完整的层次路径,返回值为数组类型的数据;不勾选,只返回叶子节点。
校验允许为空:是否允许控件不选择项。勾选后,允许控件不选择;不勾选,填报校验和提交时会提示。
错误提示:不勾选“允许为空”时出现的设置项,可自定义提示信息。
允许直接编辑:是否允许用户直接输入值。勾选后,用户可以直接输入值,实现模糊搜索。
允许自定义值:是否允许用户输入不包含在下拉树选项中的值。勾选后,允许输入;不勾选且多选不勾选时,不允许输入不包含在下拉树选项中的值。
五、注意事项
在使用下拉树控件时,需要注意数据集的构建和层级关系的定义,以确保下拉树能够正确显示。
在设置默认值时,需要按照节点的完整路径进行设置,以确保能够正确选中所需的节点。
对于多选下拉树控件,需要注意“只返回叶子节点”和“结果返回完整路径”两个属性的设置,以满足不同的需求。
六、新多选下拉树控件插件
FineReport还提供了新多选下拉树控件插件,该插件允许用户同时选中父节点本身和一键全选目录下的叶子节点。但需要注意的是,该插件不支持在开启FR11参数面板新样式下使用,也不支持在新计算引擎方式下使用。此外,在11.0.20之前版本,不支持在移动端使用新多选下拉树控件;而11.0.20及之后版本,则支持在移动端使用。
综上所述,FR11下拉树控件是FineReport中一种功能强大的数据选择控件,能够满足用户在不同场景下的需求。通过合理设置控件属性和使用相关插件,可以进一步提高用户的使用体验和报表的填报效率。