配置资产列表¶

本文介绍应用开发人员如何配置资产列表页面。

前提条件¶

当前账号已在目标应用中拥有 资产列表 页面的菜单访问权限，以及配置资产列表页面的相关权限点。如未分配，联系 OU 管理员。
已在 EnOS 中注册相关资产的属性、测点和指标。如有需要，可通过 EnOS 通用数据服务 API 查询已注册数据。
已阅读探索资产列表，了解资产列表页面的各项功能。

备注

统一监测支持自定义菜单名称，因此实际菜单名称可能与本文有所差异，下文将使用默认名称“资产列表”指代应用中配置的资产列表菜单。

进入资产列表配置页面¶

应用开发人员的账号拥有配置资产列表的权限点后，可按照以下步骤进入资产列表配置页面：

在目标应用的左侧导航栏中选择 资产列表 页面。
在页面右上角的操作栏中，选择 功能配置 按钮，打开资产列表配置页面。

资产列表配置页面为三步向导，依次为 基础配置、资产配置 和 操作配置。

基础配置¶

在 基础配置 步骤中，你可以对资产列表的资产维度、数据类型、展示样式、操作栏按钮以及页面元素进行配置。

配置资产维度¶

资产维度 决定资产列表中一行记录或一张卡片所代表的资产层级。资产维度是资产列表最基础的配置项，它决定了后续步骤中哪些配置项可用。

资产维度	说明与适用场景	条件与限制
场站	默认值。一行记录代表一个场站，用于查看各个场站的汇总数据。适用于集团或区域级的场站对比监测，例如对比各风场的日发电量。	支持列表、卡片和精简卡片三种样式。
区域	一行记录代表一个区域，用于查看各个区域的汇总数据。适用于按管理区域进行绩效对比的场景。	仅支持列表样式；不支持操作配置（批量操作、控制和服务请求）；不支持资产置顶。
设备	一行记录代表一台设备，用于查看场站内各设备的运行数据。适用于设备级巡检与异常定位，例如查看某风场内所有风机的实时功率。	不支持汇总行。

切换资产维度会重置后续 资产配置 步骤已选的资产类型与设备类型。因此每次调整资产维度后，建议重新检查全部三个步骤的配置。

配置数据类型¶

数据类型 决定终端用户可在页面中查看的数据时间属性，支持多选，至少选择一项。

数据类型	说明与适用场景	条件与限制
实时数据	默认值。展示资产当前的实时值，用于日常监盘。	—
历史数据	展示指定时间范围内的数据，用于回溯分析。	选择后，页面顶部将增加时间范围筛选器，供终端用户指定查询区间。

若同时选择实时数据和历史数据，资产列表页面将显示数据类型切换按钮，终端用户可在同一页面完成实时与历史数据的一站式监测。

配置样式类型¶

样式类型 决定终端用户在运行态可切换的视图。支持多选，至少选择一项。

样式类型	说明与适用场景	条件与限制
列表	默认值。以表格形式展示资产及数据项，信息密度最高。适用于大量资产的密集对比、汇总统计与数据导出。	仅列表样式支持汇总行、导出、批量操作和批量控制。
卡片	以卡片形式展示资产，突出资产状态与关键指标。适用于关注资产状态而非精确数值的监盘场景。	支持场站维度和设备维度。
精简卡片	以卡片形式展示资产，不展示数据项。适用于管理层快速浏览场站清单。	仅支持场站维度。

若选择两个及以上样式，资产列表页面将显示样式切换按钮。有关各样式的展示效果，参见使用资产列表 > 切换样式。

配置卡片趋势图¶

启用后，资产卡片中将显示数据项的趋势图，便于终端用户在不离开列表的情况下判断数据走势，例如查看各场站近 7 天发电量的走势。

仅当 样式类型 包含卡片时可配置。趋势图的数据项、样式与时间范围需在运行态的 卡片设置 > 显示图表 中进一步配置，且单张卡片最多显示 2 个图表。

资产卡片中的趋势图如下所示。

e_trendchart

配置区域聚合¶

启用后，终端用户可在页面中勾选 区域聚合，将场站按所属区域分组展示，并折叠或展开各区域下的场站，适用于场站数量较多且按区域管理的场景，便于分区域对比与逐区域核查。

