> 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/initiate-attribute-node.md).

# Inisiasi Atribut

Buat atribut data baru dari telemetri yang masuk menggunakan Bahasa Ekspresi Navixy. Ganti nama parameter, terapkan rumus, dan perkaya data sebelum meneruskan.

## Ikhtisar teknis dan kemampuan

{% columns %}
{% column %}
Di IoT Logic, **Inisiasi Atribut** node mengubah pembacaan perangkat dengan membuat atribut data baru berdasarkan telemetri masuk. Node ini memungkinkan Anda memanipulasi data melalui rumus matematika, mengganti nama parameter yang ada, dan melakukan operasi tingkat bit menggunakan [Bahasa Ekspresi Navixy](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md). Node ini berfungsi sebagai komponen kunci dalam aliran, memungkinkan Anda memperkaya data sebelum mengirimkannya ke sistem tujuan Anda.
{% endcolumn %}

{% column %}
![](https://3001559198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-7e96978455ec9e7da74b1a6f2224ad0d7fcf15e0%2Fiot-logic-initiate-attribute-tile.png?alt=media)
{% endcolumn %}
{% endcolumns %}

**Inisiasi Atribut** node dikonfigurasi untuk setiap aliran di antarmuka platform Navixy. Untuk opsi sintaks tertentu dan referensi lengkap bahasa ekspresi, lihat [Bahasa Ekspresi Navixy](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) di dokumentasi pengguna.

<figure><img src="https://3001559198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-65ef89cf366fb6c4e53d07f6aa05c617d0e3d1e1%2Fiot-logic-initiate-attribute-in-flow.png?alt=media" alt="Initiate attribute node in the flow workspace showing the node connected to other nodes in the flow"><figcaption></figcaption></figure>

### Integrasi arsitektur aliran

**Inisiasi Atribut** node berfungsi dalam arsitektur aliran dengan menyediakan kemampuan transformasi data dan memungkinkan:

* Memproses data telemetri mentah menjadi metrik bisnis yang bermakna
* Membuat kolom terhitung berdasarkan beberapa nilai parameter
* Mengonversi satuan pengukuran (misalnya, kilometer ke mil)
* Menghitung selisih antara pembacaan saat ini dan sebelumnya
* Menghasilkan analitik berbasis waktu atas perilaku perangkat

{% hint style="info" %}
Node Inisiasi Atribut memerlukan setidaknya satu **Sumber Data** node yang terhubung ke node tersebut. Tidak ada perhitungan yang akan dilakukan tanpa koneksi data masukan.
{% endhint %}

### Kemampuan node

Node **Inisiasi Atribut** itu sendiri menawarkan:

* **Transformasi atribut data**: Buat atribut yang sepenuhnya baru dengan menerapkan operasi matematika pada atribut yang berasal dari sumber data
* **Konversi unit**: Konversi satuan pengukuran (misalnya, kecepatan dari *km/h* ke *mph*, atau suhu dari *°C* ke *°F*)
* **Perhitungan berbasis waktu**: Bandingkan pembacaan saat ini dengan nilai sebelumnya untuk menentukan perubahan
* **Manipulasi waktu**: Sesuaikan stempel waktu saat atribut dihasilkan di perangkat dan saat diterima oleh server untuk menghindari ketidakkonsistenan waktu dan menyatukan format waktu
* **Pencarian perimeter**: Tulis nama perimeter tempat perangkat berada ke dalam atribut dengan `geofenceName()`, opsi berbayar. Lihat [Fungsi perimeter](/docs/user/id/guide/account/iot-logic/nodes/geofence-functions.md)

## Opsi konfigurasi

{% columns %}
{% column valign="middle" %}
**Inisiasi Atribut** node memungkinkan Anda menentukan bagaimana parameter perangkat diubah menjadi atribut, yang akan tersedia untuk pemrosesan lebih lanjut dalam aliran data Anda.
{% endcolumn %}

{% column %}

<figure><img src="https://3001559198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-1d6dbc91c7863368a349129f700135f56c46e5cb%2FInitiate_Attribute_node_edit.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

Mari kita lihat elemen yang digunakan node ini dan apa yang dapat Anda konfigurasikan saat bekerja dengannya:

### Langkah konfigurasi

{% stepper %}
{% step %}

#### Tentukan nama node

Masukkan nama deskriptif untuk menyoroti tujuan node. Gunakan nama yang membantu Anda mengidentifikasi perhitungan yang akan dilakukan di dalam node ini; nama tersebut akan ditampilkan di diagram aliran agar mudah dikenali.
{% endstep %}

{% step %}

#### Tentukan nama atribut

Tambahkan pengenal unik untuk atribut.

* Nama ini akan ditampilkan di [Penganalisis Data](/docs/user/id/guide/account/iot-logic/data-stream-analyzer.md),
* Anda juga dapat menggunakan nama ini untuk membuat sensor kustom di [modul Tracking](/docs/user/id/guide/tracking.md) . Untuk melakukannya, node **Inisiasi Atribut** yang memuat atribut ini harus terhubung ke sebuah **Titik Akhir Output** node yang disetel ke **Titik akhir default** mode.
  {% endstep %}

{% step %}

#### Tentukan rumus

Tambahkan ekspresi matematika untuk menghitung nilai atribut.

* Gunakan `value('parameter_name' 0, 'valid')` format untuk mereferensikan parameter perangkat yang ada.\
  **Catatan**. Klik ![image-20250605-115154.png](https://3001559198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3ae9e98cb2dff10c13a5b062c8b6c161b9b038df%2Fimage-20250605-115154.png?alt=media) di dalam **kolom Rumus** untuk membuka daftar atribut yang tersedia dan memilih yang diperlukan. Atribut tersebut akan ditambahkan ke kolom secara otomatis dalam format siap pakai. Untuk detail tentang pengisian otomatis nama atribut, lihat [Isi otomatis nama atribut](/docs/user/id/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).
* Terapkan operasi matematika berdasarkan [Bahasa Ekspresi IoT Logic Navixy](/docs/iot-logic-api/technologies/navixy-iot-logic-expression-language.md) untuk mengubah nilai.
* Gunakan nilai indeks kedalaman yang berbeda untuk mengakses nilai historis (bawaan adalah 0).
* Tangani nilai yang mungkin hilang. Jika nilai yang dibutuhkan rumus tidak ada, rumus tidak menghasilkan apa pun, dan atribut kemudian tidak memiliki nilai untuk paket tersebut. Lihat [Nilai yang hilang dalam ekspresi](/docs/user/id/guide/account/iot-logic/nodes/missing-values-in-expressions.md).
  {% endstep %}

{% step %}

#### (opsional) Tambahkan atribut lain

Klik **Tambah atribut** untuk membuka dialog konfigurasi atribut baru. Di sini Anda dapat membuat atribut data baru jika Anda memerlukan beberapa perhitungan dilakukan dalam node yang sama.
{% endstep %}

{% step %}

#### Simpan konfigurasi node

Klik **Terapkan perubahan** untuk menyelesaikan pembuatan node.
{% endstep %}
{% endstepper %}

Mari kita lihat contoh praktis konfigurasi atribut:

{% columns %}
{% column valign="middle" %}
Contoh ini membuat atribut yang mengonversi kecepatan dari kilometer ke mil per jam dengan membagi parameter kecepatan CAN dengan 1,609.

Untuk detail tentang perhitungan atribut baru, lihat [Contoh perhitungan](/docs/user/id/guide/account/iot-logic/nodes/initiate-attribute-node/calculation-examples.md).

Selain itu, Anda dapat menemukan contoh terperinci penggunaan atribut terhitung dalam aliran di [Contoh konfigurasi aliran → langkah 3 dan 4](/docs/user/id/guide/account/iot-logic/flow-management/flow-configuration-example.md#flow-configuration-steps).
{% endcolumn %}

{% column %}

<figure><img src="https://3001559198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-ff0ba6cd28d37a00e2036a38e7dddc67526114b8%2FIitiate_Attribute_example.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}
{% endcolumns %}

## Opsi tampilan

Atribut baru yang dihitung di dalam **Inisiasi Atribut** node dapat dipantau seperti atribut data aktual yang berasal dari perangkat di **Penganalisis Data (DSA)** dan **modul Tracking** modul tersebut.

Untuk informasi lebih lanjut tentang opsi tampilan, lihat [Menampilkan atribut terhitung baru di platform Navixy](/docs/user/id/guide/account/iot-logic/nodes/initiate-attribute-node/displaying-new-calculated-attributes-on-the-navixy-platform.md).

## Pertimbangan aliran data

Setelah mengonfigurasi **Inisiasi Atribut** node Anda, pastikan untuk:

1. Hubungkan node ke setidaknya satu **Sumber Data** node sebagai input
2. Hubungkan output ke sebuah **Titik Akhir Output** node untuk mengirim data yang telah diubah

Di dalam **Inisiasi Atribut** node, nilai parameter diproses sesuai ekspresi Anda setiap kali perangkat menyediakan data. Pada output, Anda akan menerima:

* Semua parameter perangkat asli
* Semua atribut terhitung beserta nilainya
* Nilai waktu pembuatan dan waktu server yang diperbarui sesuai konfigurasi

Jika Anda menggunakan nama yang sama untuk atribut terhitung dan parameter yang sudah ada, atribut tersebut menggantikan parameter asli dalam paket data keluaran.

Atribut yang rumusnya tidak dapat dihitung tidak memiliki nilai untuk paket tersebut. Tidak ada yang menandainya sebagai error. Jika atribut menggunakan nama yang sama dengan parameter perangkat, nilai parameter asli tetap berada dalam paket, sehingga paket tampak normal dan perhitungannya gagal dilakukan tanpa pemberitahuan. Lihat [Nilai yang hilang dalam ekspresi](/docs/user/id/guide/account/iot-logic/nodes/missing-values-in-expressions.md).

## Pertanyaan yang sering diajukan

#### Dapatkah saya mereferensikan nilai selain yang terbaru dalam perhitungan saya?

Ya. Gunakan parameter indeks pada fungsi value untuk mengakses nilai historis. Misalnya, `value('temperature', 1, 'valid')` merujuk pada nilai valid sebelumnya dari parameter temperature.

#### Bagaimana saya melakukan perhitungan yang melibatkan waktu?

Gunakan `genTime()` dan `srvTime()` fungsi untuk bekerja dengan stempel waktu. Anda dapat menghitung selisih waktu, menambahkan offset waktu, atau memformat stempel waktu untuk ditampilkan.

#### Apa yang terjadi jika saya menghapus atribut?

Atribut tidak lagi dihitung untuk data yang baru diterima, tetapi data historis tetap tidak berubah. Atribut tersebut tidak akan muncul dalam paket data baru apa pun setelah dihapus.

#### Dapatkah saya menggunakan atribut yang dibuat dalam satu node Inisiasi Atribut di node lain?

Ya. Atribut yang dibuat lebih awal dalam aliran dapat direferensikan di node berikutnya, sehingga memungkinkan perhitungan bertahap. Semua atribut yang dibuat juga tersedia menggunakan **Inisiasi Atribut** fitur isi otomatis [untuk memastikan penamaan yang benar.](/docs/user/id/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names) Bagaimana cara menghindari salah ketik saat mereferensikan nama atribut dalam rumus?

<figure><img src="https://3001559198-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-283b0e91f8050910026eb2295c18845b6d485b20%2Fiot-logic-initiate-attribute-chained.png?alt=media" alt="Example of a complete flow with two Initiate attribute nodes consecutively"><figcaption></figcaption></figure>

#### Gunakan fitur isi otomatis di kolom Rumus untuk memilih dari atribut yang tersedia. Untuk petunjuk terperinci, lihat

Mengapa salah satu atribut terhitung saya kadang hilang? [Isi otomatis nama atribut](/docs/user/id/guide/account/iot-logic/nodes/initiate-attribute-node/managing-attributes.md#autofill-attribute-names).

#### Rumus tidak dapat dihitung untuk paket tersebut, paling sering karena nilai yang dibacanya tidak ada di dalam paket. Atribut tersebut kemudian tidak memiliki nilai, dan tidak ada error yang dilaporkan. Lihat

&#x20; [Nilai yang hilang dalam ekspresi](/docs/user/id/guide/account/iot-logic/nodes/missing-values-in-expressions.md).


---

# 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/initiate-attribute-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.
