使用可配置页面


可配置页面是一个内嵌页面容器:顶部可按配置显示资产、时间和控制等筛选头,中间区域通过 iframe 加载关联页面。容器本身不查询业务结果数据;关联页面接收筛选上下文后负责查询、刷新并展示数据。


../../_images/landing_page.png


备注

可见的筛选器、页面切换入口和控制按钮均由应用开发人员配置,并受到资产权限和当前资产选择的影响。实际界面可能与本文示例不同。

前提条件


确保当前账号已被分配可配置页面菜单访问权限及所需资产权限。如需控制资产,还需具有相应控制权限;如未分配,联系 OU 管理员。

使用顶部筛选头


页面顶部可能显示资产类型、分组方式、场站、设备类型、设备、时间间隔、时间范围和场站本地时间等控件。未显示某个控件,表示该控件未启用、当前资产维度不适用,或当前用户没有相应资产权限。

选择资产或时间后,可配置页面通过 SDK 将上下文发送给关联页面。关联页面只有接入并订阅相应资产或时间上下文后,才会随选择刷新;DTV 页面的具体筛选接入方式以 DTV 文档为准。

筛选特定资产的数据


  1. 在左侧导航栏中选择 可配置页面。

  2. 在顶部资产筛选头中,依次选择可见的资产类型、分组方式、场站以及(如已启用)设备类型和设备。

  3. 等待关联页面按新资产范围刷新。

可选择的资产层级、范围及是否支持多选由页面配置决定。多资产树切换入口仅在以下条件同时满足时显示:

  • 部署环境已启用多资产树能力。

  • 当前菜单未通过 URL 禁用多资产树。

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

当资产概览等工具页嵌入可配置页面时,内嵌工具通常隐藏自身重复的资产树入口,使用容器提供的资产上下文。

筛选特定时间段的数据


  1. 如顶部显示时间间隔筛选器,选择日、月或年。

  2. 如顶部显示时间范围筛选器,选择一个时间点或一段时间。

  3. 如页面提供快捷切换或时间快捷方式,可直接切换相邻时间段或应用预设范围。

关联页面使用新的开始时间、结束时间和时间间隔刷新数据。时间格式、最早/最晚时间、时间点/范围和快捷方式均由页面配置决定。

切换关联页面


当页面按资产属性关联多个页面,且当前资产上下文产生多个可用页面映射时,顶部会显示页签或按钮。

  1. 选择目标页签或按钮。

  2. 页面中间区域加载对应的关联页面。

未显示切换控件时,表示页面使用单页面 URL,或当前上下文只有一个可用页面映射。

使用统一资产树和右键菜单


部分存量可配置页面还提供左侧统一资产树或节点右键菜单。选择节点会更新容器的资产上下文;如果节点已关联右键菜单且你具有目标菜单权限,可以从上下文菜单打开相应页面。

多资产树切换、节点选择和右键菜单的使用说明,参见 使用统一资产树。

控制设备


仅当应用开发人员已开启控制配置、当前选择为可控制的单场站或单设备,并且你具有控制权限时,顶部才显示 控制。

  1. 选择顶部的 控制,打开控制面板。

  2. 按控制面板中已配置的规则执行控制操作。

更多信息,参见 探索控制面板。若未显示 控制,请联系管理员检查控制配置、当前资产选择和权限。

DTV 编辑与模板入口


当关联页面为 DTV 页面、配置中启用了对应入口且用户具有 DTV 权限时,顶部可能显示 DTV 编辑或模板管理入口。个人编辑、OU 级管理和组件内容编辑所需权限不同;这些操作属于内嵌 DTV 页面,不会修改可配置页面容器本身。

常见显示问题


  • 关联页面未刷新:确认关联页面已接入可配置页面 SDK,并订阅了当前资产或时间上下文。

  • 页面空白或提示 URL 非法:确认关联 URL 有效,且域名符合 iframe 域名白名单。

  • 看不到多资产树入口:检查环境多树能力、菜单 URL 和当前账号可访问的资产树数量。

  • 看不到筛选器或控制按钮:检查页面功能开关、资产维度、资产权限和当前资产选择。

  • 看不到功能配置入口:该入口仅对拥有 monitor_ou_template 权限的用户显示。

有关菜单 URL 和 state 参数,参见 URL 参数说明。