搭建可配置页面¶

可配置页面是统一监测中的容器页：页面顶部按配置提供资产、时间和控制等筛选头，中间区域通过 iframe 加载关联页面。筛选头的资产和时间选择会传递给关联页面，由关联页面刷新并展示业务数据。

可配置页面用于维护已有的内嵌页面。现有页面可继续使用；新建组合可视化页面建议使用数字孪生可视化（DTV）的单页应用。

前提条件¶

开始前，确保满足以下条件：

当前账号具有可配置页面菜单访问权限、所需资产权限和操作权限。如未分配，联系 OU 管理员。
如需进入配置态，当前账号还需具有相关权限点；无此权限时，运行态不显示 功能配置 入口。如未分配，联系 OU 管理员。
已准备需要嵌入的内部页面 URL。若关联页面需要随资产或时间筛选刷新，应接入可配置页面 SDK。
关联页面 URL 的域名需符合部署环境的 iframe 域名白名单。同源页面可直接加载；未命中白名单的 URL 不会被加载。如需配置白名单，联系系统管理员。
如需按资产属性关联多个页面，需先在资产模型中创建对应属性，并为资产实例写入可用于匹配的属性值。

进入配置态¶

在左侧导航栏中选择 可配置页面。
在页面顶部选择 功能配置 ，进入配置态。

可配置页面的配置态为五步向导：基础配置、资产配置、时间配置、控制配置 和 关联页面配置。发布后，系统保存容器配置，包括顶部筛选器、关联页面映射和控制设置；不会保存或修改内嵌页面的画布和组件。

备注

统一资产树和右键菜单属于全局附属配置，不属于单个可配置页面的资产配置。其配置入口分别为 #/menu-conf 和 #/menu-conf/sub-menu-conf。更多信息，参见配置统一资产树。

基础配置¶

字段	说明与运行态影响	条件与限制
显示标题	默认启用。启用后，页面顶部显示标题；关闭后不显示。	启用后可配置标题。
标题	指定页面标题，支持国际化输入。支持 ${nodeName} （当前节点名称）和 ${userName}（当前用户名）变量。	仅显示标题启用时出现。
主题	指定容器页主题，支持 `跟随应用门户主题`、`黑色`、`绿色` 和 `白色`。	默认为 `跟随应用门户主题`。
模板管理	启用后，运行态顶部可出现 DTV 模板管理入口；关闭后不显示。	默认关闭，仅嵌入 DTV 页面并具备相应 DTV 权限时适用。

资产配置¶

启用 资产配置 后，运行态顶部会出现与当前维度兼容的资产筛选器。关闭后，页面不显示资产筛选头，关联页面仅接收其它已启用的上下文。

字段	说明与运行态影响	条件与限制
可选维度	指定终端用户可选择的资产层级。`场站及以上` 支持集团、区域和场站；`场站与设备` 支持场站及其设备。	选择 `场站与设备` 后才出现设备类型和设备相关配置。
分组方式	指定 `场站及以上` 维度下可选的集团、区域和场站层级。	仅可选维度为 `场站及以上` 且未使用统一资产树时可配置。
资产类型	指定可在筛选器中选择的场站资产类型。	必填；可选择多个类型并调整显示顺序。
资产类型筛选器	启用后显示资产类型筛选器；关闭后不能在顶部切换资产类型。	受资产配置总开关控制。
分组方式筛选器	启用后显示集团、区域或场站层级筛选入口。	仅 `场站及以上` 且已配置分组方式时适用；默认启用。
场站筛选器	启用后显示场站筛选器。	默认启用；选择方式决定是否支持多选。
选择方式	指定资产筛选器支持单选、多选或组合层级单选。	可选范围仍受资产权限、资产类型和分组方式限制。
设备类型	指定可在筛选器中选择的设备类型。	仅 `场站与设备` 时可配置，最多选择 100 个类型。
设备类型筛选器	启用后显示设备类型筛选器；关闭后不显示。	仅 `场站与设备` 时适用。
设备类型名称	自定义设备类型筛选器的显示名称。	仅启用设备类型筛选器时适用。
设备类型选择方式	指定设备类型支持单选或多选。	仅启用设备类型筛选器时适用。
设备筛选器	启用后显示设备筛选器；关闭后不显示。	仅 `场站与设备` 时适用。设备数量超过 1000 时，配置页会提示潜在性能影响。
设备名称	自定义设备筛选器的显示名称。	仅启用设备筛选器时适用。
设备树样式	指定设备以平铺列表或资产层级树展示。	仅启用设备筛选器时适用。
设备排序	指定设备沿用默认顺序或按属性排序。	选择按属性排序后，需选择排序属性。
显示场站时间	启用后显示当前场站的本地时间；关闭后不显示。	需当前选择为可解析时区的场站。
关联资源	启用后，资产上下文可携带组织结构节点关联的资源。	是否可用还受统一资产树和资产权限配置影响。
同步资产	启用后，在当前可配置页面内记住上次勾选的资产，并在后续进入时尝试恢复。	不表示跨工具页同步，也不同于存量统一资产树配置中的同名字段。
权限校验	启用后，系统校验用户对节点关联资产的权限。	仅组合层级单选且启用关联资源时可配置。

