单个添加物模型

单个添加物模型，即单个添加属性、服务和事件。本文介绍如何在物联网平台定义物模型。

前提条件

已创建产品。具体操作，请参见创建产品。

使用说明

物模型需要在模块中配置，每个产品中默认模块和自定义模块总个数不能超过20个。

物模型编辑后，需发布才会正式生效。

操作步骤

登录AIOT平台，进入物联网平台-设备接入

在左侧菜单栏，选择产品管理

在产品列表中，单击产品对应的查看。

在产品详情页面，单击物模型页签，再单击编辑草稿，单击默认模块或添加模块。

可选：如果添加模块，完成参数配置，单击确认，然后单击已添加模块名称。

参数	说明
模块名称	支持中文、英文字母、数字和下划线，长度限制 4～30 个字符。
模块编码	模块唯一标识符。支持英文大小写字母、数字和下划线，不超过 30 个字符。
模块描述	输入文字，对模块进行说明或备注。长度限制为200个字符。

6.添加标准物模型。如果您创建产品时选择了标准品类，则物联网平台已为该品类预定义标准物模型。

您也可以添加其他标准属性/服务/事件，点击标准添加，选择适用于该产品的标准物模型功能。
标准品物模型添加.png

通用操作：您可单击功能对应操作列的编辑，修改标准物模型定义。

7.添加自定义物模型

选择自定义添加。您可以为产品自定义属性、服务和事件。

自定义属性：点击属性定义，在添加自定义功能对话框，设置参数完成后，单击确认。

属性参数设置说明如下表。

参数	描述
属性名称	属性的名称，例如：用电量。同一产品下功能名称不能重复。支持中文、大小写字母、数字、短划线、下划线、斜杠和小数点，必须以中文、英文或数字开头，不超过 30 个字符。
标识符	属性唯一标识符，在产品中具有唯一性。即JSON格式中的identifier的值，作为设备上报该属性数据的Key，云端根据该标识符校验是否接收数据。支持大小写字母、数字和下划线、不超过 50 个字符，例如：PowerConsumption。说明不能用以下系统保留参数作为标识符：set、get、post、property、event、time、value。
数据类型	int：整型。需定义取值范围、步长和单位符号。 float：单精度浮点型。需定义取值范围、步长和单位符号。 double：双精度浮点型。需定义取值范围、步长和单位符号。 enum：枚举型。定义枚举项的参数值和参数描述，例如：1表示加热模式、2表示制冷模式。 bool：布尔型。采用0或1来定义布尔值，例如：0表示关、1表示开。 text：字符串。需定义字符串的数据长度，最长支持10240字节。 date：时间戳。格式为String类型的UTC时间戳，单位：毫秒。 jsonObject：JSON结构体。定义一个JSON结构体，新增JSON参数项，例如：定义灯的颜色是由Red、Green、Blue三个参数组成的结构体。支持结构体嵌套。 struct: 结构体。详细定义了各个字段含义的JSON格式，但是只能嵌套一层，不能多级嵌套。 array: 数组。需声明数组内的元素类型、数组元素个数。元素类型支持int32、float、double、text或struct，需确保同一个数组元素类型相同。元素个数限制为1~512个。
取值范围	数据类型为int、float、double时，可设置属性值的取值范围。
步长	属性值变化的最小粒度。数据类型为int、float、double时，可根据您的业务需要设置步长。例如：为温度计产品定义温度属性时，将数据类型设置为int32，步长为2，单位为℃，取值范围0~100。即温度每变化两度，设备上报温度值，例如：0℃、2℃、4℃、6℃、8℃等。
单位	单位可选择为无，或根据实际情况选择。
读写类型	读写：请求读写的方法支持GET（获取）和SET（设置）。只读：请求只读的方法仅支持GET（获取）。
描述	输入文字，对该功能进行说明或备注。长度限制为200个字符。

自定义服务：在物模型页签，选择服务定义。点击自定义添加，设置参数完成后，单击确认。

服务参数设置说明如下表。

参数	描述
服务名称	服务名称。支持中文、大小写字母、数字、短划线、下划线、斜杠和小数点，必须以中文、英文或数字开头，不超过 30 个字符。
标识符	服务唯一标识符，在产品下具有唯一性。即JSON格式中该服务的identifier的值。支持大小写字母、数字和下划线、不超过 50 个字符。说明不能用以下系统保留参数作为标识符：set、get、post、property、event、time、value。
输入参数	设置该服务的入参，可选。单击增加参数，在弹窗对话框中添加服务入参。说明不能用以下系统保留参数作为输入参数的标识符：set、get、post、property、event、time、value。您可以使用某个属性作为入参，也可以自定义参数。例如：在定义自动喷灌服务功能时，将已定义的属性喷灌时间和喷灌量作为自动喷灌服务的入参，则调用该参数时传入这两个参数，喷灌设备将按照设定的喷灌时间和喷灌量自动进行精准灌溉。一个服务最多支持定义20个入参。
输出参数	设置该服务的出参，可选。单击增加参数，在弹窗对话框中添加服务出参。说明不能用以下系统保留参数作为输出参数的标识符：set、get、post、property、event、time、value。您可以使用某个属性作为出参，也可以自定义参数，例如：将已定义的属性土壤湿度作为出参，则云端调用自动喷灌服务时，将返回当前土壤湿度的数据。一个服务最多支持定义20个出参。
描述	输入文字，对该服务功能进行说明或备注。长度限制为200个字符。

自定义事件：在物模型页签，选择服务定义。点击自定义添加，设置参数完成后，单击确认。
事件参数设置说明如下表。

参数	描述
功能名称	事件的名称。支持中文、英文字母、数字、短划线（-）、下划线（_）、正斜线（/）和英文句号（.），且必须以中文、英文、日文或数字开头，不超过30个字符。
标识符	事件唯一标识符，在产品下具有唯一性。即JSON格式中该事件的identifier的值，作为设备上报该事件数据的Key，例如：ErrorCode。支持英文、数字和下划线（_），不超过50个字符。说明不能用以下系统保留参数作为标识符：set、get、post、property、event、time、value。
事件类型	您可以针对不同的事件类型进行业务逻辑处理和统计分析。信息：指设备上报的一般性通知，例如：完成某项任务。告警：设备运行过程中主动上报的突发或异常情况，告警类信息，优先级高。故障：设备运行过程中主动上报的突发或异常情况，故障类信息，优先级高。
输出参数	该事件的出参。单击增加参数，在弹窗对话框中添加一个服务出参。您可以使用某个属性作为出参，也可以自定义参数。例如：将已定义的属性电压作为出参，则设备上报该故障事件时，将携带当前设备的电压值，用于进一步判断故障原因。说明不能用以下系统保留参数作为输出参数的标识符：set、get、post、property、event、time、value。一个事件最多支持定义50个出参。
描述	输入文字，对该事件功能进行说明或备注。长度限制为200个字符。

发布物模型

物模型发布后，才会正式生效。

单击功能定义的编辑草稿页面左下方的发布上线。控制台页面会弹出**发布物模型上线？**对话框。

单击确定，完成物模型的发布。

执行结果

物模型发布后，物联网平台为该产品生成正式版本的物模型。在产品详情页面的功能定义页签下，您可以：

单击物模型TSL，查看JSON格式的物模型TSL。

单击Excel导出，查看物模型excel表格。

单个添加物模型

前提条件#

使用说明#

操作步骤#

发布物模型#

执行结果#

前提条件

使用说明

操作步骤

发布物模型

执行结果