创建模型

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

开始前准备

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

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

任务描述

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

  • 属性

  • 测点

  • 服务

  • 事件

使用限制

EnOS 对每个 OU 具有以下限制:

  • 最多可以创建1000个私有模型。

  • 每个模型可创建的属性/测点/服务/事件的最大数量为5,000。

步骤一:创建模型

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

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

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

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

  3. 点击 确定 完成操作。

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

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

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

新建自定义功能

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

新增属性

  1. 添加功能 页面,功能类型 中选择 属性,并根据界面提示配置信息。有关 数据类型 的更多信息,参见数据类型

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

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

备注

你可以为单个模型最多定义200个属性。

新增测点

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

  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. 重复以上操作创建更多服务。

备注

你可以为单个模型最多创建50个服务。

新增事件

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

    • 事件类型

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

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

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

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

备注

你可以为单个模型最多创建50个事件。

从行业标准功能库添加

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

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

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

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

备注

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

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

发布功能定义

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

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

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

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

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

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

  4. 点击 OK 来保存标签。

结果

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

相关信息