使用统一资产树¶
统一资产树帮助终端用户在组织结构、场站和设备之间切换资产范围。根据页面和部署版本,你可能看到存量可配置页面的左侧统一资产树、工具页面内的资产筛选器,或单独的多资产树切换入口。这些界面共享资产树数据,但选择后的页面行为不同。
备注
页面布局、树类型和选择方式由应用开发人员配置。本文中的入口或操作未出现时,可能是当前页面未启用、部署环境不支持,或当前账号没有相应资产权限。
前提条件¶
开始前,确保:
当前账号具有目标页面菜单访问权限和所需资产权限。
目标页面已启用资产筛选器,或所在一级菜单已配置存量统一资产树。
识别当前资产树¶
界面形态 |
常见位置 |
主要用途 |
|---|---|---|
统一资产树侧栏 |
存量可配置页面左侧。 |
在组织结构节点与关联二级菜单间导航。 |
页面内资产筛选器 |
资产概览、资产列表、曲线工具、通用指标查询或可配置页面顶部。 |
改变当前页面的资产查询或展示范围。 |
多资产树切换器 |
资产筛选器附近。 |
在当前用户可访问的多棵资产树之间切换数据源。 |
设备树 |
选择场站后出现。 |
按设备类型、平铺列表或资产层级选择场站内设备。 |
切换资产树¶
当页面显示资产树切换入口时:
选择当前资产树名称或切换按钮。
在列表中选择目标资产树。
页面重新加载该树下的资产类型和可选节点,并尽量恢复当前树中仍有效的资产选择。
多资产树切换入口仅在以下条件同时满足时显示:
当前环境已启用多资产树能力。
当前菜单或 URL 未使用
disableMultipleAssetTree=true隐藏入口。当前账号存在多个可访问的资产树。
当工具页面嵌入可配置页面时,工具页面通常隐藏自己的多资产树入口,避免与容器顶部的资产树重复。
按页面选择资产¶
选择节点后的结果取决于当前页面,不一定会跳转到详情页:
页面 |
可选范围 |
选择后的结果 |
|---|---|---|
资产概览 |
集团、区域、场站;多场站维度可多选场站。 |
更新地图、画布和组件的资产范围;选择场站时可能进入单场站地图。 |
资产列表 |
场站、区域或设备,取决于页面资产维度。 |
刷新列表、卡片、汇总和筛选条件。 |
曲线工具 |
场站组、场站或设备。 |
更新待分析资产,并据此查询趋势数据。 |
通用指标查询 |
场站、设备组或设备。 |
更新报表查询范围;设备大数据模式可能不展开设备节点。 |
可配置页面 |
由页面配置允许的组织层级、场站和设备。 |
将资产上下文发送给内嵌页面;内嵌页面接入相应 SDK 后刷新内容。 |
节点可能出现以下状态:
可见且可选:当前账号有权限,且节点下存在符合页面资产类型和维度的资产。
可见但不可选:节点用于展示组织层级,但未满足关联资源或节点权限校验条件。
不可见:节点被资产类型、维度、页面筛选或无权限父节点过滤规则移除。
切换设备树样式¶
平铺/层级样式只适用于部分页面的设备选择,不是全局统一资产树的通用样式:
平铺:按设备类型列出设备,适合设备层级简单的场站。
层级:按资产父子关系展示设备,适合包含子设备或部件的场站。
仅当当前页面支持设备维度、已配置设备类型,并同时开放两种样式时,运行态才显示样式切换入口。通用指标查询的设备大数据模式通常不显示设备树。
关联资源与权限¶
若组织结构节点关联了资源,且页面启用了关联资源,选择该节点时页面可以使用关联资源的数据。当前实现对叶节点优先使用第一项关联资源。
关联资源不会自动绕过权限校验:
页面启用节点权限校验后,无关联资源或无权限的节点可能可见但不可选。
使用
filterParentNodes=true时,无权限父节点会从树中滤除。这与“节点可见但不可选”是两种不同机制。
存量侧栏的固定与宽度¶
部分环境的统一资产树侧栏支持悬浮、固定和拖动宽度。如果展开的侧栏右下角显示固定按钮,可执行以下操作:
备注
该交互属于存量侧栏,不是所有工具页面的资产筛选器都支持。若页面没有固定按钮或可拖动边框,表示当前版本或页面形态不提供此能力。
常见问题¶
看不到资产树切换入口:确认当前账号是否有多棵可访问资产树、部署环境是否支持多资产树,以及菜单 URL 是否禁用了该入口。
资产树为空或缺少节点:检查资产权限、页面允许的资产类型和维度,以及目标节点下是否存在符合条件的资产。
节点可见但无法选择:检查关联资源、节点权限校验和当前页面固定的资产层级。
嵌入页面中出现两套资产树:内嵌工具页应使用可配置页面提供的资产上下文,并隐藏自身重复的资产树入口;联系应用开发人员检查集成配置。
选择资产后关联页面未刷新:确认内嵌页面已接入可配置页面 SDK,且订阅了资产筛选上下文。

