Lewati ke konten utama

Pendahuluan

Modul "Integrasi" memungkinkan Anda untuk dengan mudah menggabungkan API dan layanan online melalui pemrograman visual. Modul ini menyediakan antarmuka yang ramah pengguna di mana Anda dapat menyeret dan menghubungkan blok node, menciptakan logika aplikasi Anda secara visual. Ini menyederhanakan pengembangan, membuatnya dapat diakses bahkan bagi mereka yang bukan programmer profesional, dan secara signifikan mempercepat proses integrasi berbagai sistem:

Elemen Antarmuka Utama dari Modul Integrasi​

Sebelum Anda mulai membuat alur dan integrasi pertama Anda, mari kita kenali antarmukanya. Memahami bagaimana elemen utama disusun akan menyederhanakan pekerjaan Anda dan membantu Anda beradaptasi lebih cepat.

1. Panel Kiri dengan Node​

Panel kiri adalah tempat Anda akan menemukan semua node yang tersedia. Ini adalah elemen yang akan Anda gunakan untuk membangun alur data Anda.

Untuk menggunakan node, cukup seret ke ruang kerja. Semua node memiliki tujuan spesifik dan dapat dikonfigurasi secara individu.

Contoh Node:

  • Inject: memungkinkan Anda untuk mengirim data secara manual ke dalam alur.
  • Debug: mengeluarkan data dan pesan ke menu debug.
  • Function: memungkinkan Anda untuk menulis kode kustom dalam JavaScript.
  • Template: digunakan untuk membuat template teks atau HTML.

2. Tab​

Tab terletak di atas ruang kerja dan memungkinkan Anda untuk beralih antara proyek atau alur data yang berbeda. Ini sangat nyaman jika Anda sedang mengerjakan beberapa integrasi secara bersamaan atau ingin memisahkan logika ke dalam beberapa alur.

  • Membuat Tab Baru: Anda dapat menambahkan tab baru dengan mengklik tombol plus +. Setiap tab baru mewakili alur data terpisah, membantu Anda mengorganisir proyek Anda dengan lebih baik.
  • Mengganti Nama Tab: Untuk mengganti nama tab, klik dua kali pada namanya dan masukkan yang baru. Ini sangat berguna jika Anda memiliki banyak tab dan ingin memahami dengan jelas apa yang terkandung di dalamnya.
  • Menghapus Tab: Anda dapat menghapus tab jika Anda tidak membutuhkannya lagi. Namun, berhati-hatilah agar tidak kehilangan data penting.

Contoh: Jika Anda sedang mengerjakan integrasi pembayaran, Anda dapat membuat tab terpisah untuk setiap layanan.

3. Ruang Kerja​

Ruang kerja adalah bagian pusat dari antarmuka di mana Anda membangun dan mengedit alur data Anda.

  • Menempatkan Node: Setelah Anda menyeret node dari panel kiri, node tersebut akan muncul di ruang kerja. Di sini Anda dapat memindahkannya, menghubungkannya ke node lain, dan menciptakan logika alur Anda.
  • Menghubungkan Node: Untuk menghubungkan node, cukup seret garis dari output satu node ke input node lainnya. Dengan cara ini, data akan diteruskan melalui alur dari satu node ke node lainnya.
  • Mengelola Alur: Ruang kerja memungkinkan Anda untuk membuat beberapa alur data, yang membantu mengorganisir integrasi dan logika yang kompleks.

Tip: Anda dapat memperbesar dan memperkecil ruang kerja menggunakan mouse atau touchpad Anda untuk melihat semua detail alur Anda.

4. Formulir Pengeditan Node​

Ketika Anda mengklik dua kali pada node di ruang kerja, formulir pengeditan node akan terbuka. Ini adalah jendela di mana Anda mengonfigurasi perilaku node.

  • Bidang Pengaturan: Setiap node memiliki parameternya sendiri yang dapat Anda edit. Misalnya, di node Function, Anda dapat menulis dan mengedit kode.
  • Menyimpan Perubahan: Setelah mengedit node, klik tombol Submit untuk menyimpan perubahan Anda.

Contoh: Di node Function, Anda dapat menulis kode JavaScript yang mengubah data. Di node Template, Anda dapat membuat template yang secara dinamis menyisipkan data.

5. Panel Debug​

