使用统一资产树


统一资产树帮助终端用户在组织结构、场站和设备之间切换资产范围。根据页面和部署版本,你可能看到存量可配置页面的左侧统一资产树、工具页面内的资产筛选器,或单独的多资产树切换入口。这些界面共享资产树数据,但选择后的页面行为不同。


../../_images/tree_configedtree.png


备注

页面布局、树类型和选择方式由应用开发人员配置。本文中的入口或操作未出现时,可能是当前页面未启用、部署环境不支持,或当前账号没有相应资产权限。

前提条件


开始前,确保:

  • 当前账号具有目标页面菜单访问权限和所需资产权限。

  • 目标页面已启用资产筛选器,或所在一级菜单已配置存量统一资产树。

识别当前资产树


界面形态

常见位置

主要用途

统一资产树侧栏

存量可配置页面左侧。

在组织结构节点与关联二级菜单间导航。

页面内资产筛选器

资产概览、资产列表、曲线工具、通用指标查询或可配置页面顶部。

改变当前页面的资产查询或展示范围。

多资产树切换器

资产筛选器附近。

在当前用户可访问的多棵资产树之间切换数据源。

设备树

选择场站后出现。

按设备类型、平铺列表或资产层级选择场站内设备。

切换资产树


当页面显示资产树切换入口时:

  1. 选择当前资产树名称或切换按钮。

  2. 在列表中选择目标资产树。

  3. 页面重新加载该树下的资产类型和可选节点,并尽量恢复当前树中仍有效的资产选择。

多资产树切换入口仅在以下条件同时满足时显示:

  • 当前环境已启用多资产树能力。

  • 当前菜单或 URL 未使用 disableMultipleAssetTree=true 隐藏入口。

  • 当前账号存在多个可访问的资产树。

当工具页面嵌入可配置页面时,工具页面通常隐藏自己的多资产树入口,避免与容器顶部的资产树重复。

按页面选择资产


选择节点后的结果取决于当前页面,不一定会跳转到详情页:

页面

可选范围

选择后的结果

资产概览

集团、区域、场站;多场站维度可多选场站。

更新地图、画布和组件的资产范围;选择场站时可能进入单场站地图。

资产列表

场站、区域或设备,取决于页面资产维度。

刷新列表、卡片、汇总和筛选条件。

曲线工具

场站组、场站或设备。

更新待分析资产,并据此查询趋势数据。

通用指标查询

场站、设备组或设备。

更新报表查询范围;设备大数据模式可能不展开设备节点。

可配置页面

由页面配置允许的组织层级、场站和设备。

将资产上下文发送给内嵌页面;内嵌页面接入相应 SDK 后刷新内容。


节点可能出现以下状态:

  • 可见且可选:当前账号有权限,且节点下存在符合页面资产类型和维度的资产。

  • 可见但不可选:节点用于展示组织层级,但未满足关联资源或节点权限校验条件。

  • 不可见:节点被资产类型、维度、页面筛选或无权限父节点过滤规则移除。

切换设备树样式


平铺/层级样式只适用于部分页面的设备选择,不是全局统一资产树的通用样式:

  • 平铺:按设备类型列出设备,适合设备层级简单的场站。

  • 层级:按资产父子关系展示设备,适合包含子设备或部件的场站。

仅当当前页面支持设备维度、已配置设备类型,并同时开放两种样式时,运行态才显示样式切换入口。通用指标查询的设备大数据模式通常不显示设备树。

关联资源与权限


若组织结构节点关联了资源,且页面启用了关联资源,选择该节点时页面可以使用关联资源的数据。当前实现对叶节点优先使用第一项关联资源。

关联资源不会自动绕过权限校验:

  • 页面启用节点权限校验后,无关联资源或无权限的节点可能可见但不可选。

  • 使用 filterParentNodes=true 时,无权限父节点会从树中滤除。这与“节点可见但不可选”是两种不同机制。

使用右键菜单


在存量统一资产树侧栏中,如果管理员已配置节点右键菜单,可在目标节点上打开上下文菜单并选择目标页面。右键菜单仅在相应节点、菜单配置和访问权限均满足时显示。

选择菜单后,目标页面是否继续使用当前资产,取决于目标页面是否支持并接收统一资产上下文。

存量侧栏的固定与宽度


部分环境的统一资产树侧栏支持悬浮、固定和拖动宽度。如果展开的侧栏右下角显示固定按钮,可执行以下操作:

  1. 选择固定按钮 i_pin,将侧栏固定在页面左侧。

  2. 拖动侧栏右边框调整宽度。

  3. 再次选择固定按钮 i_pinblue,恢复悬浮状态。


../../_images/pin_tree.png


备注

该交互属于存量侧栏,不是所有工具页面的资产筛选器都支持。若页面没有固定按钮或可拖动边框,表示当前版本或页面形态不提供此能力。

常见问题


  • 看不到资产树切换入口:确认当前账号是否有多棵可访问资产树、部署环境是否支持多资产树,以及菜单 URL 是否禁用了该入口。

  • 资产树为空或缺少节点:检查资产权限、页面允许的资产类型和维度,以及目标节点下是否存在符合条件的资产。

  • 节点可见但无法选择:检查关联资源、节点权限校验和当前页面固定的资产层级。

  • 嵌入页面中出现两套资产树:内嵌工具页应使用可配置页面提供的资产上下文,并隐藏自身重复的资产树入口;联系应用开发人员检查集成配置。

  • 选择资产后关联页面未刷新:确认内嵌页面已接入可配置页面 SDK,且订阅了资产筛选上下文。