Panduan memulai cepat

Panduan ini akan membantu Anda menyiapkan alur data pertama Anda di IoT Logic dengan cepat dan mulai memproses data telematika Anda.

Prasyarat

Sebelum melanjutkan pembuatan alur pertama Anda, pastikan Anda memiliki:

• Seorang Pemilik peran dalam akun Navixy Anda

• Perangkat yang diaktifkan di akun Anda

• Pemahaman tentang sumber data apa yang ingin Anda proses

Workspace IoT Logic hanya tersedia untuk akun Akun dan tidak ditampilkan untuk Pengguna. Untuk detail tentang peran pengguna, lihat Pengguna dan Peran.

Konfigurasi alur

Tonton video singkat yang menampilkan proses pembuatan alur baru dengan perhitungan atribut data dan penambahan atribut kustom ke perangkat di platform:

Proses pembuatan alur baru dengan perhitungan atribut data dan penambahan atribut kustom ke perangkat di platform

Sekarang, mari uraikan proses konfigurasi alur langkah demi langkah.

1

Langkah 1: Akses workspace IoT Logic

1. Masuk ke akun Navixy Anda

2. Klik ikon profil Anda di sudut kiri atas layar untuk mengakses Pengaturan akun

3. Pilih IoT Logic di bilah samping pengaturan

Workspace IoT Logic muncul dengan tiga bagian utama:

• Bilah pengaturan alur - Berisi kontrol untuk mengelola alur

• Panel node - Daftar node yang tersedia untuk membangun alur Anda

• Kanvas - Workspace utama tempat Anda merancang alur Anda

Untuk detail tentang workspace, lihat Area kerja dan flow default.

2

Langkah 2: Buat alur baru

1. Klik New flow tombol di bilah pengaturan alur

2. Dalam New flow dialog:

• Masukkan nama deskriptif untuk alur Anda (mis., "Fleet Telemetry Processing")

• Tambahkan deskripsi singkat yang menjelaskan tujuan alur tersebut

• Pastikan Flow enabled toggel dinyalakan

1. Klik Simpan untuk membuat flow

Untuk informasi tambahan tentang konfigurasi alur, lihat Manajemen alur -> Membuat alur baru.

Alur yang dinonaktifkan tidak memproses data apa pun. Ketika sebuah alur dinonaktifkan, perangkat dalam alur itu tidak akan mengirimkan data ke tujuan apa pun, termasuk platform Navixy.

3

Langkah 3: Konfigurasikan node Sumber Data

1. Dari Nodes panel, seret sebuah Sumber Data node ke kanvas

2. Arahkan mouse Anda di atas node untuk menampilkan tindakan cepat, atau klik dua kali node untuk membuka panel konfigurasinya

3. Konfigurasikan pengaturan berikut:

• Nama node - Masukkan nama deskriptif, menentukan asal data yang dikirim (mis., Kendaraan staf)

• Sumber - Pilih perangkat yang pembacaannya ingin Anda kirim ke alur ini. Anda dapat memfilter perangkat yang tersedia berdasarkan data Pabrikan dan Model.

1. Klik Simpan untuk menerapkan konfigurasi

Untuk detail tentang konfigurasi node, lihat Node Sumber Data.

4

Langkah 4: Tambahkan pengayaan data (Opsional)

1. Seret sebuah Inisiasi Atribut node ke kanvas

2. Arahkan mouse Anda di atas node untuk menampilkan tindakan cepat, atau klik dua kali node untuk membuka panel konfigurasinya

3. Tambahkan sebuah Nama node deskriptif untuk menentukan tujuan dan perhitungan yang dilakukannya (mis. Temperature °F to °C)

4. Definisikan atribut Anda:

   1. Nama atribut - Nama yang jelas dan deskriptif (mis., "speed_mph")

   2. Formula - Ekspresi perhitungan (mis., value('speed')/1.609 untuk mengonversi km/h ke mph) 💡Catatan: Nama atribut dapat diisi otomatis untuk memastikan penamaan yang benar. Pengisian otomatis menggunakan sintaks singkat secara default, yang merujuk pada nilai atribut terbaru.

   3. Waktu pembuatan - Kapan entri data dibuat di perangkat (default ke now())

   4. Waktu server - Kapan data diterima oleh server (default ke now())

