配置曲线工具¶

本文介绍应用开发人员如何配置曲线工具页面，以便终端用户按业务需要查询资产的测点与指标数据，并以时序图的形式分析数据变化趋势。

前提条件¶

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

备注

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

进入曲线工具配置页面¶

应用开发人员的账号拥有曲线工具的模板配置权限点后，可按照以下步骤进入曲线工具配置页面：

在目标应用的左侧导航栏中选择 曲线工具。
在页面右上角选择 功能配置 。

曲线工具配置页面包含四个标签页，分别决定页面的不同方面：

标签页	决定的内容	典型调整时机
基础配置	终端用户能否自行修改查询条件、能否使用模板，以及页面的 UI 文案。	需要固定页面视图，或需要替换界面术语时。
资产配置	页面支持查询的资产维度、资产类型与设备类型，以及资产的选择方式与展示名称。	页面上线前必须配置，决定了终端用户能查到哪些资产。
时间配置	终端用户可用的时间间隔、数据对比方式、时间聚合方式与时区。	需要收窄时间间隔范围，或需要按指标特性开放聚合方式时。
数据配置	页面支持查询的数据类型、数据项的分类与筛选方式，以及图表的刷新与布局行为。	需要按可视化分组组织数据项，或需要开启自动刷新时。

必填项未填写完整时，无法切换到其它标签页，也无法发布页面。

配置页面功能¶

基础配置¶

在 基础配置 标签页中，你可以决定终端用户在页面上可自行调整的范围，并自定义界面文案。

配置项	说明	默认值
修改查询条件	启用后，页面顶部显示查询条件栏，终端用户可自行修改本次查询的资产、数据项和时间。禁用后查询条件栏对终端用户隐藏，页面只展示组织默认视图或模板中已固化的图表；拥有模板配置权限的用户仍可看到查询条件栏。适用于需要统一监盘视图的场景。	`启用`
模板	启用后，页面左上角显示模板入口，终端用户可应用、保存和管理图表模板。禁用后模板入口对终端用户隐藏；拥有模板配置权限的用户仍可管理模板。	`启用`
模板菜单样式	模板入口的展开形式。`卡片式` 以面板形式平铺展示模板卡片，便于浏览模板描述；`下拉式` 以下拉列表展示模板名称，占用空间更小。仅在模板启用时可配置。	`下拉式`

自定义 UI 文案¶

为满足项目的术语展示、品牌露出等定制化需求，你可以统一更新曲线工具界面的部分特定词汇，配置页面与终端页面同时生效。例如，可将标准术语“场站”批量替换为业务术语“门店”。

按照以下步骤自定义界面文案：

在 基础配置 标签页中找到 自定义 UI 文案。
选择添加，在键名列选择或输入一个键名。每个键名仅能配置一次，最多可配置 100 条。如需自定义更多文案，可联系系统管理员获取键名。
- 键名在文案资源中不存在时，页面提示 键名无效。
- 键名已在表格中出现时，页面提示 键名已添加。
在 默认文案 列，可查看将被替换的文案。
在 自定义文案 列，输入更新后的文案，支持按界面语言分别输入，单个语种最多 200 个字符。

配置后，系统文案中的 默认文案 值将统一替换为 自定义文案 值。后续自行输入的文案（如模板名称、自定义分析对象名称、数据项分组展示名称）不受影响。

资产配置¶

在 资产配置 标签页中，你可以决定页面支持查询的资产范围，以及终端用户选择资产的方式。

