单元五:配置数据


资产接入后,上传至 EnOS Cloud 的数据需要进行存储和配置才能成为应用可用、用户可识的数据。

开始前准备


开始之前,需确保以下事项:

  • 应用构建者和系统管理员的账号已被分配 所需权限
  • 当前 OU 已申请时序数据库存储资源,以便后续配置数据存储策略。若未申请,参见 申请资源
  • 应用构建者已基于应用的功能需求,确定所需的指标清单。

(可选)任务 1:模拟数据


操作人 操作地点
应用构建者 EnOS 管理控制台


若应用无真实设备接入,例如用于测试或演示的应用,需借助 EnOS 设备模拟器生成设备模拟数据,用于验证测点和指标的配置。更多信息,参见 设备模拟器

操作步骤


  1. 登录 EnOS 管理控制台,在左侧导航栏中选择 设备管理 > 设备模拟器
  2. 点击 添加模拟设备,在 添加模拟设备 页面中勾选所有接入的设备,点击 确定
  3. 在模拟器列表中,点击设备对应的 编辑样本 edit_sample_icon, 在弹窗中下载模板后填写模拟数据并上传模板。
  4. 在模拟器列表中,点击设备对应的 开始模拟 start_simulate_icon,在弹窗中勾选 始终开启 选项并点击 确定

结果


开启完成后,模拟器会在定义好的时间将设定好的测点值上传至 EnOS Cloud。

任务 2:配置数据存储策略


操作人 操作地点
应用构建者 EnOS 管理控制台


设备在接入 EnOS Cloud 后会源源不断地产生海量数据,这些数据需要写入存储才能被应用查询和使用。时序数据库(Time Series Database,TSDB)提供数据的存储和管理服务,可以通过配置 TSDB 存储策略来定义数据的存储方式。更多信息,参见 时序数据存储

操作步骤


  1. 在 EnOS 管理控制台的左侧导航栏中选择 时序数据管理 > 存储策略
  2. 选择 标准数据 标签页,点击页面右上角加号图标 add_data_icon,选择 手动添加
  3. 创建分组 页面命名分组,勾选应用使用的模型后,点击 确认
  4. 点击上一步中创建的分组对应的标签页,鼠标悬浮于“AI 原始数据”数据桶卡片并点击其右上角的 编辑 edit_AI_raw_data_icon
  5. 编辑存储策略 页面中配置以下参数并点击 确认
    • 数据存储时效:按需设置。
    • AI 存储点选择:模型。
    • 请选择分组模型:勾选应用使用的模型。
  6. 按照步骤 4-5 依次配置 “AI 分钟级归一化数据”、“ DI 数据”“ PI 数据”和“通用数据”数据桶卡片,设置数据存储时效并将所需模型添加进存储策略中。

结果


配置完成后,对应的模型测点数据将按照所配置的策略进行存储。应用构建者可登录 EnOS 管理控制台 > 时序数据管理 > 存储策略 查看策略详情。

任务 3:添加资产树标签


操作人 操作地点
应用构建者 EnOS 管理控制台


EnOS 通过标签(Tag)识别资产树、获取资产树的资产信息和数据。使用接入工具 接入资产 后,接入工具会自动创建资产树并将其同步至 EnOS 管理控制台。应用构建者需为该资产树添加以下标签。


标签 标签添加对象 标签作用
EnosCDS:true 资产树 保证通用数据服务获取对应资产树的数据并供应用使用。
auth_unit:true 场站级节点 保证对应的资产树数据在 EnOS 管理控制台和 EnOS 应用门户之间同步。

操作步骤


  1. 在 EnOS 管理控制台的左侧导航栏中选择 资产树
  2. 在页面顶部点击应用使用的资产树,该资产树默认与 OU 模板使用的拓扑规则同名。
  3. 在左侧资产树导航栏中选择根节点,点击 资产树标签 旁的 编辑 edit_asset_tree_icon,在弹窗中添加 EnosCDS:true 标签。
  4. 在左侧资产树导航栏中选择场站级节点,点击 资产标签 旁的 编辑 edit_asset_tree_icon,在弹窗中添加 auth_unit:true 标签。
  5. 标签添加完成后,联系系统管理员开启“CDS 调用 AMC”服务。同一环境仅需开启一次。

结果


添加标签并成功开启服务后,通用数据服务可获取资产树上的资产类型和资产数据,将数据提供给应用使用。

任务 4:注册指标


操作人 操作地点
应用构建者 EnOS 应用门户


指标是能体现业务状况的数值,例如:发电量、损失电量、故障率等。指标数据必须先在 EnOS 上成功注册才能被应用使用。

操作步骤


EnOS 支持使用通用数据服务或指标管理注册指标。

使用通用数据服务注册指标


  1. 登录 EnOS 应用门户,在应用列表中选择 通用数据服务
  2. 参考 初次配置 EnOS 通用数据服务 依次注册数据源 API、原始指标、标准指标。

使用指标管理注册指标


  1. 登录 EnOS 应用门户,在应用列表中选择 指标管理
  2. 参考 指标开发教程 依次配置维度表和事实表,并开发指标。

结果


指标注册完成后,应用可使用已注册指标,并将相关数据展示在应用页面中。

(可选)任务 5:配置可视化页面展示字段


操作人 操作地点
系统管理员 EnOS 应用门户


