Di Konsol IoT Platform, Anda dapat mengimpor model Thing Specification Language (TSL) untuk menambahkan beberapa properti, peristiwa, dan layanan. Untuk mengimpor model TSL, Anda bisa mengunggah file JSON TSL atau menyalin model TSL produk lain ke produk saat ini. Topik ini menjelaskan cara menambahkan beberapa fitur TSL sekaligus dengan mengimpor model TSL.
Prasyarat
Sebuah produk telah dibuat. Untuk informasi lebih lanjut, lihat Buat Sebuah Produk.
Catatan penggunaan
Fitur yang sebelumnya didefinisikan untuk produk akan ditimpa setelah Anda mengimpor model TSL baru. Berhati-hatilah saat menjalankan perintah ini.
Jika protokol koneksi gateway dari produk sub-perangkat gateway adalah Modbus, OPC UA, ZigBee, atau BLE, Anda tidak dapat mengimpor model TSL untuk produk tersebut.
Jika sebuah produk telah diterbitkan, Anda tidak dapat menambahkan atau memodifikasi fitur TSL produk tersebut. Untuk menambahkan atau memodifikasi fitur TSL, Anda harus menarik kembali penerbitan produk.
Jika Anda mengimpor model TSL produk lain, nilai parameter Category yang ditentukan untuk produk-produk tersebut harus sama.
Tambahkan fitur TSL
Masuk ke Konsol IoT Platform.
Di pojok kiri atas Konsol IoT Platform, pilih wilayah tempat IoT Platform diaktifkan.
Pada tab All environment halaman Overview, temukan instance yang ingin Anda kelola dan klik ID instance atau nama instance.
Di panel navigasi sisi kiri, pilih Products.
Pada halaman Products, temukan produk yang ingin Anda tambahkan fitur dan klik View di kolom Actions.
Pada halaman Detail Produk, klik tab Definisikan Fitur, lalu klik Edit Draft.
Klik Impor. Pada kotak dialog yang muncul, impor model TSL.

Metode berikut didukung:
Pada tab Copy Product, pilih produk sumber dan versi model TSL, lalu klik OK.
Versi model TSL default dan modul kustom yang Anda pilih diimpor dari produk sumber. Pada tab Define Feature, klik Edit Draft. Pada halaman yang muncul, temukan fitur TSL yang ingin Anda kelola dan klik Edit untuk memodifikasi fitur tersebut.
Di tab Import TSL, unggah file JSON atau paket ZIP yang berisi beberapa file JSON.
Untuk informasi tentang cara memodifikasi dan mengemas file TSL, lihat Apa itu model TSL?
CatatanJika suatu file tidak memenuhi persyaratan, prompt akan ditampilkan untuk menunjukkan bahwa verifikasi gagal ketika Anda mengunggah file ke IoT Platform. Periksa dan modifikasi file sesuai petunjuk. Kemudian, unggah ulang file tersebut. Untuk informasi lebih lanjut tentang cara menyelesaikan masalah ini, lihat Apa yang harus saya lakukan jika verifikasi gagal ketika saya mengimpor file model TSL?
Publikasikan model TSL
Model TSL hanya akan berlaku setelah model tersebut diterbitkan.
Pilih Define Feature > Edit Draft. Di pojok kiri bawah halaman yang muncul, klik Release online. Kotak dialog Release model online? muncul.
Opsional. Klik +Tambah Catatan Pasca, dan masukkan nomor versi dan catatan.
Parameter
Deskripsi
Nomor Versi
Nomor versi model TSL. Anda dapat mengelola model TSL berdasarkan nomor versi.
Nomor versi harus memiliki panjang 1 hingga 16 karakter, dan dapat berisi huruf, angka, dan titik (.).
catatan
Deskripsi model TSL. Deskripsi dapat berisi huruf, angka, dan karakter khusus. Deskripsi harus memiliki panjang 1 hingga 100 karakter.
Jika versi online tersedia, Anda harus memeriksa perbedaan antara versi saat ini yang ingin Anda rilis dan versi online.
Klik View Differences. Di panel View Differences, Anda dapat melihat perbedaan antara versi. Setelah Anda mengonfirmasi pengaturan, klik Confirm. Di kotak dialog Release model online?, kotak centang akan dipilih secara otomatis.
Jika Anda tidak ingin melihat perbedaan antara versi, pilih "Pastikan bahwa Anda telah memverifikasi perbedaan antara versi saat ini dan versi online."
Klik OK untuk menerbitkan model TSL.
Hasil eksekusi
Setelah Anda menerbitkan model TSL, Anda dapat melihat model yang diterbitkan di Konsol IoT Platform. Anda dapat melakukan operasi berikut pada tab Define Feature halaman Product Details:
Klik TSL Model untuk melihat model TSL dalam format JSON.
Operasi API terkait
API | Deskripsi |
Memodifikasi fitur atau informasi tambahan tentang model TSL suatu produk. | |
Meminta detail model TSL suatu produk. | |
Menyalin model TSL suatu produk ke produk tujuan. | |
Menerbitkan model TSL suatu produk. | |
Mengimpor model TSL ke suatu produk. Informasi tambahan tidak dapat diimpor. | |
Meminta detail model TSL yang diterbitkan dari suatu produk. |
Apa yang harus dilakukan selanjutnya
Secara default, data TSL yang dikirimkan oleh perangkat suatu produk secara otomatis ditulis ke ruang penyimpanan data panas. Anda dapat menghentikan layanan penyimpanan data panas untuk beberapa atau semua model TSL berdasarkan kebutuhan bisnis Anda.