• 文档
• 注册虚拟测点

注册虚拟测点

虚拟测点是指基于一个或多个参数配置表达式定义的非模型测点。其中，参数可以来自模型测点、常数、属性等。只有先在通用数据服务上注册虚拟测点，才能通过通用数据服务 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. 在弹窗中点击 上传。选择填写后的模板文件并点击 确定。

结果

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

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

• 删除虚拟测点：点击对应测点行的 删除 。虚拟测点删除后不可恢复。