仅 资产维度 为场站且 资产分页方式 为 客户端分页 时可用。

配置按场站分组¶

启用后，终端用户可在设备列表中勾选 按场站分组，将设备按所属场站分组展示，适用于跨场站查询设备时，避免不同场站的同名设备混排，例如同时查看多个风场的风机。

仅 资产维度 为设备且 资产分页方式 为 客户端分页 时可用。启用后，可在 列表配置 > 操作 中为场站和设备分别配置操作按钮。

配置操作栏按钮¶

功能按钮 是操作栏的总开关。启用后，可继续指定资产列表页面中显示哪些操作入口。

按钮	说明与适用场景	条件与限制
搜索框	供终端用户按资产名称或指定属性搜索资产。	按属性搜索需在列设置中为该属性启用搜索。
列表配置	供应用开发人员配置跳转地址、操作列、无连接状态和资产状态数据。	需要 OU 模板相关权限点。
保存模板	供终端用户将当前筛选项与展示配置保存为模板。	保存为 OU 模板需要 OU 模板相关权限点。
导出	供终端用户导出当前列表的资产与数据。	仅列表样式下可用，且终端用户需拥有数据导出权限点。
列/卡片设置	供终端用户调整列表中显示的列或卡片中显示的数据。	若启用列/卡片设置权限点，还需拥有相应权限点。
样式切换	供终端用户在已配置的多种样式间切换。	样式类型需选择两个及以上。
指标卡片配置	供应用开发人员或终端用户新增、编辑和删除指标卡片。	勾选后，指标卡片样式默认为 `多选（筛选所有条件均满足）`。

若不勾选某个按钮，终端用户在页面中将看不到该入口，也无法使用对应功能。例如不勾选导出，终端用户无法导出页面中的资产和数据信息。

配置指标卡片样式¶

指标卡片样式 决定终端用户点选指标卡片时的筛选逻辑。

样式	说明与适用场景	条件与限制
多选-AND	终端用户可同时选中多张卡片，页面仅展示同时满足所有已选卡片条件的资产。适用于逐步收窄范围、精确定位异常资产。	勾选指标卡片配置后的默认值。
多选-OR	终端用户可同时选中多张卡片，页面展示满足任一已选卡片条件的资产。适用于汇总多类异常状态。	—
单选	终端用户一次只能选中一张卡片。适用于卡片条件之间互斥的场景，例如按设备状态分类。	—

仅当 操作栏按钮 中勾选 指标卡片配置 时，此配置项可见。

配置资产分页方式¶

资产分页方式 决定资产数据的加载与分页位置，是影响页面性能与可用功能的关键配置项。

分页方式	说明与适用场景	条件与限制
客户端分页	一次性获取全部资产数据后在页面内分页。适用于资产数量适中、需要全局统计与排序的场景。	支持区域聚合、汇总行、资产置顶和指标卡片计数等依赖全量数据的功能。
服务端分页	按页向服务端请求数据。适用于资产数量庞大、客户端分页出现明显性能问题的场景。	启用后，`区域聚合`、`按场站分组`、`汇总行`、`资产置顶` 和 `指标卡片计数` 均不可用；排序仅对支持排序的字段生效。

备注

此配置项仅在 资产维度 为场站或设备时可见。
启用组织结构树关联资源后，页面强制使用客户端分页。

配置其它页面元素¶

在 其它配置 中，你可以配置资产列表页面的辅助元素。

配置项	说明与适用场景	条件与限制
资产置顶	允许终端用户收藏资产并将其固定在列表顶部。适用于终端用户长期关注少量重点资产的场景。	默认禁用。仅资产维度为场站或设备，且使用客户端分页时可用。
指标卡片计数	在各指标卡片上显示命中该条件的资产数量，便于终端用户快速判断异常规模。	默认禁用。仅使用客户端分页时可用。
列/卡片设置权限点	启用后，仅拥有列配置权限点的终端用户才可调整列或卡片的展示内容。适用于需要统一列表口径、避免终端用户随意改动的场景。	禁用时，所有终端用户均可进行列/卡片设置。
汇总行	对整列数据进行汇总，支持计数、求和、平均、公式、最小值和最大值。适用于需要整体统计的场景，例如汇总所有风机的发电量。	仅资产维度非设备，且使用客户端分页时可用。
汇总行位置	选择汇总行在表格中的显示位置，支持 `表格顶部` 和 `表格底部`。	默认为 `表格底部`。需先启用汇总行。
汇总行前缀	选择是否显示汇总行的前缀，如求和、公式等。	需先启用汇总行。汇总行前缀显示在汇总数据之前，如下所示。<br />
当前时间	在页面下方显示当前时间、最新刷新时间、最后更新时间和资产总数。适用于需要确认数据新鲜度的监盘场景。	样式如下所示。<br />
主题	设置页面视觉主题，支持 `跟随应用`、`黑色`、`绿色` 和 `白色`。	资产列表作为数字孪生可视化（DTV）组件嵌入时，此配置项不可见，页面主题由所在容器决定。

