自定义光伏场站发电量（上月同期）指标¶
指标是衡量资产业绩的重要标准，也是资产监控应用和 BI 分析应用需要使用的关键数据之一。然而应用需要使用和展示的指标数量众多，随用户场景千变万化。
EnOS 通用数据服务可基于已有的原始指标自定义表达式，快速注册业务指标。在查询指标时，通用数据服务会直接返回表达式计算后的指标数值，实现指标的灵活变化和高效应用。
场景描述¶
在能源行业中，发电量 指标是光伏场站最常用的指标之一。对光伏场站的发电量进行月同期对比，可快速了解光伏资产表现的月度变化，也可根据月度变化趋势对未来业绩进行预测和优化。
本教程基于 EnOS 光伏集控 API 提供的 发电量 指标，自定义光伏场站 发电量（上月同期） 指标。
教程目标¶
通过本教程，你将学习如何基于已有的原始指标配置表达式，注册业务指标。
前提条件¶
提供光伏
发电量指标的 EnOS 光伏集控 API 已部署在当前环境并按照要求注册到通用数据服务。有关各环境的服务部署和 API 注册详情，联系系统管理员。当前 OU 已获取、授权和启用通用数据服务。
当前帐号已被分配所需的资产权限、操作权限点和包含 原始指标 和 指标 在内的菜单组。如未分配，联系应用管理员。
已学习指标相关概念，参见 指标。
教程单元¶
步骤 1：分析指标需求¶
按照以下流程分析和评估目标指标 发电量（上月同期） 的需求。
查看目标指标在业务指标库中是否存在。本教程假设不存在。
确定是否可基于已有的原始指标配置表达式得到目标指标。本教程假设可以并确定以下事项：
该指标是基于原始指标进行时域转换后得到的指标，即同/环比指标。
该指标适用场景较多，可注册为公有指标。
在原始指标库中确定目标指标对应的原始指标信息：
字段 Key：
ActiveProduction。字段名称：
发电量。API Key：
SolarAPI。
步骤 2：注册指标¶
登录 EnOS 应用门户，在应用列表中选择 通用数据服务。
在左侧导航栏中选择 业务对象要素 > 业务指标。
选择 公有指标 标签页，点击 导入。
在弹窗中点击 下载模板，选择下载 Excel 模板文件。
在模板中填写以下信息。表格中未提及的字段可忽略不填。
字段名称
标识符
填写内容
指标标识符
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。在弹窗中点击 上传。选择填写后的模板文件并点击 确定。
更多信息，参见 同/环比指标配置规则。
步骤 3：查询指标¶
通过以下通用数据服务 API 接口查询已注册的指标数据：
指标历史数据：
https://{api-gateway}/cds-metric-service/v1.0/metric
指标实时数据：
https://{api-gateway}/cds-realtime-service/v1.0/metric/latest