创建模型¶
模型是对产品功能的抽象,模型定义了产品是什么、能做什么、可以对外提供哪些服务。本文描述了如何创建模型。
开始前准备¶
任务描述¶
根据定义好的模型,在 EnOS 中配置各项功能。
属性
测点
服务
事件
使用限制¶
EnOS 对每个 OU 具有以下限制:
最多可以创建1000个私有模型。
每个模型可创建的属性/测点/服务/事件的最大数量为5,000。
步骤一:创建模型¶
在 EnOS 管理控制台 中选择 模型。
点击页面右上方 创建模型,在 创建模型 页面根据界面提示配置信息,其中:
分类:可以填写诸如厂商、设备型号等的产品扩展信息。
模型关系:可选择 无 、 拷贝 、或 继承 。具体含义参见模型关系。
点击 确定 完成操作。
步骤二:为模型创建功能定义¶
点击需要定义功能的模型的所对应的 。
选择 功能定义 标签,并点击 编辑,然后点击 新增 。根据需要选择 新建自定义功能 或 从标准功能库添加 。
新建自定义功能¶
选择 新建自定义功能 后,你就可以根据页面提示添加自定义的功能定义。
新增属性 ¶
在 添加功能 页面,功能类型 中选择 属性,并根据界面提示配置信息。有关 数据类型 的更多信息,参见数据类型。
点击 确定 完成创建该属性。
重复以上操作创建更多属性。
备注
你可以为单个模型最多定义200个属性。
新增测点¶
测点页面中的配置信息如下:
在 添加功能 页面,功能类型 中选择 测点,并根据界面提示配置信息。其中:
测点类型:必填项。测点类型用于区别测点数据的不同特征。在存储数据时,不同类型的测点数据可分类存储;在读取数据时,对不同类型的数据提供不同的处理能力。对各测点类型的描述如下:
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。
点击 确认 来创建该测点。
(可选)重复以上操作创建更多测点。
备注
在创建新测点之后,需要及时为测点数据配置存储策略。否则设备接入到云端后,测点数据不会默认被存储到时序数据管理。有关配置存储策略的详细步骤,参见 配置 TSDB 存储。
新增服务¶
在 添加功能 页面,功能类型 中选择 服务,根据页面提示配置好相关信息。
(可选)点击 确认 来创建该服务。
重复以上操作创建更多服务。
备注
你可以为单个模型最多创建50个服务。
新增事件¶
在 添加功能 弹窗,功能类型 选择 事件,并填写以下字段:
事件类型:
信息:指设备发出的通知,比如任务完成的通知。
告警:告警信息。运行中的设备自发上报的、可能影响设备正常运行的情况。这些事件优先级较高。你可以根据告警级别采取处理措施或进行进一步数据分析。
故障:故障信息。运行中的设备自发上报的、导致设备无法正常运行的紧急情况或异常。优先级最高。应当根据故障级别采取处置措施或者进行进一步数据分析。
点击 确认 , 完成事件的创建。
备注
你可以为单个模型最多创建50个事件。
从行业标准功能库添加¶
选择 从行业标准库添加 。
在 选择基本资源 列表中,找到需要的行业标准功能定义,点击 确定。
在 添加功能 中,根据需要修改该标准功能的 名称 、标识符、测点类型 (默认为通用)、(如果该标准元素为测点)有无质量位、描述。
点击 确认 ,完成标准功能定义的添加。
备注
你可以在同一个模型的功能定义中,多次添加同一个标准功能定义,只要这些标准功能定义的 标识符 在不同即可。
标准功能的 功能类型、标准标识符、数据类型、单位 是不能编辑的。
发布功能定义¶
添加完所有的功能定义后,点击发布,完成功能定义的添加。
步骤3:(可选)添加标签¶
标签描述同类模型所具有的共性信息。用于区分模型对象所属的领域、类型、范围等各种分类。比如,你可以通过添加 domain:solar 标签代表该模型属于太阳能领域。
从模型列表中找到目标模型并点击 。
在 基础信息 标签下的 标签 区域中点击 编辑。
在弹出窗口中,点击 创建标签,输入新标签的键值对 (key:value)。
点击 OK 来保存标签。
结果¶
完成模型功能定义后,系统将自动生成该产品的模型,以JSON格式表述。