配置刷新间隔¶

刷新间隔 是系统自动从服务端重新获取并更新页面数据的时间周期，以秒为单位。你可以分别为以下两类数据设置刷新间隔：

实时数据：变化迅速、需要即时监控的数据，例如瞬时功率、实时风速。建议设置较短的刷新间隔，取值范围为 3–3600 秒。
时序数据：用于趋势分析、变化相对较慢的累积性或统计性数据，例如累计发电量。建议设置较长的刷新间隔，取值范围为 10–3600 秒。

两类数据的刷新间隔默认均为 60 秒。

自定义 UI 文案¶

为满足项目的术语展示、品牌露出等定制化需求，你可以统一替换资产列表页面中的部分内置词汇，包括配置页面和终端页面。例如将标准术语“场站”批量替换为业务术语“园区”或“电站”。

按照以下步骤配置界面文案：

在 基础配置 步骤页中找到 自定义 UI 文案。
选择 + 添加，在键名列选择或输入一个键名。每个键名仅能配置一次。
在 默认文案 列查看将被替换的文案。
在 自定义文案 列输入替换后的文案，支持国际化输入。

配置后，页面中的默认文案将统一替换为自定义文案。后续步骤中自行输入的名称（如列的展示名称、操作按钮名称）不受影响。

若页面此前使用旧版的 场站名称 配置项，升级后该配置将自动转换为对应的界面文案配置，无需手工迁移。

资产配置¶

在 资产配置 步骤中，你可以指定资产列表页面可展示的资产范围，以及终端用户可用的筛选器。

配置资产范围¶

配置项	说明与适用场景	条件与限制
资产类型	资产列表页面可展示的资产类型，如风电、光伏。例如区域列表中需依次显示风电、水电和光伏场站时，可选择这三种类型。	必填。选择多个类型后，可拖动各类型左侧的排序图标调整显示顺序，该顺序即为筛选器中的选项顺序。
设备类型	设备列表页面可展示的设备类型，如风机、电表。	资产维度为设备时必填。候选范围随已选资产类型联动，调整资产类型后系统会自动增删对应的设备类型。支持拖拽排序。
跨场站设备查询	允许终端用户同时查询多个场站下的设备。适用于跨场站对比同类设备的场景，例如同时查看多个风场的风机功率。	仅资产维度为设备时可用。启用后查询范围显著扩大，可能影响页面性能，建议结合按场站分组使用并评估数据量。

备注

资产类型及其名称由 EnOS 通用数据服务中的业务对象类型决定。如需定义其它资产类型，联系系统管理员。

配置资产类型筛选器¶

启用后，终端用户可按资产类型筛选页面中的资产。

你可以在 显示名称 中配置筛选器内资产类型的显示方式：

按类型：显示资产模型的类型名称。以风电为例，筛选器中显示为“风场”。
按产业：显示资产所属的业务领域名称。以风电为例，筛选器中显示为“风电”。

适用场景：终端用户熟悉的业务称谓与模型名称不一致时，通过此配置项对齐业务口径。

配置资产筛选器¶

筛选器	说明与适用场景	条件与限制
场站筛选器	供终端用户按场站筛选资产。	仅资产维度为场站或设备时生效。
区域筛选器	供终端用户按区域筛选资产。	仅资产维度为区域时生效。
设备类型筛选器	供终端用户按设备类型筛选设备。	仅资产维度为设备时生效，默认启用。
设备筛选器	供终端用户筛选具体设备。	仅资产维度为设备时生效。

