IoT Platform：物模型相關問題

問題現象

如下圖所示，在物聯網平台為產品匯入物模型過程，可能出現如下兩種校正失敗現象。

解決方案

對應上圖①、②兩種校正失敗現象，解決方案如下：

• ①：對物模型檔案進行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。