物模型相关问题

问题现象

如下图所示，在物联网平台为产品导入物模型过程，可能出现如下两种校验失败现象。

解决方法

对应上图①、②两种校验失败现象，解决方案如下：

• ①：对物模型文件进行JSON格式化校验，完成修正。

• ②：单击下载查看，获取errors.txt文件，定位问题及原因，完成修正。

  errors.txt文件的详细说明，请参见如下示例。

  物模型文件示例：

  {
      "schema":"https://iotx-tsl.oss-ap-southeast-1.aliyuncs.com/schema.json",
      "profile":{
          "productKey":"a1Jk***"
      },
      "services":[],
      "properties": 1,
      "events": [],
      "functionBlockId": "模块mtest",
      "functionBlockName": "自定义模块1"
  }

  下载的errors.txt文件：

  [
    {
      "path": [
        "properties"
      ],
      "property": "instance.properties",
      "message": "is not of a type(s) array",
      "schema": {
        "type": "array",
        "items": {
          "$ref": "#/definitions/propertyDefinition"
        }
      },
      "instance": 1,
      "name": "type",
      "argument": [
        "array"
      ],
      "stack": "instance.properties is not of a type(s) array"
    },
    {
      "path": [
        "functionBlockId"
      ],
      "property": "instance.functionBlockId",
      "message": "does not match pattern \"^[_a-zA-Z0-9]{1,30}$\"",
      "schema": {
        "type": "string",
        "pattern": "^[_a-zA-Z0-9]{1,30}$"
      },
      "instance": "模块mtest",
      "name": "pattern",
      "argument": "^[_a-zA-Z0-9]{1,30}$",
      "stack": "instance.functionBlockId does not match pattern \"^[_a-zA-Z0-9]{1,30}$\""
    }
  ]

  参数	说明
  path	校验后，出错的路径。本文示例校验出2处错误： // properties配置错误，不是数组 "path": [ "properties" ] // functionBlockId含有中文 "path": [ "functionBlockId" ]
  property	path下不合规则的具体对象。 例如"path": ["functionBlockId" ]中的instance.functionBlockId。
  message	具体的错误提示信息。 例如"path": ["functionBlockId" ]中，提示property的错误为does not match pattern \"^[_a-zA-Z0-9]{1,30}$\"。
  schema	校验的规则名称及对应内容。 例如"path": ["functionBlockId" ]中的规则type和pattern。 有关规则定义的详细内容，请参见schama。
  instance	校验的具体对象。 例如"path": ["functionBlockId" ]中，校验物模型文件中"functionBlockId": "模块mtest"的内容。
  name	校验未通过规则的名称。 例如"path": ["functionBlockId" ]中，校验对象模块mtest不符合规则pattern。
  argument	校验未通过规则的内容。 例如"path": ["functionBlockId" ]中，不符合规则pattern的定义为^[_a-zA-Z0-9]{1,30}$。
  stack	堆栈信息。由property和message内容组合的完整错误提示信息。

更多信息，请参见校验工具jsonschema的说明。

功能区别

物模型的属性上报、历史数据上报、批量属性上报到物联网平台后，均会根据时间戳形成历史数据。

通信Topic和数据格式的区别

Topic和数据格式不同，详细说明，请参见设备上报属性、物模型历史数据上报和设备批量上报属性。

示例

以设备的温度数据为例：

• 物模型属性上报：

  1. 设备按照下表所示，从左至右，携带时间戳依次上报快照数据。

     13:00	14:00	15:00	15:10
     60	70	80	90

  2. 设备再上报一个快照值100，不同上报方式更新数据如下：

     • 不携带时间戳时，默认为当前时间（假设15:30）。此时，物联网平台控制台显示的快照值是15:30的100；历史数据列表中最新数据是15:30的100。

     • 携带时间戳时，例如15:00，更新15:00的数据为100。此时，物联网平台控制台显示的快照值是15:00的100；历史数据列表中最新数据还是15:10的90。

• 物模型历史数据上报：

  1. 设备同时上报以下历史数据。

     13:00	14:00	15:00	15:10
     60	70	80	90

  2. 设备再同时上报以下历史数据。

     13:10	14:10
     100	200

     此时，物联网平台控制台显示的快照值为13:10的100或14:10的200（以最后写入数据库的值为准）；历史数据列表中最新数据还是15:10的90。