Inisiasi Atribut

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

Ikhtisar teknis dan kemampuan

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. Node ini berperan sebagai komponen kunci dalam aliran, memungkinkan Anda memperkaya data sebelum mengirimkannya ke sistem target Anda.

Inisiasi Atribut node dikonfigurasi untuk setiap aliran di UI platform Navixy. Untuk opsi sintaks tertentu dan referensi bahasa ekspresi yang terperinci, lihat Bahasa Ekspresi Navixy dalam dokumentasi pengguna.

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 bidang terhitung berdasarkan beberapa nilai parameter

• Mengonversi satuan ukuran (misalnya, kilometer ke mil)

• Menghitung selisih antara pembacaan saat ini dan sebelumnya

• Menghasilkan analitik berbasis waktu tentang perilaku perangkat

Node Inisiasi Atribut memerlukan setidaknya satu Sumber Data node untuk dihubungkan ke node tersebut. Tidak ada perhitungan yang akan dilakukan tanpa koneksi data masukan.

Kemampuan node

Blok Inisiasi Atribut Node itu sendiri menawarkan:

• Transformasi atribut data: Buat atribut yang sepenuhnya baru dengan menerapkan operasi matematika pada atribut yang berasal dari sumber data

• Konversi satuan: Ubah satuan ukuran (misalnya, kecepatan dari km/jam 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 dibuat 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

Opsi konfigurasi

Inisiasi Atribut node memungkinkan Anda menentukan bagaimana parameter perangkat diubah menjadi atribut, yang akan tersedia untuk pemrosesan lebih lanjut dalam aliran data Anda.

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

Langkah konfigurasi

1

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 itu akan ditampilkan dalam diagram aliran agar mudah dikenali.

2

Tentukan nama atribut

Tambahkan pengenal khas atribut.

• Nama ini akan ditampilkan di Penganalisis Data,

• Anda juga dapat menggunakan nama ini untuk membuat sensor kustom di Pelacakan modul. Untuk melakukannya, Inisiasi Atribut node yang berisi atribut ini harus dihubungkan ke sebuah Titik Akhir Output node yang disetel ke Titik akhir default mode.

3

Definisikan rumus

Tambahkan ekspresi matematika untuk menghitung nilai atribut.

• Gunakan value('parameter_name' 0, 'valid') format untuk mereferensikan parameter perangkat yang ada. Catatan. Klik di dalam Rumus bidang untuk membuka daftar atribut yang tersedia dan memilih yang diperlukan. Atribut itu akan ditambahkan ke bidang secara otomatis dalam format siap pakai. Untuk detail tentang pengisian otomatis nama atribut, lihat Pengisian otomatis nama atribut.

• Terapkan operasi matematika berdasarkan Bahasa Ekspresi IoT Logic Navixy untuk mengubah nilai.

• Gunakan nilai indeks kedalaman yang berbeda untuk mengakses nilai historis (nilai bawaan adalah 0).

• Tangani nilai yang mungkin hilang. Jika suatu nilai yang dibutuhkan rumus tidak ada, rumus tidak menghasilkan apa-apa, dan atribut kemudian tidak memiliki nilai untuk paket itu. Lihat Nilai yang hilang dalam ekspresi.

4

(opsional) Tambahkan atribut lainnya

Klik Tambah Atribut untuk membuka dialog konfigurasi atribut baru. Di sini Anda dapat membuat atribut data baru jika Anda memerlukan beberapa perhitungan dilakukan di dalam node yang sama.

5

Simpan konfigurasi node

Klik Terapkan perubahan untuk menyelesaikan pembuatan node.

Mari kita lihat contoh praktis konfigurasi atribut:

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 untuk atribut baru, lihat Contoh perhitungan.

Selain itu, Anda dapat menemukan contoh terperinci penggunaan atribut terhitung dalam aliran di Contoh konfigurasi aliran → langkah 3 dan 4.

Opsi tampilan

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

Untuk informasi selengkapnya tentang opsi tampilan, lihat Menampilkan atribut terhitung baru di platform Navixy.

Pertimbangan aliran data

Setelah mengonfigurasi Inisiasi Atribut node Anda, pastikan untuk:

1. Hubungkan node ke setidaknya satu Sumber Data node sebagai masukan

2. Hubungkan keluaran 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 seperti parameter yang sudah ada, atribut tersebut menggantikan parameter asli dalam paket data keluaran.

Atribut yang rumusnya tidak dapat dihitung tidak memiliki nilai untuk paket itu. Tidak ada yang menandainya sebagai kesalahan. Jika atribut menggunakan nama yang sama dengan parameter perangkat, nilai parameter asli tetap ada dalam paket sebagai gantinya, sehingga paket tampak normal dan perhitungan tidak terjadi tanpa pemberitahuan. Lihat Nilai yang hilang dalam ekspresi.

Pertanyaan yang sering diajukan

Bisakah saya mereferensikan nilai yang bukan nilai terbaru dalam perhitungan saya?

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

Bagaimana cara melakukan perhitungan yang melibatkan waktu?

Gunakan genTime() dan srvTime() 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 muncul dalam paket data baru apa pun setelah penghapusan.

Bisakah saya menggunakan atribut yang dibuat di satu node Inisiasi Atribut di node lainnya?

Ya. Atribut yang dibuat lebih awal dalam aliran dapat direferensikan dalam Inisiasi Atribut node berikutnya, sehingga memungkinkan perhitungan bertahap. Semua atribut yang dibuat juga tersedia menggunakan fitur pengisian otomatis untuk memastikan penamaan yang benar.

Bagaimana cara menghindari salah ketik saat mereferensikan nama atribut dalam rumus?

Gunakan fitur pengisian otomatis di bidang Formula untuk memilih dari atribut yang tersedia. Untuk petunjuk terperinci, lihat Pengisian otomatis nama atribut.

Mengapa salah satu atribut terhitung saya terkadang hilang?

Rumus tidak dapat dihitung untuk paket-paket tersebut, paling sering karena nilai yang dibaca tidak ada dalam paket. Atribut tersebut kemudian tidak memiliki nilai, dan tidak ada kesalahan yang dilaporkan. Lihat Nilai yang hilang dalam ekspresi.