All Products
Search
Document Center

Link IoT Edge:Orkestrasi adegan di cloud

Last Updated:Dec 09, 2025

Aturan orkestrasi adegan memungkinkan Anda mengotomatiskan alur kerja berdasarkan logika bisnis yang ditentukan secara visual. Anda dapat mengonfigurasi pemicu dan kondisi berbasis waktu atau perangkat untuk aturan tersebut. Aturan ini dapat menjalankan tindakan yang mengubah status aturan lainnya, perangkat, atau fungsi, sehingga memungkinkan Anda menerapkan orkestrasi adegan pada sejumlah besar perangkat.

Prasyarat

Instans edge telah dibuat. Untuk informasi lebih lanjut, lihat Mengatur Lingkungan.

Membuat aturan adegan

  1. Masuk ke Konsol IoT Platform.

  2. Di panel navigasi sisi kiri, pilih Message Forwarding > Scene Orchestration.

  3. Klik Create Rule. Scene orchestration

  4. Konfigurasikan parameter dan klik OK. Tabel berikut menjelaskan parameter-parameter tersebut.

    Parameter

    Deskripsi

    Nama Aturan

    Nama aturan. Nama harus terdiri dari 1 hingga 30 karakter, dan dapat berisi huruf, angka, garis bawah (_), dan tanda hubung (-).

    Deskripsi Aturan

    Opsional. Deskripsi aturan.

  5. Setelah aturan adegan dibuat, klik Edit di pesan yang muncul untuk mengonfigurasi aturan.

    Anda juga dapat mengonfigurasi aturan adegan dengan mengklik View di sebelah kanan nama aturan.

    Sebagai contoh, Anda dapat menggunakan aturan adegan untuk mengotomatiskan pendingin ruangan. Ketika suhu dalam ruangan yang dilaporkan oleh sensor suhu antara pukul 12:00 dan 23:59 lebih rendah dari 16°C, pendingin ruangan secara otomatis menaikkan suhu menjadi 26°C.

    Gambar berikut menunjukkan konfigurasi parameter.

    Configure scene orchestration parameters

    Di pojok kanan atas halaman yang muncul, klik Edit untuk mengubah nama aturan adegan. Untuk informasi lebih lanjut tentang parameter lainnya, lihat tabel berikut.

    Parameter

    Deskripsi

    Pemicu

    Pemicu yang memicu aturan. Nilai valid: Device Trigger dan Timed Trigger. Ketika data perangkat yang dilaporkan atau waktu saat ini memenuhi pemicu, sistem memeriksa apakah kondisi pemicu aturan terpenuhi. Anda dapat membuat satu atau lebih pemicu untuk sebuah aturan. Pemicu-pemicu tersebut dihubungkan oleh operator OR logis.

    • Jika Anda mengatur parameter ini ke Device Trigger, Anda harus memilih produk yang ada, satu atau semua perangkat, dan satu atau semua properti atau satu atau semua kejadian.

    • Jika Anda mengatur parameter ini ke Timed Trigger, Anda harus menentukan titik waktu tertentu. Titik waktu tersebut harus ditentukan menggunakan ekspresi CRON. Ekspresi CRON terdiri dari lima bidang berikut: menit, jam, hari, bulan, dan hari dalam seminggu. Untuk hari dalam seminggu, nilai 0 atau 7 menunjukkan Minggu dan nilai dari 1 hingga 6 menunjukkan Senin hingga Sabtu. Pisahkan bidang-bidang ini dengan spasi. Sebagai contoh, Anda dapat menulis ekspresi CRON untuk memicu aturan pada pukul 18:00:00 setiap hari dalam format 0 18 * * *. Anda juga dapat menulis ekspresi CRON untuk memicu aturan pada pukul 18:00:00 setiap Jumat dalam format 0 18 * * 5. Tanda bintang (*) adalah karakter wildcard. Untuk informasi lebih lanjut tentang cara menulis ekspresi CRON, lihat CRONTAB.

      Dalam contoh sebelumnya, parameter ini diatur ke Device Trigger. Dalam hal ini, pemicu merujuk pada skenario di mana suhu dalam ruangan yang dilaporkan oleh sensor suhu lebih rendah dari 16°C.

    Kondisi

    Kondisi-kondisi. Aturan hanya dipicu jika data memenuhi semua kondisi. Anda dapat mengatur parameter ini ke Device Status atau Time Range. Anda dapat mengonfigurasi satu atau lebih kondisi untuk sebuah aturan. Kondisi-kondisi tersebut dihubungkan oleh operator AND logis.

    • Jika Anda mengatur parameter ini ke Device Status, Anda harus memilih produk yang ada, perangkat dari produk tersebut, dan properti atau kejadian dari fitur perangkat.

    • Jika Anda mengatur parameter ini ke Time Range, Anda harus menentukan waktu mulai dan waktu akhir dalam format yyyy-mm-dd hh24:mi:ss.

    Dalam contoh sebelumnya, parameter ini diatur ke Time Range, dan aturan dapat dipicu antara pukul 12:00 dan 23:59.

    Tindakan

    Tindakan yang akan dilakukan. Anda dapat mengonfigurasi satu atau lebih tindakan. Ketika sebuah tindakan gagal, tindakan tersebut tidak memengaruhi tindakan lainnya.

    • Jika Anda mengatur parameter ini ke Device Output, Anda harus memilih produk yang ada, perangkat dari produk tersebut, dan properti atau layanan dari fitur perangkat. Hanya properti atau layanan yang dapat ditulis yang dapat dipilih untuk melakukan tindakan. IoT Platform melakukan tindakan-tindakan berdasarkan properti atau layanan perangkat yang telah ditentukan ketika pemicu dan kondisi aturan terpenuhi.

    • Jika Anda mengatur parameter ini ke Rule Output, Anda harus memilih aturan lain. Tindakan tersebut memanggil aturan yang dipilih. Pemicu dari aturan yang dipanggil dilewati dan hanya kondisi aturan yang diperiksa. Jika kondisi terpenuhi, tindakan-tindakan yang didefinisikan dalam aturan yang dipanggil dilakukan.

      Sebagai contoh, jika Aturan A dipicu, pemicu Aturan A dilewati. Kondisi Aturan A diperiksa. Jika semua kondisi Aturan A terpenuhi, IoT Platform melakukan tindakan-tindakan Aturan A. Kondisi-kondisi tersebut dihubungkan oleh operator AND logis.

    Dalam contoh sebelumnya, parameter ini diatur ke Device Output. Ketika aturan dipicu, pendingin ruangan menaikkan suhu menjadi 26°C.

    Eksekusi Tertunda

    Parameter ini ditampilkan setelah Anda menampilkan opsi lanjutan. Setelah Anda mengonfigurasi parameter ini, tindakan yang ditentukan dilakukan dalam periode waktu tertentu. Nilai valid: 0 hingga 86400. Unit: detik.