若应用需使用数字孪生可视化构建拓扑组件,或使用统一监测的监测页面中的相关功能(例如:资产列表或通用指标查询中的数据项分组,资产概览地图中悬浮卡片展示的数据项,及统一监测中与资产状态相关的展示内容),系统管理员可配置可视化页面展示字段,决定特定可视化组件和页面中指标数据的展示顺序、名称和字段组。

以数字孪生可视化的 拓扑图组件 为例,按照以下步骤自定义指标内容及其展示字段:

操作步骤


  1. 登录 EnOS 应用门户,在应用列表中选择 配置中心
  2. 将指标同步至配置中心 OU 层进行统一管理:
  3. 在左侧导航栏中选择 业务对象。在所需业务对象类型标签页下,选择对应对象的 配置展示字段 btn_field
  4. 在字段组列表中选择对应字段组的 配置 btn_config,进入字段组配置页面。
  5. 选择 + 添加字段,勾选需要展示的字段。可选范围是当前业务对象所关联的模型属性、模型测点、业务特性、资产要素(KPI 和计算点)、虚拟属性。
  6. 选择后,选择 保存,完成配置。


下图拓扑图组件中展示的 “Park” 类型场站数据的展示名称和顺序由业务对象 园区(标识符:Park) 中的 常用字段(键:generalinfo) 字段组决定,展示在“更多”弹窗中的测点名称由业务对象 园区(标识符:Park) 中的 更多分组(键:moreinfo) 字段组决定。


../_images/topology.png

结果


应用创建完成后,可视化组件和页面会按照配置的顺序和字段组展示数据。

任务 6:定义数据维度


操作人 操作地点
系统管理员 EnOS 应用门户


配置中心的维度可用于以下典型场景:

  • 定义测点数据的枚举值的业务语义。例如:通过配置中心的维度,将开关模型上的“开关状态”测点返回的 0 或 1 原始数据,分别转义为“已断开”和“连接中”状态。
  • 定义告警分组类型和与告警分组类型相关联的设备类型。
  • 定义在移动端查看资产列表时设备的筛选项。例如:配置中心的“场站统一状态”维度定义了不同的设备接入状态,在移动端的单场站资产列表中可筛选处于特定状态的设备。

构建应用前,系统管理员需配置应用所需数据的维度,定义测点、告警和移动端设备数据的业务语义。

操作步骤


  1. 在配置中心的左侧导航栏中选择 全局业务对象 > 维度
  2. 点击 新建维度,在弹窗中输入维度信息后点击 确认
  3. 鼠标悬浮于维度卡片右上角的省略号图标(…),选择 配置字段
  4. 点击 新建字段,在弹窗中输入字段信息后点击 确认。字段决定新建维度记录时需要填写的信息。
  5. 鼠标悬浮于维度卡片右上角的省略号图标(…),选择 配置记录
  6. 点击 新建记录,在弹窗中填写记录信息后点击 确认。其中,名称为枚举值映射后的业务语义信息,标识符为模型测点的原始值。

结果


维度定义完成后,系统管理员登录 EnOS 应用门户 > 配置中心 > 业务对象 > 维度,可查看已配置的记录,下一步映射测点维度完成后应用将会按照配置展示对应的语义。

任务 7:映射测点维度


操作人 操作地点
系统管理员 EnOS 应用门户,EnOS 管理控制台


映射测点维度是将上一任务中定义的维度关联到对应模型测点的过程。维度映射是保证应用在展示测点数据时语义生效的前提条件。

操作步骤


根据测点所属模型的不同,映射测点维度的方式分为两种:

  • 映射公有模型测点:通过为模型测点添加标签完成映射,测点标签与维度标识符关联。
  • 映射私有模型测点:通过新建虚拟测点(即计算点)完成映射,计算点配置信息与维度和模型测点标识符关联。

映射公有模型测点


  1. 登录 EnOS 应用门户,进入配置中心应用。在左侧导航栏中选择 全局业务对象 > 维度
  2. 在维度卡片池中找到上一任务中创建的维度,并记录其标识符。下一步中添加的测点标签格式为 amc_dimension:{维度标识符}
  3. 登录 EnOS 管理控制台,在左侧导航栏中选择 模型
  4. 在公有模型列表中选择对应模型的 查看 btn_details
  5. 在模型详情页面选择 功能定义,点击 编辑 进入模型编辑状态。
  6. 点击所需测点对应的 编辑 btn_edit,为测点添加第 2 步中获取的标签后点击 确认

映射私有模型测点


  1. 登录 EnOS 管理控制台,选择 模型
  2. 私有模型 列表中找到对应的模型,并记录对应测点的标识符。下一步中新建计算点的标识符需与测点标识符一致。
  3. 登录 EnOS 应用门户,在应用列表中打开 配置中心,并在左侧导航栏中选择 资产要素,在 私有 标签页点击 新建要素。在弹窗中填写指标信息并点击 确认。其中:
    • 要素类型:选择 计算点
    • 维度:选择映射测点使用的维度。
    • 名称:与原始测点的名称一致。
    • 标识符:与私有模型测点的标识符一致。
    • 别名:与原始测点的别名一致。
    • 数据类型:与原始测点的数据类型一致。

计算点添加完成后,私有模型测点即映射成功。

结果


测点维度映射完成后,应用可根据上一任务中定义的维度信息,将测点原始数据转义为具有业务语义的数据并展示在应用页面。