Variabel

Variabel adalah elemen integrasi yang menyimpan dan mentransfer data antara tugas, pemicu, dan tepi integrasi.

• Variabel dapat ditentukan secara statis pada waktu desain atau diteruskan secara dinamis ke integrasi saat runtime.
• Variabel dapat mereferensikan variabel lain dalam integrasi.
• Variabel dapat diakses secara global oleh semua tugas, atau diakses secara lokal oleh tugas tertentu.

Variabel

Di Integrasi Aplikasi, variabel ditetapkan atau diinisialisasi di berbagai tempat:

• Variabel konfigurasi: Ditetapkan pada waktu desain untuk menyimpan data konfigurasi integrasi. Misalnya, Anda dapat menggunakan ini untuk menetapkan alamat email target untuk notifikasi, bukan meng-hardcode alamat email tersebut dalam integrasi.
• Variabel sistem: Dibuat secara otomatis oleh sistem untuk menyimpan data konfigurasi integrasi. Misalnya, variabel ExecutionId menyimpan ID eksekusi integrasi.
• Variabel integrasi: Ditetapkan secara eksplisit dalam integrasi Anda untuk melacak data selama keseluruhan eksekusi integrasi. Misalnya, Anda dapat menetapkan variabel untuk menyimpan hasil tugas dan menggunakannya dalam tugas berikutnya.
• Variabel tugas: Ditetapkan secara implisit dengan menjalankan tugas tertentu untuk menyimpan output tugas. Misalnya, tugas Call REST Endpoint menetapkan variabel responseBody untuk menyimpan isi respons endpoint REST. Variabel tugas juga dikenal sebagai variabel yang dibuat otomatis. Variabel yang dibuat otomatis memiliki konvensi penamaan khusus dengan menggunakan tanda petik terbalik di sekitar nama variabel.

Variabel integrasi

Variabel integrasi, yang mencakup variabel input dan output, mirip dengan variabel yang digunakan dalam bahasa pemrograman. Data dalam variabel dapat dibaca dan ditulis selama eksekusi integrasi.

Variabel integrasi dapat digunakan dengan cara berikut:

• Diambil sebagai input ke integrasi, juga dikenal sebagai variabel input.
• Ditampilkan sebagai output integrasi, yang juga dikenal sebagai variabel output.
• Digunakan untuk menyimpan status sementara selama eksekusi integrasi.

Catatan: Peran variabel yang tercantum di atas tidak saling eksklusif. Setiap variabel dapat berupa variabel input, variabel output, keduanya, atau tidak keduanya.

Saat menandai variabel sebagai variabel input, Anda menunjukkan bahwa nilai variabel diharapkan diberikan saat integrasi dipicu. Nilai variabel input dapat diubah selama eksekusi integrasi.

Saat menandai variabel sebagai variabel output, Anda menunjukkan bahwa nilai akhir variabel harus ditampilkan sebagai bagian dari respons integrasi.

Nilai variabel tidak harus ditentukan secara statis dalam integrasi. Nilai variabel dapat diteruskan ke integrasi melalui penggunaan pemicu. Namun, jika variabel ditentukan secara statis dalam integrasi, dan variabel yang sama diberikan secara dinamis dengan pemicu, penetapan nilai dinamis akan menggantikan penetapan statis.

Jenis data yang didukung

Jenis data berikut didukung untuk variabel integrasi:

• String dan Array string
• Bilangan bulat dan array Bilangan bulat
• Double dan Double array
• Boolean dan array Boolean
• JSON

Variabel tugas

Variabel tugas adalah variabel yang telah ditentukan dan dibuat secara otomatis dari tugas. Jika tugas memiliki output, semua output tersebut tersedia dalam variabel tugas. Anda tidak dapat menghapus atau mengedit variabel tugas. Variabel tugas juga dikenal sebagai variabel yang dibuat otomatis.

Nama unik variabel tugas mengikuti konvensi penamaan khusus: menggunakan tanda petik terbalik di sekitar nama variabel dan menyertakan ID Tugas. Formatnya adalah `<Task ID>_<Variable Name>`.

Misalnya, tugas Call REST Endpoint memiliki output untuk isi respons. Jika tugas ini memiliki ID Task_5, nama variabel tugas unik untuk isi respons adalah `Task_5_responseBody`.

Di panel Variables, variabel tugas dapat dicantumkan berdasarkan nama output umum, misalnya, responseBody, tanpa ID Tugas atau tanda petik terbalik. Untuk melihat nama variabel unik lengkap yang diperlukan untuk referensi, klik variabel di panel dan lihat detailnya di panel sebelah kanan.