配置项	说明	默认值
资产维度	页面支持的分析对象层级，可多选。`场站组` 针对场站以上的资产层级（如集团、区域）进行汇总分析；`场站` 针对单个或多个场站进行分析；`设备` 针对场站内的具体设备进行分析。此处所选维度将成为终端用户在图表范围中可切换的选项，因此建议仅保留业务需要的维度，避免终端用户误选。	`场站组`、`场站`、`设备`
资产类型	页面支持的资产类型，至少选择一种。资产类型由 EnOS 通用数据服务中的业务对象类型决定，如风电、光伏。选定后，终端用户在页面中仅可查看指定类型的资产。	未选择
设备类型	页面支持的设备类型，至少选择一种。可选范围由资产类型所属的业务领域决定，因此变更资产类型时设备类型会同步增删。有值时下方显示设备类型列表，可拖动排序图标调整终端用户看到的设备类型顺序。仅当资产维度包含 `设备` 时可配置。	随资产类型自动选中
跨场站设备查询	启用后，终端用户可在场站树中多选场站，一次查询多个场站下的设备；禁用后每次只能选择一个场站。适用于横向对比多个场站同类设备的场景。可同时选择的场站数量上限由部署环境配置决定。	`启用`
资产树样式	设备筛选器与选择资产中资产列表的展示样式，可多选。`按层级展示` 继承应用门户中组织结构的层级结构；`按列表展示` 以设备类型为单位平铺展示场站中的设备。同时选择两项时，终端用户可在页面中切换资产树样式。仅当资产维度包含 `设备` 时可配置。	`按列表展示`
资产筛选器	启用后，查询条件栏中显示资产筛选器，终端用户可不打开修改查询条件弹窗直接切换资产。禁用后终端用户只能在修改查询条件弹窗中选择资产。	`启用`
过滤无权限节点	是否在资产树中隐藏当前账号无直接资产权限的父节点。此项仅用于回显菜单 URL 参数 `filterParentNodes` 的取值，不能在本页面编辑；在菜单 URL 中设为 `true` 时启用，未设置时保持禁用。该功能与节点权限校验不同，后者可能使节点可见但不可选。	``禁用``（只读）
展示名称配置	设备在图表、图例和数据表中的名称来源。`资产名称` 使用资产的注册名称；`按属性展示` 使用指定属性的值作为名称，适用于设备名称不具业务含义、需改用编号或位号展示的场景。选择 `按属性展示` 时，必须在选择属性中指定一个属性才能发布。	`资产名称`

时间配置¶

在 时间配置 标签页中，你可以决定终端用户可用的时间间隔、数据对比方式与时区。

配置项	说明	默认值
时间聚合筛选器	启用后，终端用户可为测点数据指定时间聚合方式，可选 `First`、`Last`、`Avg`、`Sum`、`Max`、`Min`。不启用或终端用户未指定时，系统默认使用 `First` 方式聚合测点数据，即取每一时间间隔的第一个值。时间聚合仅对测点数据生效，对指标数据无影响。	`禁用`
时间间隔	终端用户可选的时间间隔范围。`默认` 开放全部时间间隔；`指定` 仅开放你在选择时间间隔中勾选的间隔。当业务只关注特定粒度（如仅按日、月统计）时，建议选择 `指定`，避免终端用户选出数据量过大的查询。	`默认`
选择时间间隔	开放给终端用户的时间间隔，至少选择一项。可选 `1分钟`、`5分钟`、`10分钟`、`15分钟`、`30分钟`、`1小时`、`日`、`月`、`年`。仅当时间间隔为 `指定` 时可配置。	全部
环比	启用后，终端用户可在数据对比中选择 `日环比`、`月环比`、`年环比`，在图表中叠加显示数据项上一周期的数据。	`启用`
同比	启用后，终端用户可在数据对比中选择 `上年同期`，在图表中叠加显示数据项上一年同一时段的数据。	`启用`
时区	启用后，图表横轴、悬浮提示框与数据表的时间戳将附带时区标识，便于跨时区团队核对数据归属时段。	`禁用`

备注

时间间隔越细，单次查询可覆盖的时间跨度越短。终端用户选择超出跨度的日期时，日期选择器中的日期不可选并给出提示。具体阈值由部署环境配置决定，参见使用限制。

数据配置¶

在 数据配置 标签页中，你可以决定页面支持查询的数据类型、数据项的分类与筛选方式，以及图表的刷新与布局行为。

首先配置数据类型，它决定了本标签页中其余配置项是否出现：

配置项	说明	默认值
数据类型	页面支持的数据类型，至少选择一种。`测点` 是设备上送的原始物理读数，`指标` 是通用数据服务按时间粒度统计的业务量。例如若此处只选择 `测点`，终端用户在选择数据中仅能添加测点类型的数据项。	`测点`、`指标`
多数据类型查询	启用后，终端用户可在一张图表中同时查询测点和指标；禁用后两者只能分别查询。仅当数据类型同时包含 `测点` 和 `指标` 时可配置。	`禁用`

以下配置项仅在 数据类型 包含 测点 时出现。仅选择 指标 时，这些配置项及其已有取值都不会生效。

