Tugas Integrasi Panggilan

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

Dengan tugas Call Integration, Anda dapat memanggil atau memanggil integrasi lain yang dibuat dalam project Google Cloud Anda.

Tugas Integrasi Panggilan berguna dalam skenario saat Anda perlu menentukan beberapa integrasi kecil (sub-integrasi) yang dikontrol menggunakan integrasi utama (integrasi induk). Setelah menjalankan sub-integrasi, Anda juga dapat membaca respons sub-integrasi dalam integrasi utama Anda.

Sebelum memulai

• Tugas Call Integration menggunakan pemicu API untuk mengidentifikasi dan memanggil integrasi dan sub-integrasi lainnya. Oleh karena itu, Anda harus memastikan bahwa integrasi yang ingin Anda panggil dikonfigurasi menggunakan pemicu API. Untuk mengetahui informasi tentang cara mengonfigurasi pemicu API, lihat Pemicu API.
• Pastikan Anda telah melampirkan akun layanan yang dikelola pengguna ke integrasi. Jika integrasi Anda belum mengonfigurasi akun layanan yang dikelola pengguna, akun layanan default ([e-mail]) akan digunakan untuk autentikasi secara default.
• Pastikan akun layanan Anda memiliki peran IAM Application Integration Invoker. Untuk informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Mengonfigurasi tugas Integrasi Panggilan

Untuk mengonfigurasi tugas Integrasi Panggilan:

1. Di UI Apigee, pilih Organisasi Apigee.
2. Klik Develop > Integrations.
3. Pilih integrasi yang ada atau buat integrasi baru dengan mengklik Buat Integrasi.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi dalam dialog Create Integration.
   2. Pilih Region untuk integrasi dari daftar wilayah yang didukung.
   3. Klik Create.

   Tindakan ini akan membuka integrasi di desainer integrasi.

4. Di menu navigasi desainer integrasi, klik +Tambahkan tugas/pemicu > Tasks untuk melihat daftar tugas yang tersedia.
5. Klik dan tempatkan elemen Call Integration di editor integrasi.
6. Klik elemen tugas Call Integration pada desainer untuk melihat panel konfigurasi tugas Call Integration.
7. Konfigurasikan detail subintegrasi berikut:
   1. ID Pemicu API: Ketikkan ID pemicu API dari integrasi yang ingin Anda panggil. Anda dapat memanggil satu atau beberapa integrasi dengan ID pemicu yang sama.
   2. Jalankan semua integrasi dengan ID Pemicu API ini: Pilih opsi ini untuk memanggil semua integrasi yang memiliki ID Pemicu API yang sama.

      Misalnya, jika integrasi A dan integrasi B, memiliki ID Pemicu API yang sama, integrasi A dan B akan dijalankan.

      Catatan: Jika Anda memilih opsi ini, respons dari sub-integrasi tidak akan tersedia dalam integrasi utama. Jika Anda ingin mengakses respons sub-integrasi, pilih opsi Run a single integration.
   3. Run a single integration: Pilih opsi ini untuk hanya memanggil integrasi yang ditentukan dalam kolom Integration name. Anda dapat mengakses dan memetakan respons dari sub-integrasi dengan mengonfigurasi kolom yang dijelaskan dalam Variabel respons sub-integrasi peta.

   4. Strategi eksekusi: Pilih mode eksekusi untuk sub-integrasi yang ingin Anda panggil.
      • SYNC: Menjalankan sub-integrasi dalam mode sinkron. Dalam mode ini, integrasi utama menunggu hingga sub-integrasi selesai sebelum melanjutkan tugas downstream.

      • ASYNC: Menjalankan sub-integrasi dalam mode asinkron. Dalam mode ini, integrasi utama tidak menunggu hingga sub-integrasi selesai. Segera setelah memanggil subintegrasi, integrasi utama menjalankan tugas downstream.

        Jika opsi ini dipilih, tetapkan Execution delay (in milliseconds). Jika ditetapkan, nilai ini menentukan penundaan waktu hingga integrasi dijalankan.

      Semua perubahan pada properti disimpan secara otomatis.

Memetakan variabel respons sub-integrasi

Tabel berikut menjelaskan properti konfigurasi untuk memetakan variabel antara integrasi utama dan sub-integrasi:

Properti	Deskripsi
Map to sub-integration input(s)	Memetakan nilai dari integrasi utama ke sub-integrasi. Kolom ini menggunakan nilai dalam bentuk key-value pair, dengan kunci adalah variabel dalam integrasi utama, dan nilainya adalah variabel input yang sesuai dalam sub-integrasi. Misalnya, jika Anda ingin memetakan variabel productID integrasi utama ke variabel sub-integrasi subIntProductID, pilih productID dari kolom Integration variable to map from, lalu masukkan subIntProductID di kolom Input sub-integrasi untuk dipetakan ke.
Map values to sub-integration output(s)	Memetakan variabel output sub-integrasi ke variabel integrasi utama. Klik Output sub-integrasi yang akan dipetakan, lalu pilih sub-integrasi. Klik Variabel integrasi yang akan dipetakan dan pilih variabel integrasi utama yang sesuai. Catatan: Kolom ini hanya ditampilkan jika opsi Run a single integration dipilih dengan strategi eksekusi SYNC.

Praktik terbaik

Guna mengetahui informasi tentang batas penggunaan yang berlaku untuk tugas Integrasi Panggilan, lihat Batas penggunaan.

Strategi penanganan error

Strategi penanganan error untuk tugas menentukan tindakan yang akan diambil jika tugas gagal karena error sementara. Untuk mendapatkan informasi tentang cara menggunakan strategi penanganan error, dan mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.