Variabel konfigurasi

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Variabel konfigurasi memungkinkan Anda mengeksternalkan konfigurasi untuk integrasi. Dengan variabel konfigurasi, Anda dapat mengonfigurasi aspek integrasi seperti detail konektor, detail autentikasi, atau endpoint URL yang didasarkan pada lingkungan pengembangan, seperti QA, staging, atau produksi. Anda tidak perlu memperbarui integrasi secara manual sebelum mengupload integrasi ke lingkungan baru. Integrasi Aplikasi memungkinkan Anda memasukkan nilai untuk variabel konfigurasi saat memublikasikan integrasi.

Untuk melihat dan mengedit variabel konfigurasi yang ditentukan dalam integrasi Anda, klik variable_add Variabel konfigurasi integrasi di panel Variabel. Untuk mempelajari cara membuat dan menggunakan variabel konfigurasi, lihat tutorial Membangun CICD untuk integrasi Anda.

Variabel sistem

Variabel sistem dibuat secara otomatis saat Anda membuat integrasi. Anda dapat menggunakan variabel ini dalam tugas integrasi dan untuk menangani error. Integrasi ini berisi variabel yang dibuat sistem berikut:

• ErrorInfo: Jika eksekusi gagal, Anda dapat mengakses detail error dengan variabel ErrorInfo:

  {
    "ErrorInfo": {
    "message": String,
    "code": Number
    }
  }
  

  Anda dapat mengakses pesan error dengan membuat variabel integrasi bernama ErrorMessage. Namun, sebaiknya gunakan variabel ErrorInfo.message yang dibuat sistem untuk mengakses pesan error.

• ExecutionMode: Mode eksekusi berdasarkan pemicu. Nilai yang valid adalah SYNC dan ASYNC.
• ExecutionId: ID eksekusi integrasi.
• IntegrationName: Nama integrasi.
• Region: Region integrasi.
• ProjectId: Project ID yang berisi integrasi.

Melihat variabel

Anda dapat menggunakan panel Variabel untuk membuat, mengedit, melihat, menduplikasi, dan menghapus variabel dalam integrasi Anda. Panel Variables juga menampilkan jumlah total referensi variabel dalam integrasi.

Untuk melihat panel Variabel, klik , panel Beralih, di panel navigasi perancang.

Gambar berikut menunjukkan contoh tata letak panel Variabel:

Melihat dan mengedit variabel konfigurasi

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Produk dan fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Untuk melihat variabel konfigurasi yang ditentukan dalam integrasi Anda, klik variable_add Variabel konfigurasi integrasi di panel Variabel. Tindakan ini akan menampilkan panel Config variables yang menampilkan semua variabel konfigurasi yang ditentukan dalam integrasi Anda. Anda cukup mengklik kolom Nilai untuk mengedit nilai variabel konfigurasi.

Gambar berikut menunjukkan contoh tata letak panel Variabel config:

Membuat variabel

Untuk membuat variabel, lakukan langkah-langkah berikut:

1. Di panel navigasi editor integrasi, klik , panel Alihkan, untuk menampilkan panel Variabel.
2. Klik +Create.
3. Lakukan hal berikut di panel Create Variable:
   1. Nama: Masukkan nama variabel.
   2. Jenis Variabel: Pilih jenis variabel.

   Jenis data	Deskripsi
   Tidak ada	Variabel lokal dalam integrasi.
   Variabel konfigurasi untuk Integrasi	Variabel konfigurasi dalam integrasi.
   Input ke Integrasi	Selama eksekusi, variabel akan diberikan sebagai input ke pemicu yang dieksekusi.
   Output dari Integrasi	Nilai akhir variabel di akhir eksekusi harus ditampilkan ke pemanggil integrasi.
   Input dan Output Integrasi	Saat eksekusi, variabel akan diberikan sebagai input ke pemicu yang dieksekusi dan nilai akhirnya akan dikeluarkan ke pemanggil integrasi.

   3. Jenis Data: Pilih jenis data variabel. Anda dapat mengidentifikasi jenis data variabel menggunakan ikon di samping nama variabel.

      Jenis data	Contoh
      String	Alex
      Integer	30
      Double	30.5
      Boolean	true
      JSON	{ "employee":{"name":"Alex", "age":30, "city":"Mountain View"} }
      Array string	Alex, Kai, Raha
      Array bilangan bulat	30, 25, 22
      Array ganda	30.5, 25.34, 22.134
      Array boolean	true, false, false

      Untuk mengetahui informasi tentang jenis data yang didukung, lihat Jenis data yang didukung.

   4. Nilai Default: Masukkan nilai default untuk variabel. Kolom ini bersifat opsional.
   5. Skema: Pilih skema JSON untuk variabel.
      • Menyimpulkan dari payload JSON sampel: Membuat skema JSON dari payload JSON sampel. Payload contoh akan dihapus setelah skema dibuat. Hanya skema yang dihasilkan yang akan disimpan.
      • Masukkan skema JSON: Masukkan seluruh skema JSON secara manual.
      • Menyimpulkan dari nilai default: Membuat skema JSON menggunakan nilai default yang diberikan.
      • Tidak Ada: Tidak ada skema JSON.
      Catatan: Kolom ini hanya ditampilkan untuk variabel jenis data JSON.
   6. Menyamarkan variabel dalam log (pratinjau): Pilih opsi ini untuk mengaktifkan penyamaran variabel dalam log eksekusi integrasi. Untuk mengaktifkan penyamaran variabel, Anda harus mengaktifkan variabel penyamaran untuk integrasi dan wilayah Anda. Untuk mengetahui informasi tentang cara mengaktifkan penyamaran untuk integrasi dan region, lihat Mengedit integrasi dan Mengedit region.

      Untuk mengetahui informasi tentang penyamaran, lihat Menyamarkan data sensitif dalam log.

