创建模型

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

开始前准备

  • 已设计好该模型所需要的功能。有关如何进行模型的功能设计,参见 物模型概述

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

任务描述

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

  • 属性

  • 测点

  • 服务

  • 事件

步骤一:创建模型

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

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

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

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

  3. 点击 确定 完成操作。

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

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

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

新建自定义功能

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

新增属性

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

    • 数据类型:该属性的数据类型。

      • date:date的格式为yyyy-MM-dd HH:mm:ss。

      • file:文件类型参数,value值为URI格式的文件路径。如果用在测点类型当中,通过open Api的方式上传文件,系统会自动将文件路径保存到value当中。

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

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

备注

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

新增测点

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

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

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

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

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

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

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

      备注

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

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

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

      • 值:设置该测点的数据类型。类型只支持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格式表述。

相关信息