管理派生指标¶
可以在指标管理中基于原子指标来定义派生指标,并对派生指标进行编辑、发布等操作。
前提条件¶
开始之前,请确保以下事项:
- 当前账号已被分配包含 指标中心 在内的菜单组。如未分配,联系应用管理员。 
- 当前标准指标库中已包含所需使用的原子指标,或已创建所需使用的原子指标。 
- 已创建并发布所需使用的维度表。 
新建派生指标¶
- 选择左侧导航栏中的 指标中心,默认进入 原子指标 页面。 
- 选择 派生指标 标签页,选择 新建,在派生指标创建页面输入以下信息: - 指标类型:选择 - 单值指标或- 多值指标。创建后不可修改。- 单值指标:只有一个固定的值与之对应的指标。例如,某设备某天的发电量。 
- 多值指标:有多个值与之对应的指标。例如,某设备每天的发电量。 
 
- 关联原子指标:在下拉框中选择系统内置的 标准指标 库中的原子指标,或选择已创建的指标库中的原子指标来定义指标的计算逻辑。若当前原子指标库无法满足业务需求,可选择 创建原子指标。更多信息,参见 新建原子指标。 
- 统计维度:在下拉框中选择一张已发布的维度表,定义该派生指标的统计维度。若该派生指标不需要按照维度统计,选择 - 全部(ALL)。
- 周期:下拉选择指标的统计周期。 - 当指标类型为多值指标时,某一设定时间段内的历史数据将按照所选的频率,以聚合函数进行统计计算,并返还多个值。例如,某一设备正在持续发送数据,且设置统计周期为 - 周,指标聚合函数为- SUM,此时若设置时间范围为 2022 年 12 月 1 日-2022 年 12 月 14 日,则系统会按- SUM函数聚合 1 号-7 号的数据及 8 号-14 号的数据,并返还 2 个值。
- 当指标类型为单值指标时,系统会根据聚合函数计算该周期内的数据,并返还一个值。例如,某一设备正在持续发送数据,且设置统计周期为 - 当日,指标聚合函数为- MAX,则当调用该指标时,系统会找出当日的最大数据并返还。
 - 以当天为 2022 年 6 月 23 日为例,对周期选项进行说明。 - 周期 - 含义 - 示例 - 当日 - 当天日期。 - 2022 年 6 月 23 日。 - 当周 - 从每周一至当日。 - 2022 年 6 月 20 日 ~ 2022 年 6 月 23 日。 - 当月 - 从每月 1 号至当日。 - 2022 年 6 月 1 日 ~ 2022 年 6 月 23 日。 - 当月自然完整月 - 从每月 1 号至每月最后一天。(对于计划发电量、预测功率等指标,需要统计未来数据) - 2022 年 6 月 1 日 ~ 2022 年 6 月 30 日。 - 当年 - 从每年 1 月 1 号至当日。 - 2022 年 1 月 1 日 ~ 2022 年 6 月 23 日。 - 当年自然完整年 - 从每年 1 月 1 号至每年最后一天。(对于计划发电量、预测功率等指标,需要统计未来数据) - 2022 年 1 月 1 日 ~ 2022 年 12 月 31 日。 - 全生命周期 - 从数据产生至今。 - 若 2019 年 6 月 1 日在系统中录入某数据,则该周期为 2019 年 6 月 1 日 ~ 2022 年 6 月 23 日。 - 任意时间范围 - 数据在设定的时间范围内的值。 - 统计数据在任意时间范围内的值。 - 最新值 - 数据在最新的时间点的值。 - 只统计数据在当下时刻的最新值。 
- 指标聚合函数:自动生成关联原子指标所配置的聚合函数。 
- 单位:选择该派生指标的计算单位。 
- 数据类型:选择该派生指标的数据类型。 
- 派生指标 ID:自定义派生指标 ID,也可选择 自动生成 派生指标 ID。创建后不可修改。 
- 派生指标名称:自定义派生指标名称,也可选择 自动生成 派生指标名称。 
- 业务负责人:可通过输入关键词,在下拉框中选择当前 OU 下的账号。除此之外,也可手动填写未在该 OU 下注册的账号。 
- 开发负责人:可通过输入关键词,在下拉框中选择当前 OU 下的账号。除此之外,也可手动填写未在该 OU 下注册的账号。 
- 描述:输入对该派生指标的附加描述。 
- 属性:选择 添加属性,输入属性的键值对,为派生指标添加用于标记或区分的其他属性。例如:指标所属领域。 
 
- 选择 发布,保存并发布派生指标。 - 若暂时无需发布,选择 保存 为草稿。后续如需发布,参见 发布派生指标。 
保存或发布完派生指标后,可以在 派生指标 标签页下的列表中查看。
编辑派生指标¶
- 选择左侧导航栏中的 指标中心,并选择 派生指标 标签页。 
- 选择目标派生指标行末的 编辑  ,并在修改后进行保存或发布操作。 ,并在修改后进行保存或发布操作。
删除派生指标¶
如需删除派生指标,确保已提前删除该派生指标的查询映射配置分组。
- 选择左侧导航栏中的 指标中心,并选择 派生指标 标签页。 
- 将鼠标悬浮于目标派生指标行末的省略号(…)上后,选择 删除  。 。
发布派生指标 
- 选择左侧导航栏中的 指标中心,并选择 派生指标 标签页。 
- 可通过以下两种方式发布派生指标: - 选择目标派生指标行末的 发布  。 。
- 勾选多个需要发布的派生指标,选择页面上方的 发布  ,批量发布派生指标。 ,批量发布派生指标。
 
