IoT Platform:Konversi nilai konfigurasi

Skenario

• Skenario 1: Konversi nilai ke bidang asli.

  Rumah kaca menggunakan sensor untuk melaporkan iluminansi (lux). Meskipun iluminansi tidak boleh bernilai negatif, pembacaan negatif sporadis dapat mencapai IoT Platform dan mengganggu hasil analisis. Anda dapat menggunakan node Value Conversion untuk mengganti data anomali tersebut dengan nilai default. Misalnya, ubah pembacaan iluminansi (lux) negatif menjadi 0 guna mencegah kesalahan logika dalam pemrosesan tahap berikutnya.

• Skenario 2: Konversi nilai ke bidang baru yang didefinisikan.

  Sensor suhu melaporkan data suhu (temperature) ke IoT Platform. Untuk mengklasifikasikan rentang suhu ke dalam level seperti normal, alarm, dan danger serta memicu aksi yang sesuai, gunakan node Value Conversion untuk membuat bidang baru, alert_level, yang menunjukkan level yang sesuai.

Prasyarat

Pastikan ekspresi komputasi data atau filter penyaringan data telah dikonfigurasi. Untuk informasi lebih lanjut, lihat Konfigurasi komputasi data dan penyaringan data.

Informasi latar belakang

• Untuk ikhtisar fitur parsing data, lihat Catatan Penggunaan.

• Untuk petunjuk penggunaan ruang kerja parsing data, lihat Petunjuk Ruang Kerja Parsing Data.

Prosedur

1. Akses workbench parsing data.

2. Di kanvas tengah, klik ikon add setelah node saat ini.

3. Dari daftar node yang muncul, klik sekali node Value Conversion.

4. Di kanvas, klik sekali node Value Conversion dan atur parameter konversi di panel konfigurasi sebelah kanan, seperti dijelaskan dalam tabel berikut.

   Item Konfigurasi	Deskripsi
   Conditional Field Name	Bidang yang digunakan untuk evaluasi kondisional, biasanya berupa bidang numerik. Bidang ini harus merupakan output dari node sebelumnya. Bidang yang tersedia adalah bidang output dari node sebelumnya.
   Output Field Name	Nama bidang output yang dihasilkan oleh node value conversion. Nama dapat terdiri dari huruf, angka, dan garis bawah (_), tidak boleh diawali angka, dan tidak boleh melebihi 30 karakter. Hanya huruf, angka, dan garis bawah (_) yang didukung. Nama tidak boleh diawali angka dan tidak boleh melebihi 30 karakter.
   Output Field Type	Pilih tipe data untuk bidang output: BIGINT, DOUBLE, atau VARCHAR.
   Default Output Value When Not Matched	Nilai default bidang output ketika tidak ada kondisi yang terpenuhi. Untuk mengoutput data mentah, gunakan ${Field Name}.
   Conditional Branch	Konfigurasikan nilai output untuk setiap rangkaian kondisi. Anda dapat menambahkan beberapa cabang kondisional, masing-masing dengan maksimal tiga kondisi AND dan maksimal sepuluh cabang per node. Cabang dievaluasi secara berurutan, dan pencocokan pertama yang berhasil akan digunakan. Pilih Conditional Operator dari opsi berikut: = (equal), != (not equal), > (greater than), >= (greater than or equal), < (less than), <= (less than or equal), isNull (kosong), atau isNotNull (tidak kosong). Masukkan Conditional Value untuk evaluasi kondisi. (Opsional) Klik Add AND Condition untuk menambahkan dan mengonfigurasi Conditional Operators dan Conditional Values tambahan. Catatan Semua kondisi dalam satu cabang kondisional digabungkan menggunakan hubungan AND. Satu cabang kondisional dapat mencakup hingga tiga kondisi AND. Tetapkan nilai bidang output ketika kondisi cabang terpenuhi. IoT Platform memvalidasi tipe data terhadap Output Field Type yang ditentukan. Untuk mengoutput data mentah suatu bidang, gunakan sintaks ${Field Name}. Klik Add Conditional Branch untuk menambahkan cabang kondisional lainnya. Catatan Dalam satu node value conversion: Maksimal 10 cabang kondisional diperbolehkan. Node mengevaluasi cabang kondisional secara berurutan dari atas ke bawah dan menjalankan pencocokan pertama yang berhasil.

   Contoh berikut didasarkan pada Skenario 2 di bagian Skenario.

   Konfigurasi ini memeriksa suhu operasi perangkat dan menetapkan level peringatan:

   • Untuk 50<temperature<=80, tetapkan level peringatan (alert_level) ke alarm.

   • Untuk temperature>80, tetapkan level peringatan (alert_level) ke danger.

   • Untuk semua kasus lainnya, tetapkan level peringatan (alert_level) ke normal.

   Node Value Conversion ini setara dengan pernyataan SQL case when:

   select 
   case when temperature>50 and temperature<=80 then 'alarm'
        when temperature>80 then 'danger'
   else 'normal' end as alert_level

5. Untuk menyimpan konfigurasi Anda, klik sekali Save di pojok kanan atas Data Parsing Workbench.

Langkah selanjutnya

Setelah mengonfigurasi node Value Conversion, konfigurasikan node pemrosesan atau node tujuan lainnya untuk menyelesaikan task parsing. Untuk informasi lebih lanjut, lihat Konfigurasi komputasi data dan penyaringan data.