配置项	说明	默认值
过滤无数据测点	启用后，选择数据的测点列表仅显示有数据上送的测点。当前 OU 测点数量过多时，可通过启用此功能提升终端用户选择数据项的效率。	`禁用`
显示 DI 量原始值	启用后，查询和导出 DI 点数据时将同时展示 DI 点的原始值与映射值，格式为 `原始值 (映射值)`。适用于需要核对枚举映射关系的排查场景。	`禁用`
原始间隔查询	启用后，时间间隔中出现 `原始值` 选项，终端用户可按测点的原始上送间隔查看数据。	`禁用`
显示数据质量	启用后，数据表右上方出现数据质量开关，终端用户可查看数据的有效性与质量明细。需先启用原始间隔查询，否则该开关不可用。	`禁用`
自动刷新	启用后，页面按刷新间隔自动重新查询并更新图表。终端用户使用快捷时间范围时，每次刷新会同步重算起止时间；终端用户打开时间选择器期间，自动刷新暂停，避免正在选择的时间被覆盖。	`禁用`
刷新间隔	自动刷新的时间周期，取值范围为 10–3600 秒。仅当自动刷新启用时可配置。	60 秒
数据布局样式	选择数据中数据项列表的排列方式，可选 `一列` 或 `两列`。数据项较多时选择 `两列` 可减少滚动。	`两列`
Y 轴缩放	启用后，图表纵向出现缩放滑块，终端用户可纵向缩放图表以查看数值密集区域；同时图表工具箱中的框选放大支持纵向框选。数据项量纲差异大时，启用此项有助于观察小量纲曲线的细节。	`禁用`

数据过滤配置¶

曲线工具可使用 通用数据服务 > 可视化分组 中的配置及资产属性，控制 选择数据 中数据项的组织方式和可选范围。通过以下配置项决定数据过滤的来源与展示方式：

配置项	说明	默认值
数据过滤模式	选择数据中数据项的组织方式。`按测点类型分类` 按测点自身的类型分组；`按可视化分组分类` 按通用数据服务中配置的可视化分组分组，更贴近业务语义。选择 `按可视化分组分类` 时，若某一资产类型下没有配置对应的可视化分组，则该资产类型下的数据按测点类型展示。	`按测点类型分类`
数据分类字段组	页面读取可视化分组时使用的业务对象字段组键。除有特殊约定外，保持默认值即可。	`CT_Metric`
按属性过滤	启用后，页面将根据资产的属性值在字段组中筛选字段分类，并使用这一字段分类来展示数据。适用于同一资产类型下不同机型需要展示不同数据项的场景。启用时必须在选择属性中指定一个属性才能发布。	`禁用`
数据项分组	启用后，可在可视化分组的基础上预定义数据分组及其展示名称。终端用户在选择数据中可按分组一次勾选多个数据项，无需逐项查找。	`禁用`
分组标识符	参与分组的可视化分组标识符，标识符之间用英文逗号分隔，支持通配符 ``。例如 `Wind_` 表示以 `Wind_` 开头的所有可视化分组。仅当数据项分组启用时可配置，且不可为空，否则无法发布。	空
分组展示名称	分组入口在终端页面显示的名称，支持按界面语言分别输入。未配置时，终端页面显示为按分组选择。仅当数据项分组启用时可配置。	空

数据列筛选器¶

启用 数据列筛选器 后，查询条件栏中显示数据筛选器，终端用户可不打开 修改查询条件 弹窗直接增减图表中的数据项。禁用后终端用户只能在 修改查询条件 弹窗中选择数据项。默认启用。

发布页面¶

完成配置后，按照以下步骤发布页面，使配置对终端用户生效：

在曲线工具配置页面的右上角选择发布。
在弹窗中输入此次发布的修改说明等内容作为备注。备注将显示在历史版本列表中，便于后续定位与回滚。
选择确认。发布后页面将重新加载运行态配置，终端用户下次进入页面即可看到新配置。

配置图表¶

除页面功能外，你还可以在曲线工具页面中构建一张具体的资产数据图表，并将它保存为模板或组织默认视图，作为终端用户进入页面时看到的初始视图。

构建图表的入口与终端用户相同：在曲线工具页面中选择更多打开 修改查询条件 弹窗，依次完成选择资产、选择数据、选择展示形式和选择时间，然后选择应用。各步骤中可配置的字段与限制，参见修改查询条件。

图表构建完成后，可通过保存当前图表为模板将它固化下来。若在保存时将 保存为组织默认视图 选择为是，OU 内所有终端用户进入曲线工具页面时都会默认看到这张图表。

管理图表模板¶

图表模板用于固化一套完整的查询条件与展示样式，避免终端用户每次重复配置。模板主要包含以下信息：

资产维度和资产类型
分析对象和数据项
图表样式与 Y 轴设置
时间间隔和时间范围
自定义分析对象

模板分为两类：

我的模板：仅创建者本人可见，用于个人分析习惯的沉淀。
组织模板：OU 内所有终端用户可见，需拥有模板配置权限点才能创建与编辑。用于向全员下发统一的分析视图。单个 OU 的模板数量上限为 50 个。

保存当前图表为模板¶

通过以下步骤将配置完成的资产数据图表保存为新模板或更新当前模板：