有关终端用户如何使用筛选器，参见筛选资产。

启用 设备类型筛选器 后，可进一步配置以下项目：

配置项	说明与适用场景	条件与限制
筛选器样式	选择筛选器的展示形式，支持 `下拉框` 和 `平铺按钮`。设备类型数量较少（如 2–5 种）时使用平铺按钮可减少一次点击；类型较多时建议使用下拉框。	默认为 `下拉框`。
选择方式	选择终端用户可单选还是多选设备类型。需要同时对比多种设备类型的数据时使用多选。	默认为 `单选`。`多选` 仅在使用客户端分页时可用。
按资产过滤	根据终端用户已选的资产缩小设备类型的可选范围，避免出现当前场站下不存在的设备类型。	仅在“客户端分页 + 平铺资产树 + 单选设备类型”的组合下可用。

启用 设备筛选器 后，可进一步配置 资产树样式：

按列表展示：以资产类型为单位平铺展示场站中的设备。适用于设备层级简单、需要快速定位的场景。
按层级展示：继承应用门户中组织结构的层级关系展示设备。适用于存在设备父子层级（如风机与其部件）的场景。

同步资产¶

启用后，终端用户从资产列表跳转到其它监测页面时，目标页面将默认选中当前页面已选的资产。在资产列表中定位到异常设备后，跳转到曲线工具或通用指标查询继续分析，无需重新选择资产。例如在资产列表中选择“风机-1”和“风机-2”，打开通用指标查询时页面将自动展示这两台风机的数据。

操作配置¶

在 操作配置 步骤中，你可以为终端用户开放批量操作、资产控制和服务请求能力。

资产维度 为区域时不支持操作配置。

配置批量操作¶

批量操作 允许终端用户勾选多个资产后，通过自定义按钮跳转到指定页面执行业务操作，例如批量派发工单。

按照以下步骤配置批量操作：

启用 批量操作，选择支持批量操作的场站类型或设备类型。

在 批量操作 中选择添加，并配置以下信息。

字段	说明	条件与限制
操作按钮名称	按钮在页面中的显示名称，支持国际化输入。	必填。
最大操作数量	单次批量操作可选择的最大资产数量。	取值范围为 1–200，默认为 200。应结合下游系统的处理能力设置。
跳转方式	目标页面的打开方式，支持 `新页面打开`、`当前页面打开`、`底部抽屉`、`右侧抽屉` 和 `居中弹窗`。	抽屉与弹窗形式可避免终端用户离开当前列表，适用于操作后需继续核查的场景。
跳转地址	目标页面的地址。	必填。
批量操作条件	指定一个属性作为约束，仅当所选资产的该属性值相同时才可被同时选中操作。	适用于操作参数依赖资产属性的场景，例如仅允许同型号设备一起下发配置。终端用户选中属性值不同的资产时，页面将提示无法同时操作。

如需配置多个按钮，重复步骤 2。拖动按钮左侧的排序图标可调整显示顺序。单个资产列表页面最多可配置 3 个批量操作按钮。

配置资产控制¶

资产列表可集成集群控制中的控制面板，实现资产监测与控制的一体化。

配置项	说明与适用场景	条件与限制
单点控制	允许终端用户逐个控制资产。启用后，终端用户可选择操作列中的控制按钮打开控制面板。	需在场站/设备类型中选择支持单点控制的资产类型。
批量控制	允许终端用户批量控制资产。启用后，终端用户可选择页面中的批量控制打开控制面板。	需在场站/设备类型中选择支持批量控制的资产类型，并设置最大控制数量。仅列表样式支持批量控制，且终端用户需拥有资产控制权限点。

备注

最大控制数量 应结合场站或设备场景以及下游系统的处理能力设置，避免单次选择过多资产导致控制指令堆积。

配置发送服务请求¶

启用后，终端用户可在监测资产的同时快速发送资产服务请求（Service Request，SR）。终端用户可选择操作列中的 发送服务请求 按钮打开服务请求页面。

需在 场站/设备类型 中选择支持发送服务请求的资产类型。仅已选类型的资产会显示该按钮。

配置列表配置项¶

列表配置 用于定义资产的跳转地址、操作列、无连接状态和资产状态数据。此入口位于资产列表运行态页面，需在 基础配置 > 操作栏按钮 中勾选 列表配置 后才可见。