5. Tambahkan atribut tambahan jika diperlukan dengan mengklik Add attribute 💡Catatan: Tombol Atur ulang formulir membuang semua atribut yang dibuat dalam sebuah node. Jika Anda ingin menghapus atribut tertentu, klik tiga titik di kanan baris atribut dan pilih Delete.

6. Klik Simpan untuk menerapkan konfigurasi

7. Buat koneksi:

   1. Klik konektor keluaran dari Sumber Data node ini

   2. Seret transisi ke konektor masukan dari Inisiasi Atribut node ini

Untuk detail tentang konfigurasi node, lihat Node Inisiasi Atribut.

Untuk detail tentang tindakan dengan atribut, lihat Mengelola atribut.

Untuk contoh rumus perhitungan, lihat Calculation examples.

5

Langkah 5: Konfigurasikan keluaran data

1. Seret sebuah Output Endpoint node ke kanvas

2. Arahkan mouse Anda di atas node untuk menampilkan tindakan cepat, atau klik dua kali node untuk membuka panel konfigurasinya

3. Pilih Tipe endpoint:

• Endpoint Navixy - endpoint default untuk mengirim data yang diproses ke platform Navixy. Ini sudah dikonfigurasi sebelumnya dan tidak memungkinkan perubahan

• MQTT endpoint - endpoint untuk mengirim data ke tujuan pihak ketiga, menggunakan MQTT sebagai protokol transport. Memerlukan konfigurasi manual yang dijelaskan pada langkah-langkah selanjutnya

Endpoint yang dibuat dalam akun tersedia sebagai Preset. Anda dapat memilih konfigurasi yang sudah ada alih-alih menyiapkannya dari awal. Endpoint Keluaran Navixy selalu tersedia sebagai preset.

