模型要素库管理


模型要素库包含当前 OU 内可以获取的所有模型要素,包括:

  • 自建要素:在当前 OU 自建模型时创建的模型要素,以及在模型要素库中直接创建的模型要素。

  • 共享要素:其它 OU 分享至当前 OU 的模型要素。


你可以在模型要素库中配置需要多次引用的模型要素,然后在配置模型时引用该要素,提升模型要素的管理和使用效率。

前提条件


确保已拥有 在分组内添加和管理数据 中的相关权限。

新建模型要素


按照以下步骤在模型要素库中创建全新的模型要素。

  1. 选择 模型要素库 > 自建要素 中的 特性命令 标签页,选择 新建特性

  2. 模型定义 页,选择 新建 后,根据需要选择新建 特性(属性或测点) 或 命令

新建属性


  1. 新建特性 弹窗中,为 类型 选择 属性,并根据界面提示配置信息,其中:

    • 名称:属性的名称。

    • 标识符:属性的唯一标识符。

    • 分组:属性所属分组。仅当拥有该分组的权限,用户才能查看和使用该分组内的要素。

    • 数据类型:属性的数据类型。更多信息,参见 数据类型

    • 描述:属性的描述。

  2. 选择 保存 完成创建该属性。

  3. 重复以上操作创建更多属性。

新建测点


  1. 新建特性 弹窗中,为 类型 选择 测点,并根据界面提示配置信息,其中:

    • 名称: 测点的名称。

    • 标识符: 测点的唯一标识符。

    • 测点类型:必填项。测点类型用于区别测点数据的不同特征。在存储数据时,不同类型的测点数据可分类存储;在读取数据时,对不同类型的数据提供不同的处理能力。对各测点类型的描述如下:

      • 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. 重复以上操作创建更多测点。

备注

在创建新测点之后,需要及时为测点数据配置存储策略。否则设备接入到云端后,测点数据不会默认被存储到时序数据管理。有关配置存储策略的详细步骤,参见 配置 TSDB 存储

新建命令


  1. 自建要素 > 命令 页面,选择 新建命令,在 类型 中选择 命令,根据页面提示配置好相关信息,其中:

    • 名称: 服务的名称。

    • 标识符: 服务的唯一标识符。

    • 输入参数:服务的输入参数,其中可指定该参数是否在调用服务时需要为其输入参数提供值、为其输入参数指定最大/最小值以及调用服务如果需要但没提供值时为其提供默认值。

    • 输出参数:输出参数定义命令执行后所需的返回结果。可指定命令执行后,是否需要为该参数提供值,值的类型、最大/最小范围以及默认值等

    • 描述: 服务的描述。


  2. 选择 保存 创建该命令。

  3. 重复以上操作创建更多命令。

结果


创建要素后,在 自建要素 列表中可查看新建的要素。

  • 点击 编辑 按钮,可编辑列表中的要素。

  • 选择 … > 复制,可复制列表中的要素。

  • 选择 … > 删除,可删除列表中的要素。

  • 选择 查看 按钮,可查看无权限修改的要素。

相关步骤


引用模型要素