创建模型¶

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

前提条件¶

已设计好该模型所需要的功能。有关如何进行模型的功能设计，参见模型与资产建模。
你需要有创建模型的权限，如果没有需联系组织管理员添加。有关EnOS内的用户权限，参见策略，角色，与权限。
确保已阅读模型的使用限制。参见使用限制。

任务描述¶

根据定义好的模型，在 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格式表述。