时间配置¶

启用 时间配置 后，运行态顶部可显示时间筛选器。关闭后，不显示时间筛选头，关联页面不会收到来自容器页的时间选择上下文。

字段	说明与运行态影响	条件与限制
时间间隔筛选器	启用后显示时间间隔选择器；关闭后不显示。	由时间配置总开关控制。
可选间隔	指定终端用户可选择 `日`、`月` 或 `年`。	默认包含日、月、年。仅启用时间间隔筛选器时适用。
选择器样式	指定时间间隔以列表或平铺按钮形式展示。	仅启用时间间隔筛选器时适用。
默认间隔	指定页面首次打开时选中的时间间隔。	必须包含在可选间隔中。仅启用时间间隔筛选器时适用。
时间范围筛选器	启用后显示时间点或时间范围选择器。	由时间配置总开关控制。
时间格式	指定 `YYYY-MM-DD` 或 `YYYY-MM-DD HH:mm:ss`。	仅启用时间范围筛选器时适用。
选择器类型	指定终端用户选择单个时间点或一个时间范围。	可选边界受最早、最晚可选时间限制。
快捷切换	启用后，终端用户可快速切换相邻时间段。	仅时间筛选器启用时适用。
最早可选时间 / 最晚可选时间	限制可选择的时间下界和上界。	可按绝对时间或相对当前时间配置。
时间快捷方式	启用后显示预设时间范围入口。	仅启用时间间范围选择器时适用。可进一步配置快捷范围。
指定时间范围	指定页面首次打开时应用的快捷时间范围。	仅启用时间快捷方式时适用。

控制配置¶

启用 控制配置 后，系统允许在运行态显示控制入口；关闭后不显示。控制入口实际显示时，还必须同时满足：

当前用户具有资产控制权限。
当前选中对象为可控制的单场站或单设备。
已为相关资产配置可用的控制能力。

关联页面配置¶

关联页面配置决定 iframe 加载的页面。关联 URL 必须满足部署环境的域名白名单，否则不加载页面。

字段	说明与运行态影响	条件与限制
关联方式	选择 `单页面 URL` 或 `按属性关联`。	按属性关联需先准备资产属性和值。
URL 地址	指定单页面 URL，或每个属性条件对应的页面 URL。	URL 必须命中 iframe 域名白名单。
选择属性	指定用于匹配关联页面的资产属性。	仅 `按属性关联` 时出现。
条件	指定资产属性值与关联页面的映射条件。	仅 `按属性关联` 时出现。
页面名称	指定关联页面在运行态切换控件中的名称。	仅按属性关联且配置多个可用页面映射时适用。
页签样式	指定多个可用页面以页签或按钮形式切换。	仅按属性关联时适用；当前上下文只有一个可用映射时不显示切换控件。

配置 URL 参数¶

可通过菜单 URL 或应用门户 state 预置资产范围、默认设备类型或隐藏多资产树入口等行为。参数的传递位置和支持范围不同，请参见 URL 参数说明。

备注

可配置页面在组装 iframe 地址时会移除外层 url 和 landingpage 参数，避免重复传递给内嵌页面。内嵌页面需要的参数应按其自身文档配置。

发布页面¶

完成配置后，选择发布，按页面提示填写备注（如要求）并选择确认。发布后，终端用户重新进入页面即可使用新的容器配置。

嵌入 DTV 页面的附加能力¶

当关联页面为 DTV 页面且应用已启用相应入口时，DTV 编辑能力还取决于 DTV 权限。这些能力由 DTV 页面提供，不属于可配置页面容器配置，具体以目标环境和数字孪生可视化文档为准。