• 文档
  • 注册虚拟测点

注册虚拟测点


虚拟测点是指基于一个或多个参数配置表达式定义的非模型测点。其中，参数可以来自模型测点、常数、属性等。只有先在通用数据服务上注册虚拟测点，才能通过通用数据服务 API 查询使用这些测点。应用构建者可以通过上传模板文件批量注册虚拟测点。


注解

  • 虚拟测点不保存在模型、也不产生存储，只会在查询时由通用数据服务实时计算得到。因此虚拟测点只适用于类似状态映射、功率/容量=出力比的轻量计算场景。
  • 通用数据服务既支持查询虚拟测点，也支持查询已注册对象类型的全量模型测点的最新数据和时序数据。

前提条件


开始之前，确保以下事项：

  • 当前帐号已被分配所需的资产权限、操作权限点和包含 虚拟测点 在内的菜单组。如未分配，联系应用管理员。
  • 已知晓以下保证性能的最佳实践：
    • 建议虚拟测点表达式引用的模型测点数量不超过 3 个。
    • 不建议基于通用（Generic）类型的模型测点创建虚拟测点。
    • 建议在分析场景和评估性能后进行预计算，并生成实体模型测点数据。

操作步骤


  1. 在左侧导航栏中选择 元数据 > 虚拟测点。

  2. 根据目标测点的生效范围选择 公有测点 或 私有测点 标签页，点击 导入。有关公有/私有测点的区别，参见 公有/私有测点。

  3. 在弹窗中点击 下载模板，选择下载 Excel 或 JSON 模板文件。

  4. 参考以下信息填写模板文件。


    字段名称 标识符 必填/选填 描述
    测点标识符 measurementPoint 必填 测点的标识符，需保证在同一作用域（公有/私有）内的同一对象类型下的唯一性。
    测点中文/英文/日语/西班牙语名称 zh_CN/en_US/ja_JP/es_ES 中文和英文为必填 不同语言的测点名称。
    对象类型标识符 mdmType 必填 测点对应的资产类型的标识符。可前往 元数据 > 对象类型 查看对应对象类型的标识符。
    对象类型名称 mdmTypeName 选填 测点对应的资产类型的名称。可前往 元数据 > 对象类型 查看对应对象类型的名称。
    查询间隔 interval 必填 测点支持的查询间隔。目前支持的查询间隔：RAW（原始数据），1m（1 分钟），5m（5 分钟），10m（10 分钟），15m（15 分钟），30m（30 分钟），H（小时）。多个查询间隔之间用英文逗号隔开，例如：RAW,1m,5m,10m。
    时间聚合方式 timeAggMethods 必填 按指定时间间隔查询时，查询间隔内数据的聚合方式。目前支持的时间聚合方式：avg，sum，max，min，first，last。
    聚合方式 mdmAggMethods 选填 多对象查询时支持的测点聚合方式。目前支持的聚合方式：sum，avg，max，min。
    测点表达式 expression 必填 基于模型的原始测点和属性配置公式。测点引用格式为：Point['测点标识符']，属性引用格式为：Attribute['属性标识符']。一个表达式可引用多个原始测点和属性。例如：出力比 测点的表达式为：#{SUM#(Point[‘GenActivePW’]*1000#) / Attribute[‘capacity’] / 10.0}
    测点类型 signalType 必填 目前支持的测点类型：AI（遥测，测点数据一般为数值型数据），DI（遥信，测点数据一般为设备状态数据），PI（遥脉，测点数据一般为电量计算数据），Generic（通用，除以上类型以外的其他类型的测点，一般用于上传非数值类型的数据）。
    枚举量 enumerate 选填 如果是枚举类型的测点，描述支持的枚举量。
    未来数据是否可用 includeFutureData 选填 如果支持查询未来时间的数据，如预测类数据，则填写 Y；如果只能查询当前时间之前的历史数据，则填写 N。
    单位 units 选填 测点数值的单位，参考 EnOS 内置单位 填写。
    关联应用 applicationDependency 选填 测点依赖部署的应用，多个应用之间用英文逗号分隔。
    关联应用依赖版本 applicationVersionDependency 选填 测点依赖部署的应用版本，多个版本之间用英文逗号分隔。
    数据类型 dataType 必填 测点数值的数据类型根据所选的测点类型而有所不同。目前支持的数据类型：Int（对应 AI 或 DI 测点类型），Double（对应 AI 或 PI 测点类型），String（仅可对应 Generic 测点类型）。

    注解

    导入模板中的“所属组织标识符”、“所属组织名称”、“更新时间”和“操作人”字段无需填写，将在上传后由系统自动填充。


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

结果


注册成功后，虚拟测点出现在测点列表中。应用构建者可以查看测点详情，并进行以下操作：

  • 修改虚拟测点：点击 导出，按需修改下载的文件后再导入新文件。标识符相同的测点会覆盖原有测点，不同则新增测点。
  • 删除虚拟测点：点击对应测点行的 删除 Delete 。虚拟测点删除后不可恢复。