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