配置跳转地址¶

为资产类型配置跳转地址后，终端用户可通过选择列表中的资产名称跳转到指定页面，实现从列表到详情的下钻。

按照以下步骤配置跳转地址：

在左侧导航栏中选择 资产列表。
在资产列表页面选择 列表配置 ，并选择跳转标签页。

为各个资产类型配置以下信息。

字段	说明	条件与限制
打开方式	跳转页面的打开方式，支持 `新页面打开`、`当前页面打开`、`底部抽屉`、`右侧抽屉` 和 `居中弹窗`。	选择抽屉或弹窗时，可进一步配置尺寸。
跳转地址	目标页面的地址。	必填。
抽屉占页面比例	抽屉形式可设置占页面的比例，取值范围为 50%–85%；弹窗形式可分别设置宽度和高度，取值范围为 1–10000 像素。	仅打开方式为抽屉或弹窗时可配置。底部抽屉默认占 80%，右侧抽屉默认占 70%，居中弹窗默认为 700 × 600 像素。

选择确认。

为指定资产类型配置跳转地址后，此类型下的资产名称将在页面中显示为蓝色，如下图所示。

备注

资产维度 为场站且启用 区域聚合 时，可额外为区域名称配置跳转地址；资产维度 为区域时，可为区域配置跳转地址。

配置操作列¶

操作列位于列表最右侧，用于放置自定义操作按钮，让终端用户快捷执行特定操作或打开特定页面。

按照以下步骤配置操作列：

在左侧导航栏中选择 资产列表。
在资产列表页面选择 列表配置 ，并选择操作标签页。

选择 添加操作，并配置以下信息。

字段	说明	条件与限制
操作名称	操作按钮的显示名称，支持国际化输入。	必填。
打开方式	操作页面的打开方式，支持 `新页面打开`、`当前页面打开`、`底部抽屉`、`右侧抽屉` 和 `居中弹窗`。	选择抽屉或弹窗时，可进一步配置尺寸，取值范围与跳转地址一致。
跳转地址	目标页面的地址。	必填。

选择确认。

备注

单个资产列表页面最多可配置 3 个操作按钮。
资产维度 为设备且启用 按场站分组 时，可分别为场站行和设备行配置操作按钮。
操作列的宽度将根据按钮数量和名称长度自动调整。

资产列表页面中的操作按钮如下所示：

配置无连接状态¶

无连接状态用于标识资产与 EnOS 云端失去数据连接。

按照以下步骤配置无连接状态：

在左侧导航栏中选择 资产列表。
在资产列表页面选择 列表配置 ，并选择 无连接 标签页。

配置以下信息。

字段	说明	条件与限制
显示无连接状态	启用后，无连接资产的测点和指标将标记为灰色，且该资产的数据不参与汇总和排序。	禁用时，相关资产正常显示并参与汇总和排序。适用于需要排除失联资产、避免污染统计结果的场景。
定义无连接状态	为每个资产类型选择一个数据项并输入特征值。当某资产该数据项的值等于特征值时，系统判定该资产处于无连接状态。	需为每个需要判定的资产类型分别配置。

选择确认。

启用 显示无连接状态 后，资产列表中无连接状态的设备如下所示。

配置资产状态数据¶

资产状态数据用于在资产卡片上集中展示资产的状态类测点，例如设备的运行、停机与故障状态。

按照以下步骤配置资产状态数据：

在左侧导航栏中选择 资产列表。
在资产列表页面选择 列表配置 ，并选择 资产状态数据 标签页。

配置以下信息。

字段	说明	条件与限制
状态数据	选择在卡片中展示的状态测点。	不支持卡片样式时，系统使用默认状态数据。
显示数据名称	在卡片中的状态值前显示数据项名称。	适用于配置了多个状态数据、需要区分含义的场景。
显示状态统计	统计并显示各状态下的资产数量。	适用于快速判断某类状态资产的规模。

选择确认。

此配置项仅在 样式类型 包含卡片，且 资产维度 非区域时可见。

配置指标卡片¶

指标卡片位于列表或卡片区域上方，用于保存一组数据项条件，供终端用户一键筛选目标资产。

按照以下步骤配置指标卡片：