在左侧导航栏中选择 曲线工具。
将光标悬停至设置按钮并选择 保存模板。保存模板前，需确保当前图表中至少选择一个数据项。
在保存模板弹窗中输入以下信息。
- - 字段
  - 说明
- - 模板名称
  - 输入该模板的名称。导出图表数据时，若当前已应用模板，导出文件将以模板名称命名。
- - 模板描述
  - 输入该模板的描述。卡片式 模板菜单中会显示描述，便于终端用户判断模板用途。
- - 模板分组
  - 选择模板所属的分组。未选择时模板归入默认分组。
- - 保存时间间隔与时间范围
  - 选择是，模板会保存当前图表的时间间隔和时间范围配置。选择否，应用模板时使用系统默认的时间间隔和时间范围。固定周期的复盘场景选是，日常监盘场景选否。
- - 保存为组织默认视图
  - 选择是，OU 内终端用户进入 曲线工具 页面时默认展示当前图表。仅拥有模板配置权限点的用户可配置此项。
选择确认。

另存模板为新模板¶

若当前页面已应用模板，且对原模板进行了修改，通过以下步骤将修改后的模板另存为新模板，原模板保持不变：

在左侧导航栏中选择 曲线工具。
将光标悬停至设置按钮并选择 另存为模板。另存为模板前，需确保当前图表中已应用一个模板。
在保存模板弹窗中输入模板名称、模板描述、模板分组等信息。各字段的说明与保存当前图表为模板相同。
选择确认。

编辑模板¶

通过以下步骤修改模板的名称、描述、分组等信息。模板中的查询条件与展示样式不会被修改，如需调整这些内容，应用该模板后重新保存。

在左侧导航栏中选择 曲线工具。
选择模板。
选择目标模板卡片右上角的编辑。
在弹窗中编辑模板的名称、描述、分组以及是否保存时间间隔与时间范围，并选择确认。

删除模板¶

在左侧导航栏中选择 曲线工具。
选择模板。
选择目标模板卡片右上角的删除。
在弹窗中选择确认。

备注

模板删除后不可恢复。若被删除的模板正在被应用，页面会退出该模板；该模板也会从最近使用模板记录中移除。

管理模板分组¶

模板分组可用于按模板的适用场景、分析对象、时间范围等信息分类管理模板。模板数量较多时，分组能显著缩短终端用户查找模板的时间。

创建分组¶

在左侧导航栏中选择 曲线工具。
选择模板。
选择编辑图标打开分组配置弹窗。
选择分组并输入分组名称。创建分组后，你可以在保存模板、另存为模板或编辑模板时将模板添加到模板分组中。

编辑分组¶

在左侧导航栏中选择 曲线工具。
选择模板。
选择编辑图标打开分组配置弹窗。
选择模板分组标签并编辑分组名称。

排序分组¶

在左侧导航栏中选择 曲线工具。
选择模板。
选择编辑图标打开分组配置弹窗。
拖动分组标签旁的排序图标，编辑各分组在模板面板中的展示顺序。

删除分组¶

在左侧导航栏中选择 曲线工具。
选择模板。
选择编辑图标打开分组配置弹窗。
选择分组标签右侧的删除图标。

恢复历史版本¶

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

在左侧导航栏中选择 曲线工具。
在曲线工具页面中选择 功能配置 。
选择 历史版本 打开历史版本列表。
在历史版本列表中选择相应版本的恢复。
在弹窗中选择确认。

导入或导出页面配置¶

曲线工具支持以 JSON 文件形式导入或导出以下内容，实现同一页面在不同应用或不同环境之间的迁移与复用：

页面功能配置
资产与数据项配置
模板与模板分组

导出页面配置¶

在左侧导航栏中选择 曲线工具。
在曲线工具页面中选择 功能配置 。
选择 导入/导出 > 导出，浏览器将自动下载配置文件。

导入页面配置¶

在左侧导航栏中选择 曲线工具。
在曲线工具页面中选择 功能配置 。
选择 导入/导出 > 导入。
在弹窗中上传配置文件并选择确定。

导入后，配置文件中的内容会填充到各标签页中，你可以继续调整后再发布。导入的资产类型或设备类型在当前 OU 中不存在时，系统会自动改选为当前 OU 下可用的类型，因此导入后建议逐个标签页复核。

备注

导入仅覆盖配置文件中包含的配置项。若配置文件来自较早版本，新增配置项将保留当前页面的取值。

配置 URL 参数¶

除进行以上配置外，应用开发人员可通过配置菜单 URL 中的参数启用或禁用页面功能，或指定页面打开时的默认查询条件。更多信息，参见 URL 参数说明。