配置模型定义¶

模型要素定义了产品是什么、能做什么、可以对外提供哪些服务。本文介绍如何在已创建的模型中新建或引用属性、测点、命令等模型要素以及组件。以下是 EnOS 中定义模型功能的模型要素：

模型要素	描述	例子
特性：属性	描述设备的静态属性。用户可自定义属性的名称以及标识符，名称相当于是一个描述，允许中文输入。	名称、型号、位置、设计参数、经度等
特性：测点	描述设备运行时的状态。测点允许用户自定义测点的名称以及标识符，名称相当于是一个描述，允许中文输入。	温度、压力、电流、电压、各类状态等
命令	可被外部调用的能力或方法。可设置输入参数和输出参数。相比于属性，命令可通过一条指令实现更复杂的业务逻辑。	下发的指令、执行的任务等

前提条件¶

已设计好该模型所需要的功能。有关如何进行模型的功能设计，参见模型设计。
你需要有创建模型的权限和对应分组的权限。更多信息，参见模型管理权限分配。

新建模型要素 ¶

创建全新的模型要素，从头开始定义模型特性和命令。

选择模型 > 自建模型，选择模型对应的编辑图标。

备注

编辑共享模型的模型要素时，需要选择左上角 自定义配置 按钮切换至自定义配置界面后进行配置。共享模型生效的配置 = 自定义配置 + 原始配置中未修改的部分。
在 模型定义 页，选择新建后，根据需要选择新建特性或命令。

新建属性 ¶

在 新建特性 页面，类型中选择属性，并根据界面提示配置信息，其中：
- 名称：属性的名称。
- 标识符：属性的唯一标识符。
- 数据类型：属性的数据类型。更多信息，参见数据类型。
- 描述：属性的描述。
选择保存完成创建该属性。
重复以上操作创建更多属性。

新建测点 ¶

在 新建特性 页面，类型中选择测点，并根据界面提示配置信息，其中：
- 名称: 测点的名称。
- 标识符: 测点的唯一标识符。
- 测点类型：必填项。测点类型用于区别测点数据的不同特征。在存储数据时，不同类型的测点数据可分类存储；在读取数据时，对不同类型的数据提供不同的处理能力。对各测点类型的描述如下：
  - AI：AI 类型的测点数据一般为数值型数据，在读取数据时可对数据进行聚合处理。
  - DI：DI 类型的测点数据一般为设备状态数据，在读取数据时可对数据进行变位查询。
  - PI：PI 类型的测点数据一般为电量计算数据，在读取数据时可进行聚合处理。
  - 通用：除以上类型以外的其他类型的测点，一般用于上传非数值类型的数据。
  备注
  
  如果已有测点数据上送，测点类型不能修改。测点类型的变更会导致已存储的历史数据无法查询。
- 数据类型：可用的数据类型将根据所选的测点类型而有所不同。
  - AI：可供选择的数据类型为 enum，integer，float 和 double。
  - DI：可供选择的数据类型为 enum 和 integer
  - PI：仅 double 数据类型可用。
  - 通用：可供选择的数据类型为 date，dateTime，integer，float，double，enum，string，array，map 和 obejct。
  更多信息，参见数据类型。
- 是否有质量位：设置该测点值是否代表数据质量。如果设置为有，则配置如下：
  - 质量位：系统使用预定义的数组型的数据质量指示，不可更改。可选择查看了解预定义的质量位参数和描述。
  - 值：设置该测点的数据类型。类型只支持 integer，float 和 double。
- 描述: 测点的描述。

2. 选择保存来创建该测点。

3. 重复以上操作创建更多测点。

新建命令¶

在 新建命令 页面，类型中选择命令，根据页面提示配置好相关信息，其中：
- 名称: 服务的名称。
- 标识符: 服务的唯一标识符。
- 输入参数：服务的输入参数，其中可指定该参数是否在调用服务时需要为其输入参数提供值、为其输入参数指定最大/最小值以及调用服务如果需要但没提供值时为其提供默认值。
- 输出参数：输出参数定义命令执行后所需的返回结果。可指定命令执行后，是否需要为该参数提供值，值的类型、最大/最小范围以及默认值等
- 描述: 服务的描述。
选择保存创建该命令。
重复以上操作创建更多命令。

引用模型要素 ¶

基于已有模型及模型要素进行引用，包括引用特性、命令和组件，避免重复工作。在该步骤前，需要确保已在模型要素库中配置需要引用的模型要素。

选择模型 > 自建模型 或 共享模型，选择模型对应的编辑图标。

备注

编辑共享模型的模型要素时，需要选择左上角 自定义配置 按钮切换至自定义配置界面后进行配置。共享模型生效的配置 = 自定义配置 + 原始配置中未修改的部分。
在 模型定义 页，选择新建右侧 …，根据需要选择引用特性、命令或组件。
在引用配置页面，勾选需要引用的特性、命令或组件并选择 下一步 或确定。

将某模型开放为组件后，可以在配置其他模型时引用该组件，组件中的模型要素将一并组合至自定义的模型中。具体操作，参见开放模型为组件。

编辑模型要素¶

在模型详情页，选择 模型定义 标签页，根据需要编辑模型要素。

选择 … > 编辑基本信息 修改模型基本信息。
选择删除模型要素。
选择编辑模型要素。
若需修改共享模型的其他模型要素，选择左上角切换至自定义配置并选择修改 > 特性或命令，勾选待修改的模型要素，并配置相应特性后选择确定。

下一步¶

配置特性规则