跳到主要内容
版本：7.3.0

树字段管理

1. 概述

树字段用于管理具有树层级关系的维度数据，支持在树状表格、树状筛选器等场景中使用。核心能力包括：

  • 层级关系维护：通过父子 ID 关联构建树形结构
  • 版本动态管理：支持按时间范围切换不同版本的树结构
  • 动态数据关联：支持通过关联数据集实现树结构动态更新

2. 使用指导

2.1.创建树字段

在「管理中心 > 企业配置 > 树字段管理」页面，点击右上角「新增树」，此时界面最上方新增一行树字段。修改树字段名称有两种方式：

方式一：双击新增树字段名称，直接编辑修改。

方式二：点击新建树字段右侧的「详情」，在「树字段详情」页面点击名称右侧编辑按钮修改树字段名称。

2.2. 版本管理

2.2.1. 概述

树字段版本管理旨在对层级结构数据进行版本化管控，通过记录不同时期树结构，实现结构变更追溯、数据一致性保障，满足业务迭代与系统开发需求。

2.2.2. 应用场景

单版本：适用于结构稳定、无需回溯的场景，如行政区划分、静态架构展示、固定分类体系。

多版本：适用于频繁迭代的场景，例如

  • 组织架构变更：留存历史架构版本，支持人力成本等数据回溯分析。
  • 产品分类调整：记录分类树结构变化，辅助销售数据对比与客服订单查询。

2.2.3. 操作步骤

  1. 点击版本管理右侧「添加版本」。

  2. 输入版本名称，多版本名称默认按名称+序号_创建时间戳填写（如组织架构V1_20240101）。

  3. 选择树字段版本维护方式，支持「Excel导入」和「关联数据集」两种方式。

    说明：单版本维护时仅能选择 Excel 或数据集其中一种方式（二者互斥）；多版本可独立选择维护方式（如版本 1 用 Excel、版本 2 用数据集）。

    • Excel导入：下载并填写模板后上传，模板上传要求及限制详见模板规范。
      本案例中使用的树字段模板：树字段上传模板。
    • 关联数据集：选择当前用户有使用权限的数据集生成树结构，仅支持本地文件/在线文档/数据库数据集三种类型。
      数据集字段匹配说明可参考字段定义。

  4. 配置版本有效期，版本仅在设定有效期时间段内生效，过期后自动失效。当仅存在一个版本时，该版本将永久有效。

    • 单版本：建议选择范围较大的时间区间。
    • 多版本：多版本需要配合日期筛选器一起使用，需配置非重叠的有效期，否则版本筛选失效，默认版本永久生效。
      例如：当日期筛选器选择为2025年6月18号，去树字段中匹配有效期包含20250618的版本，使用该版本对应的树字段进行数据分析。若没有匹配到则使用默认版本。

2.2.4. 其余操作

  1. 搜索：当存在较多版本时支持通过名称搜索到对应版本的树字段。
  2. 编辑：点击编辑按钮对该版本树字段进行修改，包括名称、维护方式和有效期。
  3. 删除：删除该版本树字段，单版本与默认版本不支持删除。
  4. 预览：树字段上传成功后，可点击预览查看生成的树是否满足需求。
  5. 下载：下载已生成的树结构信息，包含本级ID、本级名称、上级ID、在当前层级中的序号四列内容。
  6. 选择默认版本：通过下拉菜单选择默认版本，当日期筛选器未匹配到有效期包含截止日期的版本时，使用默认版本。

    说明：仅多版本时需要选择。

2.3.关联数据集字段

  1. 单击关联数据集字段右侧「添加数据集」，选择需要关联的数据集后单击「确定」。
  2. 选择关联字段。
    所选的数据集中的关联字段需与上传的树字段模板中的「本级ID」一一对应。
  3. 选择日期字段。
    日期字段用于定义各版本生效时段，需结合日期筛选器确定当前适用版本。当系统存在多个树字段版本时，必须填写有效期，否则版本筛选功能将失效，始终应用默认版本。
  4. 单击「确定」完成数据集关联。

2.4.使用树字段

使用创建的树字段生成树状表或配置树状筛选器。详见创建树状表格、配置树状筛选器。

3. 模板说明及限制

3.1. 字段定义

模板中包含本级ID、本级名称、上级ID、在当前层级中的序号四列，详细要求如下：

注意：这里是根据列名一一匹配，其他列会忽略，因此上传时不要改动表头名称

模板字段规则
本级ID必填；主键，唯一，不能为空
本级名称必填；不能为空
上级ID必填，可以为空，但若有值，必须来源于本级ID
在当前层级中的序号非必填，建议填写，用于定义树状结构的值顺序
自然数：1，2，3，4，n

  • 当排序列为空时，默认按照本级ID排序；
  • 当排序列有值时，按照排序列排序；每层通过12345维护。
  • 不填的按照ID排在有序号的后面

    • 3.2. 上传限制

    1. 文件格式：仅支持xlsx 、xls

    2. 文件大小：不超过5M

    3. 数据限制

      • 上传上限5w条，超出限制上传失败
      • 上传层级最多支持10层

    4. 格式规范

      • 仅支持文本格式匹配，不支持数值格式和日期格式
      • 在取值区域中若存在合并单元格，上传失败

    5. 逻辑校验

      • 可禁止循环树结构
      • 上级 ID 必须存在于本级 ID 中
      • 同层级名称/序号唯一

    4. 树字段迁移

    迁移场景处理规则
    数据集迁移若数据集关联树字段版本，无需单独迁移树字段
    树字段迁移仅迁移配置信息，需手动迁移关联数据集后才可正常使用，无需重新关联
    页面中树表格迁移
  • 同版本：保留树表格类型，需强制迁移树字段，但因未迁移数据集无数据显示
  • 低版本：因不支持树表格导致页面报错