Panel debug terletak di sebelah kanan dan digunakan untuk melihat data output dan pesan dari node Debug.

  • Melihat Pesan: Ketika Anda menjalankan alur data, node Debug mengirimkan pesan ke menu Debug. Ini membantu Anda melihat apa yang terjadi dalam alur Anda dan memeriksa kebenaran data.
  • Menyaring Pesan: Anda dapat menyaring pesan untuk melihat hanya data yang Anda butuhkan. Ini nyaman ketika Anda memiliki banyak data output dari berbagai node Debug.
  • Menghapus Jendela Debug: Gunakan tombol hapus untuk menghapus pesan lama dan fokus pada data baru.

Contoh: Jika Anda menggunakan node Function untuk melakukan perhitungan, tambahkan node Debug di akhir alur untuk memeriksa apakah kode Anda memproses data dengan benar.

6. Tombol Kontrol​

Tombol Layar Penuh​

  • Tombol ini memungkinkan Anda untuk memperluas antarmuka modul Integrasi ke layar penuh, yang berguna saat bekerja pada alur data yang kompleks atau saat mendemonstrasikan proyek di monitor besar.
  • Dengan mengklik tombol ini, Anda akan memiliki lebih banyak ruang untuk mengedit dan dapat melihat semua detail alur Anda dengan lebih baik.

Tombol Publikasi​

  • Ini adalah tombol utama yang menyimpan dan menerapkan semua perubahan yang dilakukan pada alur data Anda, menjadikannya aktif. Setelah Anda menambahkan atau memodifikasi node, pastikan untuk mengklik tombol ini agar pengaturan Anda berlaku.

Tombol Impor​

  • Tombol ini memungkinkan Anda untuk mengimpor skema yang ada dari JSON atau contoh dari daftar. Anda dapat mempelajari lebih lanjut di bagian Impor.

Skema Input dan Mengoper Skema Antara Node​

Setiap node dalam formulir pengeditan menampilkan blok Skema Input — ini adalah skema data yang berasal dari node sebelumnya dalam alur. Skema menunjukkan bidang yang tersedia dalam bentuk pasangan "kunci - tipe", dengan mempertimbangkan pengelompokan objek.

Jika deskripsi bidang diambil dari Swagger, itu akan ditampilkan di samping kunci. Deskripsi ini juga diambil oleh editor kode (Monaco) sebagai autocompletion dan petunjuk saat menulis template Mustache.

Node Mana yang Mengoper Skema ke Node Berikutnya​

Tidak semua node dapat mengoper skema. Daftar node yang dapat melakukan ini termasuk:

  • Function — skema dibentuk dari bidang Contoh Output (JSON). Bidang ini juga digunakan sebagai data tiruan saat memanggil alur tanpa benar-benar menjalankan kode Function.
  • Admin API — skema diambil dari deskripsi metode dalam Swagger. Ketika tombol Eksekusi ditekan, skema diperbarui dengan respons API yang nyata. Bidang yang cocok dengan deskripsi Swagger mempertahankan deskripsi teksnya.
  • Http Request — pada awalnya, tidak ada skema. Skema muncul setelah menekan tombol Eksekusi dan diambil dari respons nyata.

Tombol Eksekusi​

Node Admin API dan Http Request mendukung tombol Eksekusi dalam formulir pengeditan. Ini memicu eksekusi seluruh rangkaian node dari awal alur hingga node saat ini.

Fitur:

  • Server mengeksekusi alur berdasarkan status terakhir Publikasi — sebelum pengujian, pastikan bahwa alur telah dipublikasikan.
  • Jika node function dalam jalur tidak meneruskan data lebih lanjut, tetapi memiliki Contoh Output (JSON) yang diisi, nilai ini digunakan sebagai data tiruan.
  • Setelah respons berhasil, hasilnya diteruskan ke node berikutnya sebagai skema.
  • Jika terjadi kesalahan, skema tidak diteruskan ke node berikutnya.

Pemanggilan Otomatis Node Hanya-Baca​

Semua node admin-api yang melakukan permintaan hanya-baca (GET) secara otomatis dipanggil ketika halaman Integrasi dibuka dan ketika alur diperbarui melalui tombol Publikasi. Ini memastikan bahwa Anda selalu memiliki skema data terkini tanpa pemicu manual.