> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/id/guide/account/iot-logic/nodes/action-node.md).

# Aksi

## Ikhtisar teknis dan kapabilitas

{% columns %}
{% column width="58.333333333333336%" %}
**Aksi** node di IoT Logic memungkinkan kontrol perangkat otomatis dengan menjalankan perintah tertentu saat dipicu oleh aliran data masuk. Node ini mengubah pemantauan armada pasif menjadi sistem otomatisasi aktif, dengan menjalankan operasi penting seperti pengalihan output dan transmisi perintah GPRS.
{% endcolumn %}

{% column width="50%" %}

<figure><img src="/files/aaeba37e753d83fac4ff746b7f32ee6cda6c237d" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Meskipun node Aksi dapat menerima data dari jenis node apa pun, node tersebut paling sering dihubungkan ke [Logika](/docs/user/id/guide/account/iot-logic/nodes/logic-node.md) node yang mengevaluasi kondisi dan memicu tindakan hanya ketika kriteria tertentu terpenuhi, seperti ambang suhu, pergerakan tanpa izin, atau insiden pengemudian kasar.

{% hint style="info" %}
Laporan **Aksi** node dikonfigurasi secara terpisah untuk setiap aliran di UI platform Navixy. Setiap node dapat berisi beberapa tindakan yang dijalankan secara berurutan saat dipicu oleh data masuk.
{% endhint %}

<figure><img src="/files/bc2c2d31b77c4190a572e359837efe8e5a760e30" alt=""><figcaption></figcaption></figure>

### Cara kerja node Aksi

