注册虚拟测点¶
虚拟测点是指基于一个或多个参数配置表达式定义的非模型测点。其中，参数可以来自模型测点、常数、属性等。只有先在通用数据服务上注册虚拟测点，才能通过通用数据服务 API 查询使用这些测点。应用构建者可以通过上传模板文件批量注册虚拟测点。
备注
虚拟测点不保存在模型、也不产生存储，只会在查询时由通用数据服务实时计算得到。因此虚拟测点只适用于类似状态映射、功率/容量=出力比的轻量计算场景。
通用数据服务既支持查询虚拟测点，也支持查询已注册对象类型的全量模型测点的最新数据和时序数据。
前提条件¶
开始之前，确保以下事项：
当前帐号已被分配所需的资产权限、操作权限点和包含 虚拟测点 在内的菜单组。如未分配，联系应用管理员。
已知晓以下保证性能的最佳实践：
建议虚拟测点表达式引用的模型测点数量不超过 3 个。
不建议基于通用（Generic）类型的模型测点创建虚拟测点。
建议在分析场景和评估性能后进行预计算，并生成实体模型测点数据。
操作步骤
在左侧导航栏中选择 业务对象要素 > 虚拟测点。
根据目标测点的生效范围选择 公有测点 或 私有测点 标签页，点击 导入。有关公有/私有测点的区别，参见 公有/私有测点。
在弹窗中点击 下载模板，选择下载 Excel 或 JSON 模板文件。
参考以下信息填写模板文件。
字段名称
标识符
必填/选填
描述
测点标识符
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 测点类型）。
备注
导入模板中的“所属组织标识符”、“所属组织名称”、“更新时间”、“操作人”和“是否与公有标识符重复”字段无需填写，将在上传后由系统自动填充。
在弹窗中点击 上传。选择填写后的模板文件并点击 确定。注册私有测点时，若文件中的测点标识符与已注册的公有测点标识符重复，传入重复的标识符查询测点数据时，系统将返回私有测点的数据。
结果¶
注册成功后，虚拟测点出现在测点列表中。应用构建者可以查看测点详情，并进行以下操作：
修改虚拟测点：点击 导出，按需修改下载的文件后再导入新文件。标识符相同的测点会覆盖原有测点，不同则新增测点。
删除虚拟测点：点击对应测点行的 删除
。虚拟测点删除后不可恢复。备注
若测点对应的业务对象类型已被删除，需联系系统管理员删除该测点。