创建模型

模型是对产品功能的抽象,模型定义了产品是什么、能做什么、可以对外提供哪些服务。本文介绍如何创建模型。

前提条件

  • 已设计好该模型所需要的功能。有关如何进行模型的功能设计,参见 模型与资产建模

  • 你需要有创建模型的权限,如果没有需联系组织管理员添加。有关EnOS内的用户权限,参见 策略,角色,与权限

  • 确保已阅读模型的使用限制。参见 使用限制

任务描述

根据定义好的模型,在 EnOS 中配置各项功能。

  • 属性

  • 测点

  • 服务

  • 事件

步骤 1:创建模型

  1. 在 EnOS 管理控制台中选择 模型

  2. 点击页面右上方 创建模型,在 创建模型 页面根据界面提示配置信息,其中:

    • 模型标识符:模型的唯一标识符。

    • 模型名称:模型的名称。

    • 分类:可以填写诸如厂商、设备型号等的产品扩展信息。

    • 模型关系:可选择 拷贝 、或 继承。具体含义参见 模型关系

    • 模型校验:接入进来的设备数据将与模型的功能定义进行比对。打开校验时,如果上报的某个测点不是模型中定义的,就会报错。注:关闭模型校验将更改数据在 TSDB 中的存储路径及访问接口,从而导致原路径数据缺失,并且后续数据归档、订阅需重新配置。

    • 模型描述:模型的描述。


  3. 点击 确定 完成操作。

步骤 2:为模型创建功能定义

  1. 点击需要定义功能的模型的所对应的 编辑 图标 edit

  2. 选择 功能定义 标签,并点击 编辑,然后点击 新增。根据需要选择 新建自定义功能从标准功能库添加

新建自定义功能

选择 新建自定义功能 后,你就可以根据页面提示添加自定义的功能定义。

新增属性

  1. 添加功能 页面,功能类型 中选择 属性,并根据界面提示配置信息,其中:

    • 名称:属性的名称。

    • 标识符:属性的唯一标识符。

    • 数据类型:属性的数据类型。更多信息,参见 数据类型

    • 描述:属性的描述。

  2. 点击 确定 完成创建该属性。

  3. 重复以上操作创建更多属性。

新增测点

测点页面中的配置信息如下:

  1. 添加功能 页面,功能类型 中选择 测点,并根据界面提示配置信息,其中:

    • 名称: 测点的名称。

    • 标识符: 测点的唯一标识符。

    • 测点类型:必填项。测点类型用于区别测点数据的不同特征。在存储数据时,不同类型的测点数据可分类存储;在读取数据时,对不同类型的数据提供不同的处理能力。对各测点类型的描述如下:

      • AI:AI 类型的测点数据一般为数值型数据,在读取数据时可对数据进行聚合处理。

      • DI:DI 类型的测点数据一般为设备状态数据,在读取数据时可对数据进行变位查询。

      • PI:PI 类型的测点数据一般为电量计算数据,在读取数据时可进行聚合处理。

      • 通用:除以上类型以外的其他类型的测点,一般用于上传非数值类型的数据。

      备注

      如果已有测点数据存储到TSDB,测点类型不能修改。测点类型的变更会导致已存储的历史数据无法查询。更多详细信息,参见 配置 TSDB 存储


    • 数据类型:可用的数据类型将根据所选的测点类型而有所不同。

      • AI:可供选择的数据类型为 int,float 和 double。

      • DI:仅 int 数据类型可用。

      • PI:仅 double 数据类型可用。

      • 通用:可供选择的数据类型为 int,float,double,enum,string,timestamp,date,struct,array 和 file。

      更多信息,参见 数据类型


    • 是否有质量位:设置该测点值是否代表数据质量。如果设置为 ,则配置如下:

      • 质量位:系统使用预定义的数组型的数据质量指示,不可更改。可点击 查看 了解预定义的质量位参数和描述。

      • 值:设置该测点的数据类型。类型只支持 int,float 和 double。


    • 描述: 测点的描述。


  2. 点击 确认 来创建该测点。

  3. 重复以上操作创建更多测点。

备注

  • 在创建新测点之后,需要及时为测点数据配置存储策略。否则设备接入到云端后,测点数据不会默认被存储到时序数据管理。有关配置存储策略的详细步骤,参见 配置 TSDB 存储

新增服务

  1. 添加功能 页面,功能类型 中选择 服务,根据页面提示配置好相关信息,其中:

    • 名称: 服务的名称。

    • 标识符: 服务的唯一标识符。

    • 描述: 服务的描述。

    • 输入参数:服务的输入参数,其中可指定该参数是否在调用服务时需要为其输入参数提供值、为其输入参数指定最大/最小值以及调用服务如果需要但没提供值时为其提供默认值。


  2. 点击 确认 创建该服务。

  3. 重复以上操作创建更多服务。

新增事件

  1. 添加功能 弹窗,功能类型 选择 事件,并填写以下字段,其中:

    • 名称: 事件的名称。

    • 标识符: 事件的唯一标识符。

    • 事件类型

      • 信息:指设备发出的通知,比如任务完成的通知。

      • 告警:告警信息。运行中的设备自发上报的、可能影响设备正常运行的情况。这些事件优先级较高。你可以根据告警级别采取处理措施或进行进一步数据分析。

      • 故障:故障信息。运行中的设备自发上报的、导致设备无法正常运行的紧急情况或异常。优先级最高。应当根据故障级别采取处置措施或者进行进一步数据分析。


    • 描述: 事件的描述。


  2. 点击 确认, 完成事件的创建。

从行业标准功能库添加

  1. 选择 从行业标准库添加

  2. 选择基本资源 列表中,找到需要的行业标准功能定义,点击 确定

  3. 添加功能 中,根据需要修改该标准功能的 名称标识符测点类型 (默认为通用)、(如果该标准元素为测点)有无质量位描述

  4. 点击 确认,完成标准功能定义的添加。

备注

  • 你可以在同一个模型的功能定义中,多次添加同一个标准功能定义,只要这些标准功能定义的 标识符 在不同即可。

  • 标准功能的 功能类型标准标识符数据类型单位 是不能编辑的。

发布功能定义

添加完所有的功能定义后,点击发布,完成功能定义的添加。

步骤 3:(可选)添加标签

标签描述同类模型所具有的共性信息。用于区分模型对象所属的领域、类型、范围等各种分类。比如,你可以通过添加 domain:solar 标签代表该模型属于太阳能领域。

  1. 从模型列表中找到目标模型并点击 edit

  2. 基础信息 标签下的 标签 区域中点击 编辑

  3. 在弹出窗口中,点击 创建标签,输入新标签的键值对 (key:value)。

  4. 点击 OK 来保存标签。

结果

完成模型功能定义后,系统将自动生成该产品的模型,以JSON格式表述。

相关信息