IoT Platform:Membuat tugas panggilan layanan batch

Proses manajemen tugas

1. Buat tugas panggilan layanan batch.

   1. Di konsol IoT Platform, temukan instance yang ingin Anda kelola dan klik nama instance. Di panel navigasi sisi kiri halaman Detail Instance, pilih Maintenance > Tasks. Di halaman Tugas, klik Create Task.

   2. Di Create Task halaman, konfigurasikan parameter dalam langkah Buat Tugas dan Konfigurasi Tugas sesuai petunjuk, lalu klik Complete. Gerakkan pointer ke ikon di sebelah parameter untuk melihat informasi terkait. Tabel berikut menjelaskan parameter-parameter tersebut.

      • Buat Tugas

        Parameter	Deskripsi
        Nama Tugas	Tentukan nama valid untuk tugas. Anda dapat menentukan nama kustom.
        Tipe Tugas	Atur parameter menjadi Batch Service Call Task.
        Deskripsi Tugas	Tentukan informasi seperti tujuan dari tugas, yang dapat digunakan untuk mengidentifikasi tugas-tugas.
        Perangkat Tujuan, Produk, atau Grup	Pilih perangkat tempat Anda ingin mengeksekusi tugas. Anda dapat memilih perangkat terpisah, perangkat berdasarkan produk, atau perangkat berdasarkan grup. Penting Jika Anda memilih perangkat berdasarkan grup, Anda tidak dapat memilih grup dinamis.
        Aturan Eksekusi Tugas yang Diterbitkan ke Perangkat	Unggah file aturan. File harus dalam format JSON dan tidak boleh melebihi 64 KB ukurannya. Anda dapat mengklik Download Template untuk mendapatkan template aturan. Kode contoh berikut mendefinisikan layanan TSL bernama Data Computing, dengan identifier adalah Operation_Service, dengan parameter Invoke Method adalah Asynchronous, dan dengan parameter input adalah NumberA dan NumberB, yang merupakan tipe data int32: { "serviceIdentifier": "Operation_Service", "params": { "NumberA": 32, "NumberB": 56 } } serviceIdentifier: menentukan pengenal unik dari layanan. Untuk melihat pengenal layanan dari perangkat, buka tab Define Feature dari produk tempat perangkat tersebut milik di konsol IoT Platform. Jika layanan dengan pengenal Operation_Service termasuk dalam modul kustom bernama testFb, atur pasangan nilai-kunci menjadi "serviceIdentifier": "testFb:Operation_Service". Modul kustom ini bukan modul default. params: menentukan parameter input dari layanan. Anda dapat mengonfigurasi beberapa parameter input untuk params.

      • Konfigurasi Tugas

        Parameter	Deskripsi
        Laju Eksekusi Tugas	Tentukan jumlah kali Anda ingin mendorong tugas per menit berdasarkan kebutuhan bisnis Anda. Parameter ini wajib.
        Periode Waktu Habis Eksekusi Tugas	Parameter ini hanya tersedia untuk tugas kustom. Anda tidak perlu mengonfigurasi parameter ini.
        Waktu Penjadwalan Tugas	Parameter ini opsional. Sistem mengeksekusi tugas periode waktu tertentu setelah waktu yang Anda tentukan untuk parameter Waktu Penjadwalan Tugas. Setelah Anda membuat tugas, sistem memulai tugas tetapi tidak mengeksekusi tugas sampai waktu eksekusi tercapai.

2. Setelah Anda membuat tugas, IoT Platform memanggil operasi InvokeThingService atau InvokeThingsService untuk memanggil layanan dan mendorong permintaan secara asinkron ke perangkat yang ditentukan. Kemudian, perangkat mengembalikan respons secara asinkron ke IoT Platform.

   Contoh pesan:

   {
       "id": "123",
       "version": "1.0",
       "params": {
           "Power": "on",
           "WF": "2"
       },
       "method": "thing.service.${tsl.service.identifier}"
   }

   params berisi data yang sama dengan params di file aturan. {tsl.service.identifier} berisi nilai yang sama dengan serviceIdentifier di file aturan. Dalam contoh ini, pesan berikut digunakan:

   {
     "id": "123",
     "version": "1.0",
     "params": {
       "NumberA": 32,
       "NumberB": 56
     },
     "method": "thing.service.Operation_Service"
   }

   Untuk informasi lebih lanjut tentang catatan penggunaan yang sesuai dalam protokol Alink, lihat Memanggil layanan perangkat dalam mode asinkron.

3. Di konsol IoT Platform, temukan instance tempat tugas tersebut milik dan klik nama instance. Di halaman Detail Instance, pilih Maintenance > Tasks. Di halaman Tugas, Anda dapat melihat detail yang relevan, termasuk status tugas yang Anda buat.
   Penting Jika tugas berada dalam status Timed Out, tugas tersebut tidak dapat lagi dieksekusi berdasarkan jadwal yang ditentukan.

   Jika sub-tugas dari suatu tugas gagal dieksekusi dalam waktu tujuh hari setelah waktu pembuatan tugas, tugas tersebut masuk ke 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 menuju ke halaman device details. Di tab Task, Anda dapat melihat semua tugas dari perangkat tersebut. Di tab Device Log, klik View. Di halaman Log Perangkat, klik Cloud run log. Di tab Log runtime cloud, pilih Cloud-to-device Message dari daftar drop-down jenis 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 Failed dari tugas saat ini.

   • Klik Delete di kolom Aksi suatu tugas. Di pesan yang muncul, klik OK.
     Peringatan Setelah Anda menghapus tugas, semua data yang terkait dengan tugas tersebut akan dihapus. Jika aplikasi bisnis berjalan berdasarkan tugas tersebut, aplikasi tersebut mungkin menjadi tidak tersedia dan bisnis Anda mungkin terpengaruh. Lanjutkan dengan hati-hati.