#Komputasi JSON

#Pengantar

Berdasarkan engine komputasi JSON yang berbeda, melakukan komputasi atau transformasi struktur pada data JSON kompleks yang dihasilkan oleh Node upstream, untuk digunakan oleh Node berikutnya. Misalnya hasil dari Node Operasi SQL dan Node HTTP Request, dapat ditransformasi menjadi format nilai dan variable yang dibutuhkan melalui Node ini, untuk digunakan oleh Node berikutnya.

#Membuat Node

Pada antarmuka konfigurasi workflow, klik tombol plus ("+") pada alur untuk menambahkan Node "Komputasi JSON":

#Konfigurasi Node

#Engine Parsing

Node Komputasi JSON mendukung sintaks yang berbeda melalui engine parsing yang berbeda, Anda dapat memilih sesuai preferensi Anda dan karakteristik setiap engine. Saat ini mendukung tiga engine parsing:

• JMESPath
• JSONPath Plus
• JSONata

#Sumber Data

Sumber data dapat berupa hasil Node upstream, atau objek data dari konteks alur, biasanya berupa objek data yang tidak terstruktur secara built-in, seperti hasil Node SQL, atau hasil Node HTTP Request.

#Expression Parsing

Berdasarkan kebutuhan parsing dan engine parsing yang berbeda, expression parsing yang dibuat juga berbeda.

Sejak versi v1.0.0-alpha.15, expression mendukung penggunaan variable. Variable akan di-pre-parse sebelum engine spesifik dieksekusi. Sesuai dengan aturan template string, variable diganti dengan nilai string yang spesifik, dan digabungkan dengan string statis lain dari expression menjadi expression final. Fitur ini sangat berguna saat perlu membuat expression secara dinamis, misalnya saat beberapa konten JSON perlu diparse dengan key dinamis.

#Pemetaan Properti

Saat hasil komputasi adalah sebuah objek (atau array objek), Anda dapat memetakan properti yang dibutuhkan menjadi variable sub-level melalui pemetaan properti, untuk digunakan oleh Node berikutnya.

#Contoh

Misalkan data yang perlu diparse adalah Node SQL sebelumnya yang digunakan untuk query data, hasilnya berupa sekelompok data pesanan:

[
  {
    "id": 1,
    "products": [
      {
        "id": 1,
        "title": "Product 1",
        "price": 100,
        "quantity": 1
      },
      {
        "id": 2,
        "title": "Product 2",
        "price": 120,
        "quantity": 2
      }
    ]
  },
  {
    "id": 2,
    "products": [
      {
        "id": 3,
        "title": "Product 3",
        "price": 130,
        "quantity": 1
      },
      {
        "id": 4,
        "title": "Product 4",
        "price": 140,
        "quantity": 2
      }
    ]
  }
]

Jika kita perlu memparse dan menghitung total harga dari masing-masing dua pesanan dalam data, dan menggabungkannya menjadi objek dengan ID pesanan yang sesuai, untuk meng-update total harga pesanan, dapat dikonfigurasi seperti berikut:

1. Pilih engine parsing JSONata;
2. Pilih hasil Node SQL sebagai sumber data;
3. Gunakan expression JSONata $[0].{"id": id, "total": products.(price * quantity)} untuk parsing;
4. Pilih pemetaan properti, mapping id dan total menjadi variable sub-level;

Hasil parsing final adalah sebagai berikut:

[
  {
    "id": 1,
    "total": 340
  },
  {
    "id": 2,
    "total": 410
  }
]

Setelah itu lakukan loop pada array pesanan yang sudah lengkap, untuk meng-update total harga pesanan.