派生指标被发布后,才可在 查询映射配置 页面配置查询映射。
下线派生指标¶
如需下线派生指标,确保已提前删除该派生指标的查询映射配置分组。
- 选择左侧导航栏中的 指标中心,并选择 派生指标 标签页。 
- 将鼠标悬浮于目标派生指标行末的省略号(…)上后,选择 下线  ,取消发布派生指标。 ,取消发布派生指标。
查看线上版本的派生指标¶
- 选择左侧导航栏中的 指标中心,并选择 派生指标 标签页。 
- 将鼠标悬浮于状态为 修改待发布 的目标派生指标行末的省略号(…)上后,选择 查看线上版本  ,查看前一次发布的派生指标。 ,查看前一次发布的派生指标。
恢复派生指标为线上版本¶
- 选择左侧导航栏中的 指标中心,并选择 派生指标 标签页。 
- 将鼠标悬浮于状态为 修改待发布 的目标派生指标行末的省略号(…)上后,选择 恢复为线上版本  ,重新发布前一次的派生指标。 ,重新发布前一次的派生指标。
导出/导入派生指标¶
如需在不同 OU 之间进行派生指标的共享和迁移,可以进行导出/导入操作。
- 选择左侧导航栏中的 指标中心,并选择 派生指标 标签页。 
- 勾选派生指标,选择 导出,导出一个 JSON 格式的文件作为模板。 
- 选择 导入,导入本地的派生指标。 
派生指标被导入成功后,将出现以下几种情况:
- 若被导入的派生指标 ID 不属于当前指标列表,则在指标列表中将直接新增该衍生指标,且该指标将被自动发布,状态变更为 - 草稿。
- 若被导入的派生指标 ID 已存在于当前指标列表中,且当前指标处于 - 草稿状态或- 下线状态,则被导入的派生指标的字段值将直接覆盖列表中相同 ID 下的字段值,且该指标将被自动发布,状态变更为- 草稿。
- 若被导入的派生指标 ID 已存在于当前指标列表中,且当前指标处于 - 修改待发布状态或- 已发布状态,则被导入的派生指标的字段值将覆盖列表中相同 ID 下除 指标类型 字段外的字段值,且该指标将被自动发布,状态变更为- 草稿。
洞察派生指标¶
如需在指标洞察页面查看派生指标的值,确保已提前发布该派生指标。
- 选择左侧导航栏中的 指标中心,并选择 派生指标 标签页。 
- 选择目标派生指标行末的 指标洞察  ,快速洞察派生指标 的值。 ,快速洞察派生指标 的值。
将派生指标同步到通用数据服务 
可为派生指标和维度表添加属性,将已发布的派生指标同步到 EnOS 通用数据服务中,减少手动匹配、调试、导入指标的工作量。
| 属性 | 键 | 值 | 
|---|---|---|
| 派生指标属性 | syncToCDA | 1 | 
| 维度表附加属性 | businessType | 通用数据服务中的业务对象类型标识符(mdm type)。更多信息,参见 业务对象类型。 | 
步骤 1:为派生指标添加属性¶
- 选择左侧导航栏中的 指标中心,并选择 派生指标 标签页。 
- 选择以下一种方式为派生指标添加属性: - 批量添加: - 勾选所需派生指标,选择 发布 先发布指标,再选择 导出,将指标导出为 JSON 文件。 
- 在文件每一行数据的 - attributes字段中,为每个指标添加- syncToCDA=1属性,例如- "attributes":"[{\"key\": \"syncToCDA\", \"value\": \"1\"}]"。
- 在页面选择 导入 > JSON 文件,导入编辑好的文件。导入成功后,将更新页面已有指标。 
- 勾选更新后的指标,选择 发布,重新发布派生指标。 
 
- 逐个添加: - 选择派生指标行末的 编辑  进入 编辑派生指标 页面。 进入 编辑派生指标 页面。
- 在 属性 中为该指标添加 - syncToCDA=1属性,其中- syncToCDA为 键,- 1为 值。
- 选择 发布,保存并发布该派生指标。 
 
 
步骤 2:为维度表添加附加属性¶
- 选择左侧导航栏中的 维度表,并选择 维度定义 标签页。 
- 选择派生指标所关联的维度表行末的 编辑  进入 编辑维度 页面。 进入 编辑维度 页面。
- 在 附加属性 中为该维度表添加 - businessType=<mdm type>属性,其中- businessType为 键,值- <mdm type>为通用数据服务中的业务对象类型标识符。
- 选择 发布,保存并发布该维度表。 
结果¶
发布该派生指标及其维度表后,即可在通用数据服务中将该派生指标同步为原始指标及业务指标。更多信息,参见 从指标管理同步原始指标 和 从指标管理同步业务指标。