4. Klik Buat.

Cara kerja variabel dalam integrasi

Selama eksekusi integrasi, data run-time diteruskan sebagai variabel yang dideklarasikan untuk integrasi atau tugas. Setelah eksekusi dimulai, data input dikonversi menjadi objek dalam memori yang disebut Event.

Setelah objek Peristiwa dibuat, grafik tugas dalam memori akan dibuat menggunakan definisi integrasi. Nilai variabel masuk diteruskan ke tugas berdasarkan konfigurasi Anda. Saat integrasi dijalankan, tugas membaca dan menulis data kembali ke objek Peristiwa,untuk digunakan oleh tugas berikutnya atau untuk membentuk data output integrasi.

Tabel berikut meringkas berbagai jenis variabel dan perilakunya:

Jenis variabel	Deskripsi	Perilaku	Contoh
Variabel config	Menyimpan data konfigurasi integrasi.	Ditetapkan pada waktu desain dan dapat diedit saat Anda memublikasikan integrasi.	Alamat email target untuk notifikasi.
Variabel sistem	Dibuat secara otomatis oleh sistem.	Hanya baca dan tidak dapat diedit.	Variabel ExecutionId.
Variabel integrasi	Melacak data selama eksekusi integrasi secara keseluruhan.	Ditetapkan secara eksplisit dalam integrasi Anda dan dapat diedit selama eksekusi integrasi.	Variabel untuk menyimpan hasil tugas.
Variabel tugas	Menyimpan output tugas tertentu.	Ditetapkan secara implisit dengan menjalankan tugas dan tidak dapat diedit.	Variabel responseBody dari tugas Call REST Endpoint.

Referensi variabel

Tugas, pemicu, dan tepi dalam integrasi membaca dan menulis ke variabel menggunakan referensi variabel. Referensi variabel memiliki bentuk $paramKey$ dengan paramKey adalah nama variabel.

$isNameUnique$ = true AND $numAccounts$ >= 1

Contoh:

• Kondisi tepi dapat terlihat seperti ini:

  $isNameUnique$ = true AND $numAccounts$ >= 1

  Dalam contoh ini, isNameUnique adalah variabel jenis data boolean dan numAccounts adalah parameter jenis data integer.

• Anda dapat membuat notifikasi email untuk pendaftaran pengguna baru dalam alur kerja Integrasi Aplikasi. Misalnya Anda memiliki dua variabel:
  • $userName$: Berisi nama pengguna baru (misalnya, "Alex").
  • $orderID$: Berisi ID pesanan unik (misalnya, "ORD-12345").

  Template untuk isi email dapat berupa:

  Hello $userName$, thank you for your order! Your order ID is $orderID$.

  Saat pesan ini dikirim, sistem akan mengganti referensi variabel dengan nilai yang sesuai. Pesan terakhirnya adalah:

  Hello Alex, thank you for your order! Your order ID is ORD-12345.

Anda dapat menggunakan referensi variabel di tempat berikut:

• Parameter tugas
• Parameter pemicu
• Kondisi ekstrem

Saat merujuk ke variabel tugas atau yang dibuat otomatis, Anda harus menggunakan nama lengkap dan uniknya, yang mencakup tanda petik terbalik dan ID Tugas, dalam pembatas tanda dolar. Misalnya, untuk merujuk pada output responseBody dari tugas Call REST Endpoint dengan ID Task_5, Anda harus menggunakan $`Task_5_responseBody`$.

Kuota dan batas

Untuk mengetahui informasi tentang kuota dan batas, lihat Kuota dan batas.

Langkah berikutnya

• Pelajari cara membangun CI/CD untuk integrasi Anda.
• Pelajari cara menyamarkan data sensitif di log.
• Menambahkan dan mengonfigurasi tugas Pemetaan Data