在左侧导航栏中选择 资产列表。
在资产列表页面选择 指标卡片配置 。

选择 新增指标卡片，或将光标悬停在已有卡片上并选择编辑图标，之后配置以下信息。

字段	说明	条件与限制
指标	选择 1–2 个用于筛选资产的数据项，并分别配置逻辑运算符与阈值；两个条件可指定“且”或“或”关系。例如设置为 `有功功率 < 10MW` 或 `出力比 < 10%`，即可筛选出所有有功功率小于 10MW 或出力比小于 10% 的资产。枚举数据项仅支持按枚举值相等筛选。	候选项来自当前列表列、卡片数据项和卡片状态数据中当前时间类型可用的数据项，不包含资产名称列和操作列。区域维度不支持 DI 数据项；服务端分页时，数据项还需支持相应过滤运算符，并限制部分数据类型。最多添加 2 个指标。
卡片颜色	设置指标卡片的显示颜色，影响普通、悬停和选中状态的背景、边框，以及文字和计数的颜色。	默认蓝色。始终可配置；不影响筛选条件、候选数据项或筛选结果。
显示数据名称	控制枚举型指标卡片是否在枚举值前显示数据项名称。启用后显示“数据项名称：枚举值”，禁用后仅显示枚举值。	仅所选指标中包含枚举数据项时显示。默认关闭。不支持在此处自定义或国际化输入名称，名称随数据项元数据和页面显示语言解析。

选择确定将该卡片添加到页面中。
（可选）如需删除卡片，将光标悬停在卡片上并选择删除图标。
选择确定。

备注

终端用户点选指标卡片时的筛选逻辑由 基础配置 > 指标卡片样式 决定。启用 指标卡片计数 后，卡片上还会显示命中的资产数量。

保存为 OU 模板¶

本 OU 下的所有终端用户打开资产列表时，页面将默认加载 OU 模板。OU 模板包含以下信息：

当前样式与列、卡片设置
指标卡片
筛选项
表格列宽与资产排序

按照以下步骤将当前页面配置保存为 OU 模板：

在左侧导航栏中选择 资产列表。
在资产列表页面选择 保存模板 。
在 模板类型 中选择 OU 模板。
选择保存。

备注

保存 OU 模板需要 OU 模板相关权限点。终端用户可在 OU 模板的基础上保存个人模板，更多信息，参见保存模板。

发布资产列表页面¶

通过以下步骤发布配置完成的资产列表页面，让终端用户在相应应用中查看页面并使用相应功能：

在左侧导航栏中选择 资产列表。
在资产列表页面选择 功能配置 打开资产列表配置页面。
选择发布。
在弹窗中输入此次发布的修改说明等内容作为备注。
选择确认。

备注

发布前请确认已选择至少一种数据类型、一种样式类型和一种资产类型；资产维度 为设备时还需选择至少一种设备类型；已启用的操作项需配置对应的生效资产类型。否则将无法发布。

恢复历史版本¶

版本历史列表中包含已发布页面的版本号、修改人、修改时间和备注等信息。如需使用之前的资产列表页面，通过以下步骤将当前页面恢复为历史版本：

在左侧导航栏中选择 资产列表。
在资产列表页面选择 功能配置 打开资产列表配置页面。
选择 历史版本 打开历史版本列表。
在列表中选择相应版本的恢复。版本历史列表最多保留最近 100 条历史记录。
在弹窗中选择确认。

导出或导入页面¶

资产列表支持以 JSON 文件形式导出或导入以下内容，实现同一页面的迁移与复用：

页面功能配置
资产与数据项配置

导出页面¶

在左侧导航栏中选择 资产列表。
在资产列表页面选择 功能配置 打开资产列表配置页面。
选择 导入/导出 > 导出，浏览器将自动下载配置文件。

导入页面¶

在左侧导航栏中选择 资产列表。
在资产列表页面选择 功能配置 打开资产列表配置页面。
选择 导入/导出 > 导入。
在弹窗中选择上传，上传 JSON 配置文件。
选择确定。

配置 URL 参数¶

除进行以上配置外，应用开发人员可通过配置菜单 URL 中的参数启用或禁用页面功能，例如指定页面的资产维度、默认选中的资产与设备类型、可用的筛选器等。更多信息，参见 URL 参数说明。