Saat data mencapai **Aksi** node, sistem mengidentifikasi perangkat yang menyediakan data masuk dan menjalankan tindakan yang dikonfigurasi hanya untuk perangkat tersebut. Untuk detail lengkap tentang urutan eksekusi dan penargetan, lihat [Eksekusi dan penargetan tindakan](#action-execution-and-targeting) di bawah.

{% hint style="info" %}
**Persyaratan konektivitas perangkat**: Tindakan dikirim hanya ke perangkat yang terkonfirmasi daring (yang menyediakan data terbaru), sehingga memastikan pengiriman perintah yang andal.
{% endhint %}

Setiap **Aksi** hasil pemicu node muncul di [Penganalisis Data](/docs/user/id/guide/account/iot-logic/data-stream-analyzer.md) sebagai atribut yang dinamai berdasarkan **ID node** (ditampilkan dalam dialog konfigurasi node, misalnya `action_1a2b3c4d`). Nilainya adalah `0` saat node belum dipicu dan `1` saat telah dipicu, sehingga Anda dapat mengonfirmasi eksekusi dan membedakan beberapa node Aksi dalam aliran yang sama.

### Integrasi arsitektur aliran

**Aksi** node berfungsi sebagai node terminal dalam arsitektur aliran, menerima pemicu dari node hulu tanpa meneruskan data. Kemampuan otomatisasi terintegrasi dengan sistem manajemen perangkat Navixy yang lebih luas melalui:

* **Otomatisasi bersyarat**: Integrasi dengan [Logika](/docs/user/id/guide/account/iot-logic/nodes/logic-node.md) node memungkinkan alur kerja IF-THEN yang canggih, dengan tindakan dijalankan hanya ketika kondisi tertentu tervalidasi
* **Kontrol perangkat waktu nyata**: Perintah ditransmisikan dalam hitungan detik setelah menerima pemicu, sehingga memastikan respons segera terhadap kondisi kritis
* **Koordinasi seluruh armada**: Saat terhubung ke beberapa sumber perangkat, tindakan dapat mengoordinasikan respons di seluruh grup kendaraan secara bersamaan
* **Penghormatan terhadap kemampuan perangkat**: Keterbatasan masing-masing perangkat dihormati; perintah yang tidak didukung diterima tetapi tidak dijalankan

## Opsi konfigurasi

{% columns %}
{% column valign="middle" %}
Mengonfigurasi sebuah **Aksi** node menentukan perintah apa yang dijalankan dan, secara opsional, perangkat tambahan mana yang menerima perintah yang sama.

Dialog konfigurasi diatur dalam dua tab:

* **Standar**: menentukan perintah yang akan dijalankan. Berfungsi secara independen, tanpa ketergantungan pada tab Lanjutan.
* **Lanjutan**: menentukan perangkat tambahan mana yang menerima perintah yang sama saat node dipicu. Opsional.
  {% endcolumn %}

{% column %}

<figure><img src="/files/e5ec9411844a32c3e7d7bbceeb845c2a48e36afa" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Mari lihat elemen yang digunakan node ini dan hal yang dapat Anda konfigurasi saat menggunakannya:

### Langkah konfigurasi

{% stepper %}
{% step %}

#### Tentukan Nama node

Masukkan nama deskriptif yang mengidentifikasi tindakan otomatis yang akan dilakukan node ini

1. Gunakan nama seperti "Respons Pendinginan Darurat" atau "Tindakan Peringatan Keamanan" agar jelas
2. Nama ini muncul dalam diagram aliran agar mudah diidentifikasi
   {% endstep %}

{% step %}

#### ID node (dibuat secara otomatis)

Di bawah kolom Nama, dialog menampilkan **ID node** (misalnya, `action_1a2b3c4d`). Kolom ini hanya-baca — Anda tidak dapat mengedit atau menetapkan nilainya.

1. ID dibuat secara otomatis saat node dibuat dan tetap sama selama masa pakai node
2. Gunakan untuk membedakan hasil node ini dari node Aksi lain di [Penganalisis Data](/docs/user/id/guide/account/iot-logic/data-stream-analyzer.md), yang muncul sebagai atribut yang menunjukkan `0` (tidak dipicu) atau `1` (dipicu)
   {% endstep %}

{% step %}

#### Pilih jenis tindakan

Pada **Standar** tab, pilih jenis respons otomatis dari menu tarik-turun

1. **Alihkan output**: Kontrol output perangkat dengan menyalakan atau mematikannya
2. **Kirim Perintah GPRS**: Transmisikan perintah khusus langsung ke perangkat
   {% endstep %}

{% step %}

#### Konfigurasikan parameter tindakan

Atur detail spesifik berdasarkan jenis tindakan yang dipilih:

<details>

<summary>Konfigurasi Alihkan output</summary>

<figure><img src="/files/604afa7fffc9af002ada5fbeff7173bdc9b68a34" alt=""><figcaption></figcaption></figure>

Saat mengonfigurasi tindakan Alihkan output:

* **Nomor output**: Pilih output perangkat yang akan dikontrol dari menu tarik-turun
  * Nomor output yang tersedia bergantung pada kemampuan perangkat spesifik Anda
  * Rujuk dokumentasi perangkat untuk memahami fungsi output
* **Tombol alih Nyala/Mati**: Tetapkan apakah tindakan mengalihkan output ke NYALA atau MATI
  * Gunakan tombol alih untuk memilih status yang diinginkan

</details>

<details>

<summary>Konfigurasi Kirim Perintah GPRS</summary>

<figure><img src="/files/20f52df9238ba1be780aeec6051b520aa5b07837" alt=""><figcaption></figcaption></figure>

Saat mengonfigurasi tindakan Perintah GPRS:

* **String perintah**: Masukkan teks perintah yang tepat untuk dikirim ke perangkat
  * Perintah harus sesuai dengan sintaks perintah yang didukung perangkat Anda
  * Baca dokumentasi perangkat untuk mengetahui perintah yang tersedia dan pemformatan yang tepat
  * Tidak ada batasan karakter dalam kolom masukan

</details>
{% endstep %}

{% step %}

#### Tambahkan tindakan tambahan (opsional)

Klik **Tambahkan tindakan** untuk membuat beberapa tindakan dalam node yang sama.

{% hint style="info" %}

* Perintah tindakan dikirim saat menerima paket data dari perangkat sesuai dengan konfigurasi aliran
* Perintah dijalankan secara berurutan sesuai urutan kemunculannya dalam konfigurasi
* Setiap tindakan dapat memiliki jenis yang berbeda (Alihkan output atau Perintah GPRS)
* Gunakan ikon tempat sampah untuk menghapus tindakan yang tidak diperlukan
  {% endhint %}
  {% endstep %}

{% step %}

#### Konfigurasikan pemetaan penerima (opsional)

Buka **Lanjutan** tab untuk menentukan perangkat tambahan mana yang menerima perintah yang sama saat node dipicu.

<figure><img src="/files/ddadccd1a1a655940c75a04749f51a376c727ef8" alt=""><figcaption></figcaption></figure>

1. Gunakan header **Perangkat sumber** menu tarik-turun untuk memilih perangkat yang data masuknya memicu node. Perangkat ini harus ada dalam **node Sumber Data**.
2. Gunakan header **Perangkat target** menu tarik-turun untuk memilih satu atau beberapa perangkat yang akan menerima perintah yang sama.
3. Klik **+ Pemetaan khusus** untuk menambahkan pasangan sumber-ke-target tambahan jika perangkat sumber yang berbeda harus meneruskan perintah ke kumpulan perangkat target yang berbeda.

{% hint style="info" %}
Tab Lanjutan bersifat opsional. Tanpanya, node berperilaku persis seperti sebelumnya — perintah dijalankan hanya untuk perangkat pemicu.
{% endhint %}
{% endstep %}

{% step %}

#### Simpan konfigurasi

Klik **Terapkan perubahan** untuk menyimpan konfigurasi node Anda
{% endstep %}
{% endstepper %}

{% hint style="danger" %}
**Catatan kompatibilitas perangkat:** Eksekusi tindakan bergantung pada kemampuan masing-masing perangkat. Pastikan perangkat Anda mendukung output atau perintah spesifik yang sedang Anda konfigurasi. Cari perintah yang didukung dalam sumber daya produsen seperti dokumentasi perangkat. Daftar perangkat yang didukung tersedia di [Perangkat terintegrasi Navixy](https://www.navixy.com/devices/).
{% endhint %}

## Eksekusi dan penargetan tindakan

Laporan **Aksi** node memberikan kontrol yang tepat atas waktu dan tempat perintah dijalankan, sehingga memastikan respons otomatisasi yang efisien dan tertarget.

### Urutan eksekusi

Saat dipicu, **Aksi** node mengikuti pola eksekusi ini:

1. **Penargetan perangkat**: Tindakan dikirim hanya ke perangkat yang menyediakan data dalam peristiwa pemicu saat ini
   1. Ini memastikan perintah hanya mencapai perangkat spesifik yang terlibat dalam kondisi tersebut
   2. Mencegah perintah yang tidak diperlukan ke perangkat yang tidak terdampak dalam armada
2. **Pemrosesan berurutan**: Beberapa tindakan dalam sebuah node dijalankan sesuai urutan konfigurasi dari atas ke bawah
   1. Setiap tindakan menyelesaikan transmisi sebelum tindakan berikutnya dimulai
   2. Total waktu eksekusi biasanya dalam hitungan detik setelah menerima pemicu
3. **Validasi perangkat**: Masing-masing perangkat memproses perintah yang diterima sesuai kemampuannya
   1. Perintah yang didukung segera dijalankan setelah diterima
   2. Perintah yang tidak didukung diterima tetapi diabaikan oleh perangkat
   3. Mekanisme keselamatan perangkat dapat mencegah perintah yang tidak sesuai (misalnya, mematikan mesin saat bergerak)

### Perilaku koneksi

**Integrasi node Logika**: Saat terhubung ke [Logika](/docs/user/id/guide/account/iot-logic/nodes/logic-node.md) node, tindakan dijalankan hanya untuk perangkat yang kondisi logisnya dievaluasi sebagai `benar`. Ini menyediakan otomatisasi bersyarat yang tepat.

**Koneksi langsung**: Saat terhubung langsung ke jenis node lain (Sumber Data, Inisiasi Atribut), tindakan dijalankan untuk semua perangkat dalam aliran data setiap kali data diterima.

## Pertanyaan yang sering diajukan

#### Bagaimana cara mengetahui apakah tindakan saya berhasil dijalankan?

Periksa [Penganalisis Data](/docs/user/id/guide/account/iot-logic/data-stream-analyzer.md): pilih perangkat pemicu dan cari atribut yang cocok dengan ID node ini. Lihat [Cara kerja node Aksi](#how-device-action-nodes-work) untuk detailnya.

Perintah dikirim ke perangkat yang terkonfirmasi daring (yang menyediakan data terbaru), tanpa jeda waktu eksekusi antara pemicu dan pengiriman. Hal ini menghilangkan kemungkinan perangkat luring antara pemicu dan eksekusi.

#### Dapatkah saya menghubungkan beberapa node ke node Aksi yang sama?

Ya. Node Aksi dapat menerima pemicu dari beberapa node hulu, tetapi perhatikan bahwa tindakan akan dijalankan untuk perangkat apa pun yang memicu node terhubung mana pun. Saat merancang aliran yang kompleks, pertimbangkan efek kumulatif dari beberapa sumber pemicu untuk memastikan tindakan hanya dijalankan untuk skenario yang dimaksudkan. Untuk mengonfirmasi bahwa node hanya aktif dalam skenario yang Anda maksudkan, pantau atribut ID nodenya di [Penganalisis Data](/docs/user/id/guide/account/iot-logic/data-stream-analyzer.md): atribut tersebut menampilkan `1` pada setiap pemicu dan `0` jika tidak.

#### Apa yang terjadi jika saya menghubungkan node Aksi langsung ke Sumber Data?

Node Aksi akan menjalankan tindakan yang dikonfigurasinya setiap kali perangkat apa pun dalam Sumber Data mengirim data. Hal ini menciptakan eksekusi tindakan berkelanjutan, bukan respons bersyarat. Untuk sebagian besar kasus penggunaan, menghubungkan node Aksi ke [Logika](/docs/user/id/guide/account/iot-logic/nodes/logic-node.md) node memberikan kontrol yang lebih baik atas waktu tindakan harus dijalankan.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/user/id/guide/account/iot-logic/nodes/action-node.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.