IoT Platform:Tambahkan tugas pengaturan properti batch

Alur Kerja

1. Buat tugas pengaturan properti batch.
   1. Di IoT Platform console, buka instans Anda. Di panel navigasi kiri, pilih Maintenance > Tasks. Pada halaman Tasks, klik Create Task.
   2. Pada halaman Create Task, konfigurasikan tugas dan sub-tugas. Anda dapat mengklik ikon bantuan di samping nama parameter untuk informasi lebih lanjut.
      • Konfigurasi tugas

        Parameter	Deskripsi
        Task Name	Masukkan nama kustom untuk tugas yang sesuai dengan konvensi penamaan.
        Task Type	Pilih Batch Property Setting Task.
        Task Description	Masukkan deskripsi, misalnya tujuan tugas tersebut. Hal ini membantu Anda membedakan berbagai tugas.
        Target Device, Product, or Group	Pilih perangkat target untuk tugas tersebut. Anda dapat memilih berdasarkan perangkat, produk, atau kelompok. Penting Jika Anda memilih perangkat berdasarkan kelompok, Anda tidak dapat memilih kelompok dinamis.
        Task Execution Rules for Devices	Unggah file aturan dalam format .json. Ukuran file tidak boleh melebihi 64 KB. Anda dapat mengklik Download Template untuk mendapatkan templat file aturan. Sebagai contoh, properti model TSL suatu produk adalah Temperature. identifier-nya adalah temperature, dan data type-nya adalah double. Kode berikut memberikan contohnya: { "params": { "temperature": 30.5 } } params: parameter untuk mengatur properti. Beberapa properti dapat disertakan. temperature dan 30.5: identifier properti dan nilainya. Anda dapat melihat identifier properti tersebut pada tab Define Feature produk di IoT Platform console. Untuk properti temperature di bawah modul kustom testFb (bukan modul default), parameternya adalah "testFb:temperature":30.5.

      • Konfigurasi sub-tugas

        Parameter	Deskripsi
        Sub-task Execution Rate	Tentukan jumlah sub-tugas yang akan didorong per menit. Parameter ini wajib diisi.
        Sub-task Execution Timeout	Parameter ini hanya berlaku untuk tugas kustom. Anda tidak perlu mengonfigurasinya.
        Sub-task Start Time	Parameter ini opsional. Waktu bersifat relatif terhadap saat Anda mengonfigurasi pengaturan ini. Setelah tugas dibuat, tugas tersebut diinisialisasi dan menunggu waktu terjadwal untuk dimulai.

   3. Klik Complete.
2. Setelah tugas dibuat, IoT Platform memanggil operasi API SetDeviceProperty atau SetDevicesProperty untuk mengirim perintah pengaturan properti ke perangkat. Perangkat kemudian mengembalikan respons ke IoT Platform.

   Format data (mobile terminated)	Topik request dan respons
   Pass-through/custom	Topik request: /sys/${productKey}/${deviceName}/thing/model/down_raw Topik respons: /sys/${productKey}/${deviceName}/thing/model/down_raw_reply
   Alink JSON	Topik request: /sys/${productKey}/${deviceName}/thing/service/property/set Topik respons: /sys/${productKey}/${deviceName}/thing/service/property/set_reply

   Kode berikut menunjukkan contoh pesan:

   {
       "id": "123",
       "version": "1.0",
       "params": {
           "temperature": "30.5"
       },
       "method": "thing.service.property.set"
   }

   Bidang params berisi data yang sama dengan bidang params dalam file aturan tugas.

   Untuk informasi selengkapnya tentang protokol Alink untuk mengatur properti perangkat, lihat Atur properti perangkat.

3. Di halaman Maintenance > Tasks untuk instans Anda, lihat tugas yang telah dibuat beserta status terkininya.
   Penting Tugas dengan status timed out tidak dapat dijadwalkan untuk dieksekusi lagi.

   Pengatur waktu dimulai saat tugas dibuat. Jika tidak semua sub-tugas selesai dalam waktu tujuh hari, status tugas berubah menjadi timed out.

   Anda dapat melakukan operasi berikut:

   • Membatalkan tugas yang berada dalam status processing.
   • Klik View di samping tugas untuk membuka halaman detailnya, tempat Anda dapat melihat informasi tugas dan statistik eksekusi sub-tugas.

     Tab	Deskripsi
     Task Information	Anda dapat melihat informasi tugas, mengubah deskripsi tugas dan konfigurasi sub-tugas, serta mengunduh file tugas perangkat.
     Task Summary	Anda dapat melihat statistik sub-tugas yang dikelompokkan berdasarkan status. Klik View di samping perangkat untuk membuka halaman Device Details-nya: Di tab Task, lihat daftar semua tugas untuk perangkat tersebut. Di tab Device Log, klik Go to View. Di tab cloud run log, pilih cloud-to-device message dari daftar drop-down workload type untuk melihat log tugas perangkat. Jika sub-tugas gagal, klik Execution Details untuk melihat penyebab kegagalannya. Jika sub-tugas berada dalam status timed out atau failed, klik tombol status yang sesuai untuk melihat daftar sub-tugas dalam status tersebut. Anda dapat mengklik Rerun di atas daftar untuk mengeksekusi ulang semua sub-tugas yang timed out atau gagal untuk tugas saat ini.

   • Klik Delete di samping tugas target, lalu klik OK.
     Peringatan Setelah Anda menghapus tugas perangkat, semua data terkait akan dihapus. Jika ada layanan yang bergantung pada tugas ini, layanan tersebut mungkin menjadi tidak tersedia atau bisnis Anda terganggu. Lakukan dengan hati-hati.