自定义光伏场站发电量(上月同期)指标


指标是衡量资产业绩的重要标准,也是资产监控应用和 BI 分析应用需要使用的关键数据之一。然而应用需要使用和展示的指标数量众多,随用户场景千变万化。


EnOS 通用数据服务可基于已有的原始指标自定义表达式,快速注册标准指标。在查询指标时,通用数据服务会直接返回表达式计算后的指标数值,实现指标的灵活变化和高效应用。

场景描述


在能源行业中,发电量 指标是光伏场站最常用的指标之一。对光伏场站的发电量进行月同期对比,可快速了解光伏资产表现的月度变化,也可根据月度变化趋势对未来业绩进行预测和优化。


本教程基于 EnOS 光伏集控 API 提供的 发电量 指标,自定义光伏场站 发电量(上月同期) 指标。



教程目标


通过本教程,你将学习如何基于已有的原始指标配置表达式,注册标准指标。



前提条件


  • 提供光伏 发电量 指标的 EnOS 光伏集控 API 已部署在当前环境并按照要求注册到通用数据服务。有关各环境的服务部署和 API 注册详情,联系系统管理员。
  • 当前 OU 已获取、授权和启用通用数据服务。
  • 当前帐号已被分配所需的资产权限、操作权限点和包含 原始指标标准指标 在内的菜单组。如未分配,联系应用管理员。
  • 已学习指标相关概念,参见 指标



教程单元

步骤 1:分析指标需求


按照以下流程分析和评估目标指标 发电量(上月同期) 的需求。


../_images/CDS-Tutorial-Analyze.png


  1. 查看目标指标在标准指标库中是否存在。本教程假设不存在。
  2. 确定是否可基于已有的原始指标配置表达式得到目标指标。本教程假设可以并确定以下事项:
    • 该指标是基于原始指标进行时域转换后得到的指标,即同/环比指标。
    • 该指标适用场景较多,可注册为公有指标。
  3. 在原始指标库中确定目标指标对应的原始指标信息:
    • 字段 Key:ActiveProduction
    • 字段名称:发电量
    • API Key:SolarAPI

步骤 2:注册指标


  1. 登录 EnOS 应用门户,在应用列表中选择 通用数据服务

  2. 在左侧导航栏中选择 元数据 > 标准指标

  3. 选择 公有指标 标签页,点击 导入

  4. 在弹窗中点击 下载模板,选择下载 Excel 模板文件。

  5. 在模板中填写以下信息。表格中未提及的字段可忽略不填。


    字段名称 标识符 填写内容
    指标标识符 metricKey ActiveProductionSPLM
    指标中文名 metricNameZh 发电量(上月同期)
    指标英文名 metricNameEn ActiveProduction(SPLM)
    对象类型标识符 mdmType EnOS_Solar_Site
    对象类型名称 mdmTypeName 光伏场站
    查询间隔 interval D,W,M,Q,Y,T
    是否虚拟指标 isCalculated Y
    指标表达式 expression #{Metric[‘SolarAPI@@SPLM@@ActiveProduction’]}
    数据类型 dataType Double


    本教程中,你也可以直接下载填写后的模板 virtual_metrics.xlsx

  6. 在弹窗中点击 上传。选择填写后的模板文件并点击 确定


更多信息,参见 同/环比指标配置规则

步骤 3:查询指标


通过以下通用数据服务 API 接口查询已注册的指标数据:

  • 指标历史数据:

    https://{api-gateway}/cds-metric-service/v1.0/metric
    
  • 指标实时数据:

    https://{api-gateway}/cds-realtime-service/v1.0/metric/latest
    


有关查询方法,参见 历史指标查询实时指标查询