模板说明
在表单选择组织部门、物料分类或地点等有上下级关系的值。
使用场景
为物料申请选择「办公设备 / 显示器」。来源行各有唯一 ID，子节点父 ID 引用上级的唯一 ID，根节点父 ID 留空。
运行结果
可单选或多选，均以字符串数组的 JSON 文本写入保存目标，例如 ["display-monitor"]。已有值可回显，查看页面禁用选择。
来源列表需授予使用者读取权限。控件读取查询返回的首批记录，再按配置筛选、排序或截取。数据量较大时，按目标租户的 SDK 筛选格式缩小查询范围。
验收步骤
分别验证根、子节点、单选、多选、已有值和只读状态。确认页面使用节点标识组树、使用保存值字段写入。
查看完整控件源码（TSX）
中文配置参考
控件参数与连接
| 参数标识 | 类型 | 标准场景 | 说明 | 示例 |
|---|---|---|---|---|
dataListId | 变量或表达式 | 需要 | 数据列表 ID。保存层级数据的列表 ID。 | 203... |
idField | 变量或表达式 | 需要 | 节点标识字段。每个节点唯一标识的来源字段。 | ListDataID |
parentField | 变量或表达式 | 需要 | 上级字段。保存父节点标识的字段。 | ParentId |
labelField | 变量或表达式 | 需要 | 显示名称字段。用作节点名称的字段标识。 | Title |
valueField | 变量或表达式 | 需要 | 保存值字段。写入目标字段的节点值来源。 | ListDataID |
saveToField | 变量或表达式 | 需要 | 保存目标。保存结果的可写字段或变量。 | SelectedCategoryIds |
multiSelect | 变量或表达式 | 按需 | 允许多选。开启后可以同时选择多项。 | true |
titleText | 文本 | 按需 | 标题。显示在控件顶部的主标题。 | Category |
subtitleText | 文本 | 按需 | 副标题。显示在主标题下方的说明。 | 请选择分类 |
maxItems | 文本 | 按需 | 最大条数。最多保留的来源记录数。 | 200 |
emptyText | 文本 | 按需 | 空状态提示。没有可展示数据时的提示文案。 | 暂无层级数据 |
filterExpression | 变量或表达式 | 按需 | 查询筛选条件。可选的列表查询条件。 | 按需留空 |