Menggunakan variabel dalam Integrasi Apigee

Pengumuman: Application Integration kini tersedia untuk project Google Cloud Anda. Anda kini dapat menggunakan Integrasi Apigee dan Application Integration dalam project Google Cloud yang sama. Pelajari lebih lanjut

Variabel adalah elemen integrasi yang menyimpan dan memindahkan data antara tugas, pemicu, dan tepi dari 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 untuk semua tugas, atau dapat diakses secara lokal untuk tugas tertentu.

Ada tiga jenis variabel yang tersedia:

• Variabel integrasi: Melacak data selama seluruh pelaksanaan integrasi.
• Variabel tugas: Melacak data selama durasi tugas tunggal.
• Variabel konfigurasi: Menyimpan data konfigurasi integrasi.

Variabel integrasi

Variabel integrasi 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 untuk integrasi (variabel input).
• Ditampilkan sebagai output integrasi (variabel output).
• Digunakan untuk menyimpan status sementara selama eksekusi integrasi.
Catatan: Peran variabel yang tercantum di atas tidak saling eksklusif. Setiap variabel yang ditentukan dapat berupa variabel input, variabel output, keduanya, atau tidak keduanya.

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 disediakan secara dinamis dengan pemicu, penetapan nilai dinamis akan menimpa penetapan statis.

Jenis data yang didukung untuk variabel integrasi

Jenis data berikut didukung untuk variabel integrasi:

• String dan array String
• Array bilangan bulat dan bilangan bulat
• Array Ganda dan Ganda
• Array Boolean dan Boolean
• JSON

Variabel tugas

Variabel tugas adalah variabel tugas yang telah ditetapkan secara otomatis. Jika tugas memiliki output, semua output tersebut tersedia dalam variabel tugas. Anda tidak dapat menghapus atau mengedit variabel tugas. Misalnya, untuk tugas Call REST Endpoint, isi respons disimpan dalam variabel responseBody.

Variabel konfigurasi

Pratinjau

Produk atau fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum di 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 (UM, staging, atau produksi). Anda tidak perlu memperbarui integrasi secara manual sebelum mengupload integrasi ke lingkungan baru. Application Integration memungkinkan Anda memasukkan nilai untuk variabel konfigurasi saat memublikasikan integrasi.

Untuk mempelajari cara membuat variabel konfigurasi dan menggunakannya, lihat tutorial Membangun CICD untuk integrasi Anda.

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 (Beralih panel) di menu navigasi desainer.

Gambar berikut menunjukkan contoh tata letak panel Variables:

Membuat variabel

Untuk membuat variabel, lakukan langkah-langkah berikut:

1. Di menu navigasi editor integrasi, klik (Aktifkan/nonaktifkan panel) untuk menampilkan panel Variabel.
2. Klik +Create.
3. Lakukan tindakan 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 berupa output ke pemanggil integrasi.
   Input dan Output Integrasi	Saat eksekusi, variabel akan diberikan sebagai input ke pemicu yang dieksekusi dan nilai akhirnya akan menjadi output ke pemanggil integrasi.

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

      Jenis data	Contoh
      String	Alex
      Bilangan Bulat	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 sampel payload JSON: Membuat skema JSON dari contoh payload JSON. Payload sampel 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: Menghasilkan skema JSON menggunakan nilai default yang diberikan.
      • None: Tidak ada skema JSON.
      Catatan: Kolom ini hanya ditampilkan untuk variabel jenis data JSON.
   6. Menyamarkan variabel di log (pratinjau): Pilih opsi ini untuk mengaktifkan penyamaran variabel di log eksekusi integrasi. Untuk mengaktifkan penyamaran untuk variabel, Anda harus mengaktifkan variabel penyamaran untuk integrasi dan region Anda. Untuk mengetahui informasi tentang cara mengaktifkan penyamaran untuk integrasi dan wilayah, lihat Mengedit integrasi dan Mengedit wilayah.

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

4. Klik Create.

Menggunakan data variabel dalam integrasi

Selama eksekusi integrasi, data runtime 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 yang masuk diteruskan ke tugas berdasarkan konfigurasi Anda. Saat integrasi dijalankan, tugas akan membaca dan menulis data kembali ke objek Peristiwa,yang akan digunakan oleh tugas berikutnya atau untuk membentuk data output integrasi.