配置通用指标查询¶
本文介绍应用开发人员如何配置通用指标查询页面,以便终端用户按业务需要查询资产的属性与指标数据,并以报表的形式汇总分析。
前提条件¶
当前账号已在目标应用中拥有 通用指标查询 页面的菜单访问权限,以及通用指标查询的模板配置权限点。如未分配,联系 OU 管理员。
已在 EnOS 中注册相关资产的属性、指标和维度类型。如有需要,可通过 EnOS 通用数据服务 API 查询已注册数据。
已阅读 探索通用指标查询,了解通用指标查询页面的各项功能。
备注
统一监测支持自定义菜单名称,因此实际菜单名称可能与本文有所差异,下文将使用默认名称“通用指标查询”指代应用中配置的通用指标查询菜单。
进入通用指标查询配置页面¶
应用开发人员的账号拥有通用指标查询的模板配置权限点后,可按照以下步骤进入配置页面:
配置页面包含四个标签页,分别决定页面的不同方面:
标签页 |
决定的内容 |
典型调整时机 |
|---|---|---|
基础配置 |
终端用户能否自行修改查询条件、能否使用模板,以及汇总行的位置和页面的 UI 文案。 |
需要固定报表视图,或需要把汇总行置顶时。 |
资产配置 |
页面支持的资产颗粒度、资产类型与设备类型,以及资产的筛选与排序方式。 |
页面上线前必须配置,决定了终端用户能查到哪些资产。 |
时间配置 |
终端用户可用的时间间隔、快捷时间范围与结束时间口径。 |
需要收窄时间粒度范围,或需要按自然周期对齐结束时间时。 |
数据配置 |
数据分类的来源,以及终端用户可用的数据筛选能力。 |
需要开放按枚举值筛选或按条件筛选与排序时。 |
配置页面功能¶
基础配置¶
在 基础配置 标签页中,你可以决定终端用户在页面上可自行调整的范围,并设置汇总行位置与界面文案。
配置项 |
说明 |
默认值 |
|---|---|---|
修改查询条件 |
启用后,页面顶部显示报表范围摘要栏,终端用户可选择它打开 报表配置 弹窗,自行修改本次查询的资产、数据和时间。禁用后摘要栏对终端用户隐藏,页面只展示默认视图或模板中已固化的报表;拥有模板配置权限的用户仍可看到摘要栏。适用于需要统一报表口径的场景。 |
|
模板 |
启用后,页面左上角显示模板入口,终端用户可应用、保存和管理报表模板。禁用后模板入口对终端用户隐藏;拥有模板配置权限的用户仍可管理模板。 |
|
模板菜单样式 |
模板入口的展开形式。 |
|
汇总行位置 |
开启时间小计后,汇总行在报表中出现的位置。 |
|
自定义 UI 文案¶
为满足项目的术语展示、品牌露出等定制化需求,你可以统一更新通用指标查询界面的部分特定词汇,配置页面与终端页面同时生效。例如,可将标准术语“场站”批量替换为业务术语“电站”。
按照以下步骤自定义界面文案:
在 基础配置 标签页中找到 自定义 UI 文案。
选择 添加,在 键名 列选择或输入一个键名。每个键名仅能配置一次,最多可配置 100 条。如需自定义更多文案,可联系系统管理员获取键名。
键名在文案资源中不存在时,页面提示 键名无效。
键名已在表格中出现时,页面提示 键名已添加。
在 默认文案 列,可查看将被替换的文案。
在 自定义文案 列,输入更新后的文案,支持按界面语言分别输入,单个语种最多 200 个字符。
配置后,系统文案中的 默认文案 值将统一替换为 自定义文案 值。后续自行输入的文案(如数据列名称、模板名称、操作按钮名称)不受影响。
资产配置¶
在 资产配置 标签页中,你可以决定报表支持的资产范围,以及终端用户筛选资产的方式。
配置项 |
说明 |
默认值 |
|---|---|---|
资产颗粒度 |
报表支持的查询颗粒度,可多选。 |
|
资产类型 |
报表支持的资产类型,至少选择一种。资产类型由 EnOS 通用数据服务中的业务对象类型决定,如风电、光伏。选定后,下方表格中会为每个资产类型生成一行。 |
全部场站类型 |
(资产类型表格) |
逐个资产类型配置 跨场站设备查询 与 设备明细查询 两个开关,并可拖动排序图标调整资产类型顺序。尚未选择资产类型时,表格显示“请先选择资产类型”。 |
跨场站设备查询关闭,设备明细查询开启 |
跨场站设备查询 |
启用后,终端用户在设备颗粒度下可多选场站,一次查询多个场站下的设备;关闭后每次只能选择一个场站。适用于横向对比多个场站同类设备的场景。 |
关闭 |
设备明细查询 |
启用后,终端用户可逐个选择要查询的设备。关闭后该资产类型进入设备大数据模式,详见 设备大数据模式。 |
开启 |
设备类型 |
报表支持的设备类型,至少选择一种。可选范围由已选资产类型所属的业务领域决定,因此变更资产类型时设备类型会同步增删。有值时下方显示设备类型列表,可拖动排序图标调整顺序。仅当 资产颗粒度 包含 |
随资产类型自动选中 |
资产展示顺序 |
资产在报表行中的排列依据。 |
|
资产树样式 |
设备筛选器与 选择资产范围 中资产列表的展示样式,可多选。 |
|
资产筛选器 |
启用后,筛选器行中显示资产筛选器,终端用户可不打开 报表配置 弹窗直接切换资产。 |
|
维度筛选器 |
启用后,筛选器行中为报表里每个带枚举值的维度生成一个筛选器,终端用户可按维度值过滤报表行。 |
|
显示无枚举维度 |
启用后,未注册枚举值的维度也会作为列显示在报表中。适用于维度值由业务数据动态产生、无法预先枚举的场景。仅当 汇总行位置 为 |
|
同步资产筛选范围 |
启用后,终端用户切换模板或打开其它指标查询页面时,默认沿用当前页面已选中的场站范围,无需重新选择。仅对资产颗粒度为场站、且场站类型相同的页面生效。 |
关闭 |
备注
资产颗粒度、资产类型 和 资产树样式 为空时无法发布页面。
设备大数据模式¶
关闭某个资产类型的 设备明细查询 后,该资产类型在设备颗粒度下进入设备大数据模式,由服务端按场站加设备类型聚合并分页。这一模式适用于单场站设备数量极大、逐台勾选不现实的场景,但对终端用户有三点可见影响,建议在配置时一并告知:
终端用户只能选择场站,页面不再显示设备筛选器。
可选数据项变少:只有支持维度筛选与分页能力的指标才会出现在 选择数据 中。
报表不支持 按维度小计。按维度小计 在所有设备颗粒度的报表中都不可用,并非设备大数据模式独有的限制。
时间配置¶
在 时间配置 标签页中,你可以决定终端用户可用的时间间隔与时间范围。
配置项 |
说明 |
默认值 |
|---|---|---|
时间间隔筛选器 |
启用后,筛选器行中显示时间间隔筛选器,终端用户可自行切换报表的时间粒度。禁用后时间粒度固定,由下方 时间间隔 决定。 |
|
时间间隔 |
终端用户可选的时间间隔范围。 |
|
快捷时间范围设置 |
启用后,筛选器行中显示快捷时间范围筛选器,终端用户可按预设范围一键指定起止时间。 |
|
结束时间 |
快捷时间范围的结束时间口径。 |
|
时间范围 |
终端用户可选的快捷时间范围。 |
|
同步时间筛选范围 |
启用后,终端用户切换模板或打开其它指标查询页面时,默认沿用当前页面已选中的时间范围,无需重新选择。 |
关闭 |
备注
时间间隔 或 时间范围 选择
指定时,对应选择器的行为取决于筛选器开关:筛选器启用时为多选,终端用户可在所选范围内切换;筛选器禁用时为单选,即把报表固定为某一个时间间隔或时间范围。终端用户实际可选的快捷时间范围还会随时间间隔收窄。例如时间间隔为
年时,只保留当年、上一年和最近3年。
数据配置¶
在 数据配置 标签页中,你可以决定数据分类的来源与终端用户可用的筛选能力。
配置项 |
说明 |
默认值 |
|---|---|---|
数据分类字段组 |
页面读取数据分类时所使用的业务对象字段组的键。该键决定 选择数据 弹窗中 数据分类 列的取值。除有特殊约定外,保持默认值即可。如需配置业务对象字段组,可联系系统管理员。 |
|
数据列筛选器 |
启用后,筛选器行中显示数据筛选器,终端用户可勾选要显示的数据列,无需重新配置报表。 |
|
按枚举值筛选 |
启用后,可在 选择数据 中为带枚举值的数据项逐个开启枚举筛选,终端用户即可在筛选器行中按枚举值过滤报表行。例如按设备状态只看“故障”的设备。 |
|
按条件筛选与排序 |
启用后,筛选器行中显示 筛选 入口,终端用户可按指标阈值过滤报表行,并可点击表头对指标列排序。 |
|
设备类型可视化分组 当前不支持在配置页面直接编辑。导入包含 deviceGroupKey 的页面配置后,该配置仍会生效;如需新增或修改该配置,请联系系统管理员。
发布页面¶
完成配置后,按照以下步骤发布页面,使配置对终端用户生效:
在配置页面的右上角选择 发布。
在弹窗中输入此次发布的修改说明等内容作为 备注。备注将显示在历史版本列表中,便于后续定位与回滚。
选择 确认。
备注
发布前请确认 资产颗粒度、资产类型 和 资产树样式 均已填写,否则无法发布。退出配置页面而不发布时,本次改动会被丢弃。
报表筛选器与配置项对照¶
终端用户在筛选器行中看到的每个筛选器,都由功能配置中的一个开关控制。下表列出筛选器与配置项的对应关系,便于排查“终端用户看不到某个筛选器”的问题:
筛选器 |
所在标签页 |
配置项 |
附加条件 |
|---|---|---|---|
资产筛选器 |
资产配置 |
资产筛选器 |
— |
维度筛选器 |
资产配置 |
维度筛选器 |
报表中该维度已注册枚举值 |
枚举筛选器 |
数据配置 |
按枚举值筛选 |
该数据项在 选择数据 中已勾选按枚举值筛选,且当前未开启按维度小计 |
时间间隔筛选器 |
时间配置 |
时间间隔筛选器 |
报表中已包含指标 |
快捷时间范围筛选器 |
时间配置 |
快捷时间范围设置 |
报表中已包含指标 |
自定义时间区间 |
时间配置 |
时间范围 |
取值为 |
数据筛选器 |
数据配置 |
数据列筛选器 |
— |
筛选(按条件筛选) |
数据配置 |
按条件筛选与排序 |
当前未开启按维度小计,且报表中存在支持筛选的指标 |
筛选器行如下所示。
筛选器行只在页面已完成一次查询后出现。首次进入且未配置查询条件时,页面显示“未配置查询条件,点击此处”。
配置查询条件¶
除页面功能外,你还需要构建一张具体的指标查询报表,作为终端用户进入页面时看到的初始视图。报表配置按四个步骤依次完成:
配置维度和统计规则:决定报表的资产颗粒度、资产类型、维度列与统计方式。
选择资产范围:决定报表包含哪些资产。
选择数据:决定报表包含哪些数据列及其展示方式。
选择时间范围:决定报表数据的时间间隔与起止时间。
通过以下步骤配置报表:
在左侧导航栏中选择 通用指标查询。
在页面顶部选择报表范围摘要栏或其右侧的 更多,打开 报表配置 弹窗。
依次完成以下四个步骤,然后选择 应用。任一步骤中选择 重置 可清空全部已选内容重新开始。
配置维度和统计规则¶
字段 |
说明 |
|---|---|
资产颗粒度 |
报表的查询颗粒度,可选 ``场站级``(查询场站的总体指标)、``设备组级``(查询场站中特定类型设备组的指标)和 ``设备级``(查询场站中具体设备的指标)。可选范围由功能配置中的 资产颗粒度 决定,只有一个可选项时该字段不显示。 |
所属资产类型 |
报表中资产的类型。资产颗粒度为 |
维度 |
报表中单独成列、展示于资产名称左侧的维度,需预先在通用数据服务的维度类型中注册。选择 添加 打开维度选择弹窗,已添加的维度可拖动排序、可删除(必选维度不可删除)。标题处显示 |
统计方式 |
维度数据的呈现方式。 |
选择资产范围¶
在 选择资产范围 中勾选报表包含的资产。展示的资产树随资产颗粒度变化:
场站级:多选场站树。
设备组级:设备组树。
设备级:场站树加设备树。关闭跨场站设备查询时场站为单选;处于设备大数据模式时只显示场站树。
选择资产时还可使用以下功能:
切换资产树:当前 OU 配置了多套组织结构时,可在资产树右上角切换组织结构。
切换资产树样式:功能配置中同时开放两种样式时,可在
按列表展示与按层级展示之间切换。
选择数据¶
在 选择数据 中添加报表包含的数据列:
添加单项数据:选择 + 数据 打开 选择数据 弹窗,在弹窗中按数据名称、标识符、数据分类、时间间隔、数据类型、资产类型等条件查找并勾选数据项,然后选择 确认。
添加数据组:选择 + 分组 新建一个分组,输入分组名称后在组内选择 添加数据。数据组在报表中作为二级表头呈现,适用于把同类指标归拢在一起。
所选指标之间需要拥有共同时间间隔,否则无法进入下一步。
数据组在报表中显示如下:
数据项与分组均可拖动排序,分组名称支持按界面语言分别输入。展开某个数据项后,可配置以下信息:
字段 |
说明 |
条件与限制 |
|---|---|---|
名称 |
此数据项在报表列头中的显示名称,支持按界面语言分别输入。 |
最多 50 个字符。留空时使用数据项的注册名称。 |
单位 |
此数据项的单位,支持按界面语言分别输入,显示在列头名称之后。 |
最多 50 个字符。 |
按枚举值筛选 |
勾选后,终端用户可在筛选器行中按此数据项的枚举值过滤报表行。 |
仅当数据项已注册枚举值、支持枚举筛选,且功能配置中已启用 按枚举值筛选 时显示。 |
单位系数 |
用于数据过大或过小时调整数据位数,报表中显示的值为原始数值与单位系数的乘积。例如原始数据为 |
默认为 1。仅数值型数据项显示,枚举型数据项不显示。 |
条件 |
数据列的条件颜色。选择 添加 新建一行条件:数值型数据项配置取值区间与颜色;枚举型数据项配置枚举值与颜色,已使用的枚举值不可重复选择。条件由上至下判断,只采用第一个匹配条件的颜色。 |
仅整型、浮点型数据项或带枚举值的数据项支持。 |
选择时间范围¶
字段 |
说明 |
|---|---|
时间间隔 |
报表内相邻数据的时间间隔,取值为所有已选数据项时间间隔的交集,并受功能配置中的 时间间隔 限制。无可用值时显示 |
快捷时间范围 |
按预设范围指定起止时间,可选项随时间间隔变化。仅 快捷时间范围设置 启用时显示。 |
自定义时间区间 |
手动指定报表数据的起止时间。日历控件的选择粒度随时间间隔变化,例如时间间隔为 |
备注
本步骤仅在已选择指标、且时间间隔筛选器与快捷时间范围设置中至少启用一项时出现。时间范围过大时,查询会失败并提示“时间范围过大,请调整后重试”。
管理报表模板¶
报表模板用于固化一套完整的查询条件与展示设置,避免终端用户每次重复配置。模板主要包含以下信息:
资产颗粒度、资产类型和资产范围
维度与统计方式
数据列、数据分组与列顺序
时间间隔与时间范围
小计设置、数据展示位数、冻结列数与操作按钮
筛选条件与枚举筛选
模板分为两类:
我的模板:仅创建者本人可见,用于个人分析习惯的沉淀。
OU 模板:OU 内所有终端用户可见,需拥有模板配置权限点才能创建与编辑。用于向全员下发统一的报表口径。
启用报表模板¶
卡片式模板菜单如下所示。
下拉式模板菜单如下所示。
保存当前报表为模板¶
通过以下步骤将配置完成的指标查询报表保存为新模板或更新当前模板:
在左侧导航栏中选择 通用指标查询。
在保存模板弹窗中输入以下信息。
字段
说明
模板名称
输入该模板的名称,支持按界面语言分别输入,最多 30 个字符。名称为空时无法保存。导出报表数据时,若当前已应用模板,导出文件将以模板名称命名。
模板描述
输入该模板的描述,最多 100 个字符。留空时系统会按已选属性与指标自动生成描述。
模板类型
选择
OU 模板则该 OU 下其他用户也可使用此模板,选择我的模板则此模板仅限当前用户使用。仅拥有模板配置权限点的用户可选择模板类型,其他用户只能保存为我的模板。
模板分组
选择模板所属的分组,也可在此处直接新建分组。未选择时模板归入默认分组。
保存为组织默认视图 / 保存为我的默认视图
选择 是,进入 通用指标查询 页面时默认展示当前报表。模板类型为
OU 模板时该字段为 保存为组织默认视图,对 OU 内所有用户生效;为我的模板时为 保存为我的默认视图,仅对本人生效。个人默认视图优先于组织默认视图加载。将某个模板设为默认视图时,同类型其它模板的默认视图标记会被自动取消。
选择 确认。
另存模板为新模板¶
若当前页面已应用模板,且对原模板进行了修改,通过以下步骤将修改后的模板另存为新模板,原模板保持不变:
在左侧导航栏中选择 通用指标查询。
在保存模板弹窗中输入模板名称、模板描述、模板类型、模板分组等信息。各字段的说明与 保存当前报表为模板 相同。
选择 确认。
编辑模板¶
通过以下步骤修改模板的名称、描述和分组。模板中的查询条件与展示设置不会被修改,如需调整这些内容,应用该模板后重新保存。
不具备模板配置权限点的用户编辑 OU 模板时,系统会将修改结果保存为一个新的个人模板,原 OU 模板不变。
删除模板¶
管理模板分组¶
模板分组可用于按模板的适用场景、分析对象、时间范围等信息分类管理模板。模板数量较多时,分组能显著缩短终端用户查找模板的时间。模板面板中支持按分组名称搜索,命中分组名时展示该分组下的全部模板。
创建分组¶
在左侧导航栏中选择 通用指标查询。
选择 模板 打开模板面板。
选择 编辑分组 打开分组配置弹窗。
OU 模板的分组仅拥有模板配置权限点的用户可维护,我的模板的分组由本人维护。
编辑分组¶
在左侧导航栏中选择 通用指标查询。
选择 模板 打开模板面板。
选择 编辑分组 打开分组配置弹窗。
选择模板分组标签并编辑分组名称。
排序分组¶
在左侧导航栏中选择 通用指标查询。
选择 模板 打开模板面板。
选择 编辑分组 打开分组配置弹窗。
拖动分组标签旁的排序图标,编辑各分组在模板面板中的展示顺序。
删除分组¶
备注
删除分组会同时删除该分组下的所有模板,且不可恢复。如需保留模板,请先将其移动到其它分组。
恢复历史版本¶
历史版本列表中包含已发布页面的版本号、修改人、修改时间、备注等信息。如需使用之前的通用指标查询页面配置,通过以下步骤将当前页面恢复为历史版本:
导入或导出页面配置¶
通用指标查询支持以 JSON 文件形式导入或导出以下内容,实现同一页面在不同应用或不同环境之间的迁移与复用:
页面功能配置
查询条件与数据列配置
模板与模板分组
导出页面配置¶
导入页面配置¶
导入后,配置文件中的内容会填充到各标签页中,你可以继续调整后再发布。导入的资产类型在当前 OU 中不存在时会被自动过滤,因此导入后建议逐个标签页复核。
备注
配置文件缺少必要字段时导入不会生效。若导入后配置没有变化,请确认配置文件是否完整。
配置 URL 参数¶
除进行以上配置外,应用开发人员可通过配置菜单 URL 中的参数启用或禁用页面功能,或指定页面打开时的默认查询条件。更多信息,参见 URL 参数说明。