Memulai aturan adegan

Setelah aturan adegan dibuat, Anda dapat memulainya di halaman Scene Orchestration.

Untuk memulai aturan adegan, ikuti langkah-langkah berikut:

  1. Masuk ke Konsol IoT Platform. Di panel navigasi sisi kiri, pilih Message Forwarding > Scene Orchestration.

  2. Temukan aturan adegan yang ingin Anda mulai dan klik Start. Status aturan berubah menjadi Running.

    Start a scene rule

Setelah Anda memulai aturan:

  • Jika aturan adegan berjalan di cloud, Anda harus mengonfigurasi pengaturan rute pesan untuk perangkat-perangkat dari aturan adegan. Ini memungkinkan properti dan kejadian perangkat dikirim ke IoT Hub yang berjalan di cloud. Untuk informasi lebih lanjut tentang cara mengonfigurasi rute pesan, lihat Mengonfigurasi Rute Pesan.

  • Jika aturan adegan berjalan di edge, Anda harus stop running aturan adegan di cloud dan menetapkan aturan adegan ke instans edge. Untuk informasi lebih lanjut, lihat Operasi Lainnya untuk Orkestrasi Adegan.

Melihat log

Anda dapat melihat log aturan adegan dan hasilnya di halaman detail.

Catatan

Aturan adegan dapat berjalan di cloud dan di edge secara bersamaan. Untuk melihat semua log aturan adegan, ikuti langkah-langkah berikut: Masuk ke Konsol IoT Platform dan pilih Message Forwarding > Scene Orchestration.

  1. Di panel navigasi sisi kiri Konsol IoT Platform, pilih Message Forwarding > Scene Orchestration.

  2. Temukan aturan adegan yang ingin Anda lihat dan klik Log di sebelah kanan.

  3. Klik Details untuk melihat detail log.

    log

    Catatan

    Jika log berada dalam status Gagal, Anda dapat mengklik Details di kolom Tindakan untuk melihat detail kegagalan eksekusi.

Operasi lainnya untuk orkestrasi adegan

  • Hapus aturan adegan:

    1. Di halaman Scene Orchestration, temukan aturan yang ingin Anda hapus.

    2. Klik Delete di sebelah kanan nama aturan. Di pesan yang muncul, klik OK untuk menghapus aturan adegan.

  • Picu aturan adegan:

    Setelah Anda memulai aturan adegan, Anda dapat memicu aturan tersebut.

    1. Di halaman Scene Orchestration, temukan aturan yang ingin Anda picu.

    2. Klik Trigger di sebelah kanan nama aturan. Aturan dipicu sekali. Semua tindakan dari aturan dilakukan tanpa memperhatikan pemicu yang ditentukan.

  • Jalankan aturan adegan pada instans edge:

    Untuk menerapkan aturan adegan pada instans edge, ikuti langkah-langkah berikut:

    Penting

    Pastikan bahwa Anda telah menghentikan aturan adegan di cloud.

    1. Masuk ke Konsol Link IoT Edge. Di panel navigasi sisi kiri, klik Edge Instances. Temukan instans edge yang Anda buat dan klik View di kolom Tindakan.

    2. Pada halaman Instance Details, klik tab Scenes, lalu klik Assign Scene.

    3. Di panel Assign Scene, klik Assign di sebelah kanan nama aturan. Lalu, klik Close. Assign the scene rule to an edge instance

    4. Setelah aturan adegan ditetapkan, terapkan ulang instans edge.