Skip to main content

自定义层级(Hierarchy)

当一个属性需要支持“省/市/区”或“品类/子品类/型号”这类多级维度时,可以在专家模式为该属性配置 hierarchy。层级配置允许系统在问答和图表中自动提供逐级下钻能力。

配置结构

{
"hierarchy": {
"levels": [
{"name": "省", "field": "province"},
{"name": "市", "field": "city"},
{"name": "区", "field": "district"}
],
"defaultLevel": "市"
}
}

字段说明:

  • levels:数组,每一项描述一个层级。field 指向 Schema 中已经存在的属性,name 用于前端展示。
  • defaultLevel:初始展示层级,留空则默认选择 levels 的第一项。
  • drilldownable:可选布尔值,为 false 时只保留层级信息而不提供下钻交互。

使用建议

  1. 确保 levels 中引用的字段真实存在并已配置为 type: 'category'type: 'string'
  2. 当层级字段分布在不同 Schema 时,可以通过 ref 建立实体关系,再在目标属性上配置 hierarchy
  3. 若某层级数据存在缺失,可结合 fallback 选项指定默认值,避免前端出现空节点。

常见问题

  • 问答不触发下钻? 请确认属性启用了 can_drilldown 并且 hierarchy.levels 至少包含两个层级。
  • 层级顺序不正确? levels 中的排列即是前端展示及下钻的顺序,可根据业务需求调整。

更多属性相关字段请参考 属性配置(专家模式)