Untuk mengirim pesan topik kustom secara bersamaan ke beberapa perangkat, gunakan pekerjaan pengiriman pesan batch dari IoT Platform. Topik ini menjelaskan cara membuat pekerjaan tersebut, topik operasi dan format datanya, serta prosedur untuk memantau status pekerjaan.
Prasyarat
Anda telah menambahkan topik kustom dengan izin Subscribe atau Subscribe And Publish untuk perangkat di IoT Platform. Untuk informasi lebih lanjut, lihat menggunakan komunikasi topik kustom.
Anda telah berhasil berlangganan topik kustom pada perangkat dan belum berhenti berlangganan. Untuk informasi lebih lanjut, lihat Link SDK's subscribe topic.
Proses manajemen tugas
Buat tugas layanan Pub.
- Di Konsol IoT Platform, temukan instance yang ingin Anda kelola dan klik nama instance. Di panel navigasi kiri halaman Detail Instance, pilih . Di halaman Tugas, klik Create Task.
Navigasikan ke halaman Create Task, klik ikon bantuan
di sebelah nama parameter, konfigurasikan tugas dan pekerjaan sesuai petunjuk, dan pilih Complete.Konfigurasi Tugas
Parameter
Deskripsi
Nama Tugas
Masukkan nama tugas yang valid.
Jenis Tugas
Pilih jenis: Pub Batch Message Push Task.
Deskripsi Tugas
Berikan detail seperti tujuan tugas untuk memudahkan identifikasi.
Perangkat Tujuan, Produk, atau Grup
Pilih perangkat tempat Anda ingin menjalankan tugas. Anda dapat memilih perangkat individual, perangkat berdasarkan produk, atau perangkat berdasarkan grup.Penting Jika Anda memilih perangkat berdasarkan grup, Anda tidak dapat memilih grup dinamis.Aturan Eksekusi Tugas untuk Perangkat
Unggah file aturan dalam format
.json, pastikan ukuran file tidak melebihi 64 KB.Anda dapat mengklik Download Template untuk mendapatkan template aturan.
Sebagai contoh, untuk beberapa perangkat, topik kustom adalah:
/${productKey}/${deviceName}/user/get. Contoh potongan kode adalah:{ "topicShortName": "get", "messageContent": "eyJ0ZXN0IjoidGFzayBiYXRjaHB1YiBicm9hZGNhc3QifQ==" }topicShortName: Mendefinisikan topik kustom lengkap:
/${productKey}/${deviceName}/user/${topicShortName}. Sebagai contoh, nilai dari/${productKey}/${deviceName}/user/gettopicShortName untuk topikgetadalah .messageContent: Isi pesan yang akan dikirim, yang harus dikonversi ke data biner dan dienkripsi dalam Base64.
Konfigurasi Pekerjaan
Parameter
Deskripsi
Konfigurasi Push Eksekusi Pekerjaan
Sesuaikan jumlah pekerjaan yang didorong per menit sesuai kebutuhan bisnis Anda.
Atur Number Of Jobs Executed Per Minute sesuai kebutuhan operasional Anda.
Pilih Push Message Type untuk tugas kustom dan tugas push pesan batch Pub.
Opsi termasuk:
QoS0: Mengirim pesan maksimal sekali.
QoS1: Memastikan pengiriman minimal sekali. Jika respons PUBACK tidak diterima setelah mengirim pesan QoS 1, pesan akan dikirim ulang ke perangkat saat terhubung kembali ke IoT Platform.
Konfigurasi Waktu Habis Eksekusi Pekerjaan
Parameter opsional ini memungkinkan Anda menetapkan waktu habis untuk tugas perangkat. Jika tidak diatur, tugas tidak akan habis waktu. Ini hanya berlaku untuk tugas kustom.
Timer dimulai ketika tugas perangkat memasuki status IN_PROGRESS. Jika tugas melebihi batas waktu yang ditentukan tanpa selesai, status pekerjaan berubah menjadi TIMED_OUT, dan eksekusi pekerjaan dihentikan.
Setelah pembuatan tugas, IoT Platform mengirim pesan ke beberapa perangkat menggunakan API Pub, yang kemudian meminta perangkat untuk mengembalikan hasil respons ke IoT Platform.
Topik pesan kustom mengikuti pola
/${productKey}/${deviceName}/user/${TopicShortName}, dengan format data yang ditentukan pengguna.- Di Konsol IoT Platform, temukan instance tempat tugas berada dan klik nama instance. Di halaman Detail Instance, pilih . Di halaman Tugas, Anda dapat melihat detail yang relevan, termasuk status tugas yang Anda buat. Penting Jika tugas berada dalam status Timed Out, tugas tidak dapat lagi dieksekusi berdasarkan jadwal yang ditentukan.
Jika sub-tugas gagal dieksekusi dalam tujuh hari setelah waktu pembuatan tugas, tugas memasuki status Timed Out.
Anda dapat melakukan salah satu operasi berikut berdasarkan kebutuhan bisnis Anda:
- Di halaman Tugas, batalkan tugas yang berada dalam status Processing.
- Temukan tugas yang ingin Anda kelola dan klik View di kolom Aksi. Di halaman detail tugas, lihat informasi tugas dan statistik tugas.
Tab Deskripsi Task Information Anda dapat melihat informasi tugas, memodifikasi deskripsi tugas dan konfigurasi tugas, serta mengunduh file aturan. Task Summary Anda dapat melihat statistik sub-tugas berdasarkan status. - Temukan perangkat yang ingin Anda kelola dan klik View untuk masuk ke halaman device details.
- Di tab Task, Anda dapat melihat semua tugas perangkat.
- Di tab Device Log, klik View. Di halaman Log Perangkat, klik Cloud run log. Di tab Log run cloud, pilih Cloud-to-device Message dari daftar drop-down tipe beban kerja di bilah pencarian untuk melihat log terkait tugas.
- Jika sub-tugas gagal dieksekusi, klik Execution details di kolom Aksi untuk melihat penyebab kegagalan.
- Jika sub-tugas habis waktu atau gagal dieksekusi, klik Timed Out atau Failed di kolom Status untuk melihat sub-tugas dalam status yang sesuai.
Di bagian atas halaman Tugas, klik Rerun untuk mengeksekusi ulang sub-tugas yang berada dalam status Timed Out dan Gagal dari tugas saat ini.
- Temukan perangkat yang ingin Anda kelola dan klik View untuk masuk ke halaman device details.
- Klik Delete di kolom Aksi tugas. Di pesan yang muncul, klik OK. Peringatan Setelah Anda menghapus tugas, semua data yang terkait dengan tugas akan dihapus. Jika aplikasi bisnis berjalan berdasarkan tugas, aplikasi tersebut mungkin tidak tersedia dan bisnis Anda mungkin terpengaruh. Lanjutkan dengan hati-hati.