IoT Platform：FAQ tentang model TSL

Masalah

Kesalahan verifikasi terjadi saat mengimpor file model TSL, seperti yang ditunjukkan pada gambar berikut.

Solusi

Untuk memperbaiki kesalahan verifikasi, gunakan solusi berikut:

• Solusi 1: Periksa format file model TSL dan pastikan bahwa file tersebut dalam format JSON.

• Solusi 2: Klik Download and View untuk mendapatkan file errors.txt. Lakukan pemecahan masalah dan perbaiki masalah berdasarkan isi file errors.txt.

  Untuk informasi lebih lanjut tentang file errors.txt, lihat contoh file berikut.

  Contoh file model TSL:

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

  Contoh file 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}$\""
    }
  ]

  Parameter	Deskripsi
  path	Jalur kesalahan. Dalam contoh ini, kesalahan berikut terdeteksi: // Nilai parameter properties bukan array. "path": [ "properties" ] // Nilai parameter functionBlockId mengandung karakter tidak valid. "path": [ "functionBlockId" ]
  property	Properti tidak valid di "path". Sebagai contoh, dalam "path": ["functionBlockId" ], nilai properti instance.functionBlockId tidak valid.
  message	Pesan kesalahan. Sebagai contoh, dalam "path": ["functionBlockId" ], pesan kesalahan does not match pattern \"^[_a-zA-Z0-9]{1,30}$\" dikembalikan untuk properti instance.functionBlockId.
  schema	Aturan yang digunakan untuk memverifikasi file model TSL. Sebagai contoh, dalam "path": ["functionBlockId" ], aturan type dan pattern digunakan. Untuk informasi lebih lanjut tentang aturan, lihat schema.
  instance	Objek yang diverifikasi. Sebagai contoh, dalam "path": ["functionBlockId" ], pengaturan "functionBlockId": "**mtest" diverifikasi.
  name	Nama aturan yang tidak cocok dalam verifikasi. Sebagai contoh, dalam "path": ["functionBlockId" ], nilai **mtest tidak cocok dengan aturan pattern.
  argument	Isi aturan yang tidak cocok dalam verifikasi. Sebagai contoh, dalam "path": ["functionBlockId" ], isi aturan pattern adalah ^[_a-zA-Z0-9]{1,30}$.
  stack	Nilai gabungan dari parameter property dan message.

Untuk informasi lebih lanjut, lihat jsonschema.

Tabel berikut menjelaskan perbedaan-perbedaan tersebut.

Setelah perangkat mengirimkan data properti, data historis, atau beberapa nilai properti, IoT Platform menghasilkan catatan data berdasarkan timestamp.

Perbedaan antara topik komunikasi dan format data

Topik dan format data bervariasi berdasarkan jenis data yang dikirimkan ke IoT Platform. Untuk informasi lebih lanjut, lihat Perangkat mengirimkan data properti ke IoT Platform, Perangkat mengirimkan data TSL historis ke IoT Platform, dan Perangkat mengirimkan beberapa properti dan acara ke IoT Platform sekaligus.

Contoh

Dalam contoh ini, data properti suhu dikirimkan oleh perangkat ke IoT Platform.

• Perangkat mengirimkan nilai snapshot dari properti suhu.

  1. Perangkat mengirimkan nilai berikut dari properti suhu dengan timestamp dari kiri ke kanan secara berurutan.

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

  2. Perangkat mengirimkan nilai snapshot 100 dari properti suhu. Data berikut ditampilkan berdasarkan metode yang digunakan perangkat untuk mengirimkan data.

     • Jika tidak ada timestamp, IoT Platform menghasilkan timestamp berdasarkan waktu ketika data dikirimkan. Dalam contoh ini, 15:30:00 digunakan. Dalam hal ini, 100 ditampilkan di konsol IoT Platform sebagai nilai properti suhu. Nilai 100 juga merupakan nilai terbaru dari properti suhu dalam catatan data.

     • Jika timestamp ditentukan (misalnya, 15:00:00), 100 menggantikan 80 sebagai nilai properti suhu pada 15:00:00. Dalam hal ini, 100 ditampilkan di konsol IoT Platform sebagai nilai properti suhu. Nilai terbaru dari properti suhu dalam catatan data adalah 90 pada 15:10:00.

• Perangkat mengirimkan nilai historis dari properti suhu.

  1. Perangkat mengirimkan nilai historis berikut dari properti suhu pada saat yang sama.

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

  2. Perangkat mengirimkan nilai historis berikut dari properti suhu pada saat yang sama.

     13:10	14:10
     100	200

     Nilai suhu terbaru yang ditulis ke database ditampilkan di konsol IoT Platform sebagai nilai properti suhu. Dalam contoh ini, 100 pada 13:10:00 ditampilkan atau 200 pada 14:10:00 ditampilkan. Nilai terbaru dari properti suhu dalam catatan data adalah 90 pada 15:10:00.