IoT Platform:TSLモデルに関するFAQ

発行

次の図に示すように、TSLモデルファイルをインポートすると検証エラーが発生します。

解決策

検証エラーを修正するには、次のソリューションを使用します。

• 解決策1: TSLモデルファイルの形式を確認し、ファイルがJSON形式であることを確認します。

• 解決策2: [ダウンロードして表示] をクリックしてerrors.txtファイルを取得します。 errors.txtファイルに基づいて問題のトラブルシューティングと解決を行います。

  errors.txtファイルの詳細については、次のサンプルファイルをご参照ください。

  サンプルTSLモデルファイル:

  {
      "スキーマ":"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": [
        "プロパティ"
      ],
      "property": "instance.properties" 、
      "message": "配列型ではない" 、
      "schema": {
        "type"： "array"、
        "items": {
          "$ref": "#/definition /propertyDefinition"
        }
      },
      "instance": 1,
      "name": "type",
      "argument": [
        「配列」
      ],
      "stack": "instance.propertiesは配列型ではありません"
    },
    {
      "path": [
        "functionBlockId"
      ],
      "property": "instance.functionBlockId" 、
      "message": "パターンと一致しません \" ^[_a-zA-Z0-9]{1,30 }$\ "" 、
      "schema": {
        "type"： "string"、
        "pattern": "^[_a-zA-Z0-9]{1,30}$"
      },
      "instance": "** mtest "、
      "name": "パターン" 、
      "引数": "^[_a-zA-Z0-9]{1,30}$" 、
      "stack": "instance.functionBlockIdがパターンと一致しない \" ^[_a-zA-Z0-9]{1,30 }$\ ""
    }
  ]

  パラメーター	説明
  パス	エラーのパス。 この例では、次のエラーが検出されます。 // propertiesパラメーターの値は配列ではありません。 "path": [ "プロパティ" ] // functionBlockIdパラメーターの値に無効な文字が含まれています。 "path": [ "functionBlockId" ]
  property	"path" の無効なプロパティ。 たとえば、"path": ["functionBlockId" ] では、instance.functionBlockIdプロパティの値が無効です。
  message	エラーメッセージを示します。 たとえば、"path": ["functionBlockId" ] では、instance.functionBlockIdプロパティのエラーメッセージdoes not match pattern \"^[_a-zA-Z0-9]{1,30 }$\" が返されます。
  schema	TSLモデルファイルの検証に使用されるルール。 たとえば、"path": ["functionBlockId" ] では、typeとpatternのルールが使用されます。 ルールの詳細については、「schema」をご参照ください。
  インスタンス	検証されたオブジェクト。 たとえば、"path": ["functionBlockId" ] では、"functionBlockId": "** mtest "の設定が検証されます。
  name	検証で一致しないルールの名前。 たとえば、"path": ["functionBlockId" ] では、**mtestの値がpatternルールと一致しません。
  引数	検証で一致しないルールの内容。 たとえば、"path": ["functionBlockId" ] では、パターンルールの内容は ^[_a-zA-Z0-9]{1,30}$ です。
  スタック	プロパティパラメーターとメッセージパラメーターの連結値。

詳細は、「jsonschema」をご参照ください。

下表に違いを示します。

デバイスがプロパティデータ、履歴データ、またはプロパティの複数の値を送信すると、IoT Platformはタイムスタンプに基づいてデータレコードを生成します。

コミュニケーショントピックとデータ形式の違い

トピックとデータ形式は、IoT Platformに送信されるデータの種類によって異なります。 詳細については、「デバイスはIoT Platformにプロパティデータを送信」、「デバイスはIoT Platformに過去のTSLデータを送信」、「デバイスは一度に複数のプロパティとイベントをIoT Platformに送信」をご参照ください。

例

この例では、温度プロパティのデータはデバイスによってIoT Platformに送信されます。

• デバイスは、温度プロパティのスナップショット値を送信します。

  1. デバイスは、次のtemperatureプロパティの値を、タイムスタンプとともに左から右に順番に送信します。

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

  2. デバイスは、温度プロパティのスナップショット値100を送信します。 次のデータは、デバイスがデータの送信に使用する方法に基づいて表示されます。

     • タイムスタンプが存在しない場合、IoT Platformはデータが送信された時刻に基づいてタイムスタンプを生成します。 この例では、15:30:00が使用されます。 この場合、100はIoT Platformコンソールに温度プロパティの値として表示されます。 値100は、データレコード内の温度特性の最新の値でもある。

     • タイムスタンプ (たとえば、15:00:00) が指定されている場合、100は15:00:00のtemperatureプロパティの値として80を置き換えます。 この場合、100はIoT Platformコンソールに温度プロパティの値として表示されます。 データレコードのtemperatureプロパティの最新値は15:10:00に90です。

• デバイスは、温度プロパティの履歴値を送信します。

  1. デバイスは、温度特性の以下の履歴値を同時に送信します。

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

  2. デバイスは、温度特性の以下の履歴値を同時に送信します。

     13:10	14:10
     100	200

     データベースに書き込まれた最新の温度値は、温度プロパティの値としてIoT Platformコンソールに表示されます。 この例では、13:10:00の100が表示されるか、14:10:00の200が表示されます。 データレコードのtemperatureプロパティの最新値は15:10:00に90です。