Setelah perangkat mengirimkan pesan dalam format kustom menggunakan topik kustom dengan tag penguraian ?_sn=default, IoT Platform menjalankan skrip penguraian untuk mengonversi data kustom dari pesan yang diterima menjadi struktur JSON. Data yang telah dikonversi kemudian diteruskan ke sistem bisnis berikutnya. Topik ini menjelaskan cara mengirimkan skrip penguraian pesan untuk mengurai pesan dalam format kustom.
Catatan penggunaan dan batasan
Penguraian topik kustom hanya didukung di wilayah dan Jepang (Tokyo).
IoT Platform hanya akan mengurai pesan jika pesan tersebut dikirim oleh perangkat yang terhubung melalui Message Queuing Telemetry Transport (MQTT).
IoT Platform hanya mengurai pesan yang dikirim oleh perangkat ke platform, bukan data yang dikirim dari platform ke perangkat.
IoT Platform mengurai muatan pesan yang diterima dan mengembalikan muatan yang telah diurai.
Saat IoT Platform mengurai pesan, pesan yang telah diurai tetap berada di topik yang sama. Sebagai contoh, jika perangkat mengirimkan pesan ke topik
/${productKey}/${deviceName}/user/update, data yang telah diurai tetap berada di topik tersebut.
Tag penguraian
Saat mengonfigurasi perangkat untuk mempublikasikan pesan ke topik kustom, tambahkan tag penguraian ?_sn=default.
IoT Platform hanya akan mengurai pesan jika topik kustom tempat pesan dikirim memiliki tag penguraian.
Sebagai contoh, untuk mengurai pesan yang dikirim oleh perangkat ke topik /${productKey}/${deviceName}/user/update menjadi data berformat JSON, Anda harus menentukan topik berikut saat mengonfigurasi perangkat: /${productKey}/${deviceName}/user/update?_sn=default.
Saat membuat topik kustom di Konsol IoT Platform, jangan tambahkan tag penguraian ke topik.
Prosedur
Masuk ke Konsol IoT Platform.
Di halaman Overview, klik All environment. Di tab Semua Lingkungan, temukan instance yang ingin Anda kelola dan klik ID atau nama instance.
Di panel navigasi sisi kiri, pilih .
Di halaman Products, temukan produk dan klik View di kolom Tindakan.
Di halaman product details, klik tab Message Analysis.
Pilih bahasa skrip dan tuliskan skrip pada bidang Edit Script.
Bahasa
Fungsi yang Diperlukan
Contoh Kode
JavaScript (ECMAScript 5)
transformPayload()
Python 2.7
transform_payload()
PHP 7.2
transformPayload()
CatatanJika Anda menetapkan parameter Data Type produk ke Custom, Anda juga harus menulis skrip untuk mengurai data Thing Specification Language (TSL). Untuk informasi tentang cara menulis skrip untuk mengurai pesan TSL, lihat Kirim Skrip untuk Mengurai Data TSL.
Uji skrip.
Di tab Input Simulation, atur parameter Simulation Type ke Custom dan pilih perangkat serta topik.
Masukkan data simulasi yang dilaporkan oleh perangkat dan klik Run.
Setelah memastikan bahwa skrip valid, klik Submit untuk mengirimkan skrip ke IoT Platform.
(Opsional) Perbarui skrip penguraian pesan
Setelah skrip penguraian pesan dikirimkan, Anda dapat memodifikasi atau menghapus skrip di tab Message Analysis, kemudian menguji dan mengirimkan skrip baru sesuai dengan langkah-langkah yang dijelaskan dalam topik ini. Setelah skrip dikirimkan, skrip akan mulai berlaku pada semua perangkat yang ada dari produk dalam waktu sekitar satu menit dan juga akan diterapkan pada perangkat baru yang ditambahkan ke produk.
Setelah skrip dimodifikasi dan dikirim ulang, pastikan bahwa kode terkait layanan penguraian pesan juga dimodifikasi. Jika tidak, gangguan bisnis mungkin terjadi.
Setelah skrip dihapus, layanan penguraian pesan menjadi tidak tersedia, yang dapat mengganggu bisnis Anda.
Lanjutkan dengan hati-hati.
Referensi
Untuk informasi tentang proses penguraian data, lihat Penguraian Pesan.
Untuk informasi lebih lanjut tentang cara mengurai data TSL dalam format custom, lihat Kirim Skrip untuk Mengurai Data TSL.
Untuk informasi tentang operasi API yang digunakan untuk mengirim pesan ke perangkat, lihat Penggunaan Model TSL dan Perpesanan.