物模型添加指引
本页目录
1. 添加物模型
1）进入/登录行业开发平台 ;
2）在顶部导航栏中，选择控制台 ;
3）在产品列表页面产品列表中，单击产品进入产品详情，若无产品需要先创建产品。
4）在产品详情页左侧菜单栏，点击产品开发，选择产品功能定义。
说明 已发布的产品不能添加和更新功能点。
5）添加标准功能。选择基础功能点 > 添加标准功能，然后在弹出的对话框中，选择适用于该产品的行业开发平台预定义的标准功能。
图 1 添加标准功能入口
图 2 添加标准功能
6）添加自定义功能。单击添加自定义功能为产品新增自定义功能。您可为产品自定义属性和事件。
图 3 添加自定义功能入口
◈ 自定义属性：在添加自定义功能对话框中，选择功能类型为属性。设置参数完成后，单击确认。
图 4 添加自定义功能：属性
- 属性参数设置说明如下表：
| 参数 | 说明 |
|---|---|
| 功能点名称 | 属性的名称，例如用电量。同一产品下功能名称不能重复。 支持中文、大小写字母、数字、短划线和下划线，且必须以中文、英文或数字开头，不超过20个字符。 |
| 字段名称 | 属性唯一标识符，在产品中具有唯一性。即功能点信息中的 subject的值，可包含英文、数字、下划线，以字母开头，长度不超过20个字符。 |
| 数据类型 | 布尔型：BOOLEAN，数据长度1个字节，采用0或1来定义布尔值。例如0-关；1-开。 数值型：INTEGER（整数型），数据长度4个字节，范围[-2147483648~2147483647]。需定义取值范围、间距和单位符号。Float（单精度浮点型），数据长度4个字节，范围[3.4E-38~3.4E+38]。需定义取值范围、间距和单位符号。 枚举型：ENUM，数据长度1个字节，范围[0~255]。定义枚举项的参数值和参数描述，例如1-加热模式、2-制冷模式等。 字符型: STRING，需定义字符串的数据长度，数据长度最长支持1048576字节。 透传型：BUFFER，以十六进制的字符串形式透传的功能点，需定义字符串的数据长度，数据长度最长支持1048576字节。 |
| 数值范围 | 属性值和事件中输入输出参数值变化的最小粒度。数据类型为数值型时，需要根据您的业务需要设置数值范围。 例如为温度计产品定义温度属性时，将数据类型设置为int32，间距为2，单位为℃，取值范围-30~30。即温度每变化两度，设备上报温度值，例如-2℃、0℃、2℃、4℃……。 |
| 单位 | 单位可选择为无或根据实际情况选择。 |
| 传输类型 | 可下发可上报：指令数据可以下发给设备，设备数据可以上报给云端； 只上报：数据只支持从设备上报； 只下发：数据只支持从云端下发。 |
| 描述 | 输入文字，对该功能进行说明或备注。长度限制为最大不超过200个字符。 |
◈ 自定义事件：在添加自定义功能对话框中，选择功能类型为事件。设置参数完成后，单击确认。
图 5 添加自定义功能：事件
- 事件参数设置说明如下表：
| 参数 | 说明 |
|---|---|
| 功能点名称 | 事件的名称。支持中文、大小写字母、数字、短划线和下划线，且必须以中文、英文或数字开头，不超过20个字符。 |
| 字段名称 | 事件唯一标识符，在产品下具有唯一性。即功能点信息中的 subject的值，可包含英文、数字、下划线，以字母开头，长度不超过20个字符，例如 ErrorCode。 |
| 事件类型 | 事件型：EXCEPTION，每一位标识一个“信息”，“信息”是设备上报的一般性通知，如完成某个功能操作。“告警”和“故障”是设备运行过程中主动上报的异常情况，优先级高。不同的事件类型将用于统计分析。最多表示64个。数据长度4个字节，范围[0~2147483647]。 |
| 输出参数 | 该事件的出参。单击添加输出参数，在弹窗对话框中添加一个输出参数。参数格式包括：参数名称、参数字段、数据类型及参数范围。 |
| 描述 | 输入文字，对该功能进行说明或备注。长度限制为最大不超过200个字符。 |
7）添加组合功能。选择组合功能点 > 添加组合功能，然后在弹出对话框中，您可为产品新增自定义的组合功能点。
图 6 添加组合功能入口
◈ 新建组合功能：在新建组合功能对话框中，选择功能类型为属性或事件。设置参数完成后，单击确认。
图 7 新建组合功能
- 参数设置说明如下表：
| 参数 | 说明 |
|---|---|
| 功能点名称 | 属性或事件的名称，例如用电量。同一产品下功能名称不能重复。 支持中文、大小写字母、数字、短划线和下划线，且必须以中文、英文或数字开头，不超过20个字符。 |
| 功能类型 | 组合功能的类型为属性或事件时，独立功能点类型只能为对应的属性类型或事件类型。 |
| 传输类型 | 可下发可上报：指令数据可以下发给设备，设备数据可以上报给云端； 只上报：数据只支持从设备上报； 只下发：数据只支持从云端下发。 |
| 字段名称 | 属性或事件的唯一标识符，在产品中具有唯一性。可包含英文、数字、下划线，以字母开头，长度不超过20个字符 |
| 独立功能点 | 独立功能点是基础功能点，组合功能点由多个基础功能点组合构成的，可共同上报，共同下发。 |
8）添加固定上报功能。选择固定功能点 > 添加标准功能，然后在弹出对话框中，选择适用于该产品在平台预定义的标准功能。
图 8 添加固定上报入口
◈ 添加固定上报：在添加固定上报功能对话框中，设置相应参数，单击确认。
图 9 添加固定上报
- 参数设置说明如下表：
| 参数 | 说明 |
|---|---|
| 功能点名称 | 属性的名称，例如用电量。同一产品下功能名称不能重复。 支持中文、大小写字母、数字、短划线和下划线，且必须以中文、英文或数字开头，不超过20个字符。 |
| 字段名称 | 属性唯一标识符，在产品中具有唯一性。可包含英文、数字、下划线，以字母开头，长度不超过20个字符。 |
| 数据类型 | 布尔型：BOOLEAN，数据长度1个字节，采用0或1来定义布尔值。例如0-关；1-开。 数值型：INTEGER（整数型），数据长度4个字节，范围[-2147483648~2147483647]。需定义取值范围、间距和单位符号。Float（单精度浮点型），数据长度4个字节，范围[3.4E-38~3.4E+38]。需定义取值范围、间距和单位符号。 枚举型：ENUM，数据长度1个字节，范围[0~255]。定义枚举项的参数值和参数描述，例如1-加热模式、2-制冷模式等。 字符型: STRING，需定义字符串的数据长度，数据长度最长支持1048576字节。 透传型：BUFFER，以十六进制的字符串形式透传的功能点，需定义字符串的数据长度，数据长度最长支持1048576字节。 |
| 传输类型 | 只上报：固定上报功能的数据只支持从设备上报。 |
| 值的定义 | 关于固定上报功能点值的描述。 |
| 备注 | 输入文字，对该功能进行说明或备注。长度限制为最大不超过200个字符。 |
2. 物模型导出与复制
完成功能定义后，物联网平台为该产品生成物模型，支持指定产品的功能点复制，也支持功能点的导出与导入。
图 10 功能点导入、导出与复制
▻ 导入功能点：可导入分类相同产品的功能点，仅支持.json格式文件。
▻ 导出全部功能点：导出.json文件，包含该产品下定义的全部功能点定义。
▻ 复制功能定义：该操作可将您的其它产品或已经获取的产品所定义的物模型复制到当前产品下，复制的产品物模型会覆盖当前产品所定义的功能。
这篇文档是否帮助您解决了问题?