创建模型

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

开始前准备

  • 已设计好该模型所需要的功能。有关如何进行模型的功能设计，参见 模型与资产建模。
  • 你需要有设备管理操作权限，如果没有需联系组织管理员添加。有关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格式表述。