树字段管理

1. 概述

当字段中的维度项存在分支层次关系，可以在管理中心处，维护一个树字段，在树状表格和树状筛选器中使用。

当树字段数据随时间变化发生变化时，可在该树字段中添加新的版本，按时间范围动态切换不同版本的树字段。

2. 操作步骤

2.1.创建树字段

在「管理中心 > 企业配置 > 树字段管理」页面，单击右上角「新增树」，此时界面最上方新增一行树字段，可直接修改该树字段名称。

2.2.添加不同版本树字段

1. 单击新建树字段右侧「详情」，对树字段进行配置。
2. 单击版本管理右侧「添加版本」，输入版本名称。
   版本名称默认按序号_创建时间戳填写（如V1_20240101）。
3. 下载并填写模版后上传，模版上传要求及限制详见模版说明及限制。
   本案例中使用的树字段模版：树字段上传模板。
4. 选择「开始日期」和「结束日期」。
   当存在多个版本时，需配置非重叠的有效期，否则版本筛选失效，默认版本永久生效。
5. 单击「确定」。
6. 树字段上传成功后，可点击预览查看生成的树是否满足需求。
   
7. 当存在多个版本树字段时，可自己设置默认版本，单击默认版本右侧下拉按钮选择默认树字段版本，默认版本不支持删除。

   注意：
   日期筛选器传递截止日期时，系统自动匹配有效期包含该日期的版本；未匹配时选择默认版本。

2.3.关联数据集字段

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

2.4.使用树字段

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

3. 模版说明及限制

模板说明

模板中包含本级ID、本级名称、上级ID、在当前层级中的序号四列。根据列名匹配，本级ID、本级名称、父级ID是必填，这三列必须有，并且列名要一一对应，序号列非必填，其他列会忽略，因此上传时不要改动表头名称。详细说明如下：

模板字段	规则
本级ID	必填；主键，唯一，不能为空
本级名称	必填；不能为空
上级ID	必填，可以为空，但若有值，必须来源于本级ID
在当前层级中的序号	非必填，建议填写，用于定义树状结构的值顺序 自然数：1，2，3，4，n 当排序列为空时，默认按照本级ID排序； 当排序列有值时，按照排序列排序；每层通过12345维护。 不填的按照ID排在有序号的后面

上传限制

• 文件格式只支持xlsx 、xlx
• 上传的文件大小不能超过5M
• 仅支持文本格式匹配，不支持数值格式和日期格式
• 在取值区域中若存在合并单元格，上传失败
• 可能会产生循环树，上传失败
• 本级ID需唯一，不能重复。
• 同一级本级名称不能重名 ，同一级不能有两个排序一样的数字
• 上级ID允许为空，上级ID必须为本级ID里的值，若不是，则上传失败
• 上传上限5w条，超出限制上传失败
• 上传层级最多支持10层