1. Konfigurasikan pengaturan berikut:

   1. Nama endpoint - Masukkan nama deskriptif untuk menentukan tujuan tempat data dikirim

   2. Protokol - Pilih protokol data (saat ini hanya “Navixy Generic Protocol (JSON)" yang tersedia)

   3. IP/Domain - Masukkan alamat tujuan

   4. Port - Tentukan nomor port (default: 1883 untuk MQTT standar, 8883 untuk SSL)

   5. (opsional) Aktifkan SSL - Aktifkan untuk koneksi aman

   6. Versi MQTT - Pilih versi yang sesuai (3.1.1 atau 5.0)

   7. Client ID - Masukkan pengidentifikasi untuk klien Anda agar data diterima oleh pihak penerima

   8. (opsional) Topik - Tentukan topik MQTT untuk transmisi data

   9. QoS - Pilih level Quality of Service untuk menentukan logika transmisi data (0, 1, atau 2)

2. Jika autentikasi diperlukan di sisi penerima, aktifkan Autentikasi MQTT ON Kolom yang muncul terisi otomatis dengan kredensial akun platform Anda

Node Atur ulang formulir membuang semua atribut yang dibuat dalam sebuah node. Jika Anda ingin menghapus atribut tertentu, klik tiga titik di kanan baris atribut dan pilih Delete.

1. Klik Buat untuk menerapkan konfigurasi

2. Hubungkan node lain Anda ke node keluaran ini sesuai urutan yang diperlukan untuk menyelesaikan struktur alur

Setiap alur harus menyertakan sebuah Default Endpoint node untuk memastikan data dikirim ke platform. Tanpa koneksi ini, data perangkat tidak akan terlihat di antarmuka Navixy.

Untuk detail tentang konfigurasi node, lihat Node Titik Akhir Output.

6

Langkah 6: Simpan dan aktifkan alur Anda

1. Verifikasi semua node terhubung dengan benar dalam alur Anda

2. Klik Simpan flow tombol di Nodes panel

Alur Anda sekarang aktif dan memproses data secara real-time!

Validasi alur

Untuk memastikan alur Anda berfungsi dengan benar, gunakan Data Stream Analyzer alat:

1. Klik Data analyzer tombol di bilah pengaturan alur

2. Pilih perangkat yang ingin Anda pantau dari daftar dropdown

3. Amati atribut data yang masuk dan nilainya

4. Gunakan opsi penyaringan untuk memfokuskan pada parameter tertentu

5. Verifikasi bahwa atribut yang dihitung menunjukkan nilai yang benar

Untuk detail tentang penggunaan alat, lihat Data Stream Analyzer.

Selamat! Alur data IoT Logic pertama Anda sudah aktif dan berjalan.

Langkah selanjutnya

Sekarang setelah Anda membuat alur IoT Logic pertama, Anda dapat:

• Sesuaikan contoh panduan cepat ini dengan kebutuhan bisnis Anda

• Buat transformasi data yang lebih kompleks dengan beberapa Inisiasi node Atribut

• Siapkan tambahan tujuan keluaran untuk data Anda yang dapat menjadi profil yang dapat digunakan kembali untuk konfigurasi konsisten

• Kelola alur yang sudah dibuat untuk menyesuaikan pemrosesan data dengan setiap perubahan yang Anda hadapi

• Rancang alur lanjutan untuk skenario bisnis spesifik menggunakan kombinasi dan konfigurasi node yang berbeda

Menyesuaikan contoh ini

Contoh ini dapat disesuaikan untuk berbagai kasus penggunaan industri dengan memodifikasi:

• Pemilihan perangkat: Pilih perangkat yang relevan dengan aset spesifik Anda

• Konversi satuan: Sesuaikan rumus berdasarkan satuan pengukuran standar Anda

• Metrik yang dihitung: Buat indikator khusus industri berdasarkan kebutuhan bisnis Anda

• Konfigurasi keluaran: Sambungkan ke platform analisis atau basis data spesifik Anda

Polanya yang mendasar — mengumpulkan, mengubah, dan meneruskan — tetap konsisten di berbagai industri, menjadikan ini template serbaguna untuk pemrosesan data IoT.

Akses API

Fungsionalitas IoT Logic juga dapat diakses secara programatis melalui API Navixy. Ini memungkinkan pengembang untuk mengotomatisasi pembuatan, pengelolaan, dan pemantauan flow.

Untuk alasan keamanan, akses API memerlukan izin yang sesuai. Hubungi administrator akun Anda untuk memastikan Anda memiliki hak akses yang diperlukan.

Untuk dokumentasi API lengkap, parameter, format permintaan/response, dan contoh kode, lihat Dokumentasi API Navixy IoT Logic.

Pertanyaan yang sering diajukan

Apa yang terjadi pada perangkat yang tidak ditetapkan ke alur kustom?

Perangkat yang tidak secara eksplisit ditetapkan ke alur kustom akan secara otomatis ditangani oleh alur default, yang mengirimkan data mereka langsung ke platform Navixy.

Bisakah saya menggunakan perangkat yang sama di beberapa alur?

Tidak, setiap perangkat hanya dapat ditetapkan ke satu alur pada satu waktu. Ketika ditambahkan ke alur kustom, perangkat akan secara otomatis dihapus dari alur default untuk mencegah pemrosesan data ganda.

Apakah alur saya akan terus bekerja jika saya keluar (log out)?

Ya, setelah diaktifkan, alur beroperasi secara independen dari sesi pengguna Anda. Selama alur diaktifkan, alur akan memproses data meskipun Anda tidak masuk.

Bagaimana saya tahu jika alur saya berfungsi dengan benar?

Gunakan Data Stream Analyzer untuk memantau transmisi data real-time. Alat ini menampilkan baik data mentah perangkat maupun atribut yang dihitung, memungkinkan Anda memverifikasi bahwa transformasi berfungsi seperti yang diharapkan.

Apa yang terjadi jika saya menonaktifkan sebuah alur?

Ketika Anda menonaktifkan sebuah alur, perangkat yang ditetapkan ke alur tersebut tidak akan mengirimkan data ke tujuan mana pun, termasuk platform Navixy. Perangkat akan muncul offline di antarmuka Navixy sampai Anda mengaktifkan kembali alur tersebut.