Tugas Integrasi Panggilan

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

Tugas Call Integration memungkinkan Anda memanggil atau memanggil integrasi lain yang dibuat dalam project Google Cloud.

Tugas Call Integration 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 baca 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 dipanggil dikonfigurasi menggunakan pemicu API. Untuk informasi tentang mengonfigurasi pemicu API, lihat Pemicu API.
• Pastikan Anda telah melampirkan akun layanan yang dikelola pengguna ke integrasi Anda. Jika integrasi Anda tidak memiliki akun layanan yang dikelola pengguna yang dikonfigurasi, akun layanan default (service-PROJECT_NUMBER@gcp-sa-apigee.) akan digunakan untuk autentikasi secara default.
• Pastikan akun layanan Anda memiliki peran IAM Application Integration Invoker. Untuk mengetahui informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Mengonfigurasi tugas Integrasi Panggilan

Untuk mengonfigurasi tugas Call Integration:

1. Di UI Apigee, pilih Organisasi Apigee Anda.
2. Klik Develop > Integrasi.
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 Call Integration panel konfigurasi tugas.
7. Konfigurasikan detail subintegrasi berikut:
   1. ID Pemicu API: Ketik 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 API yang sama ID Pemicu, baik integrasi A maupun B dijalankan.

      Catatan: Jika Anda memilih opsi ini, respons dari sub-integrasi tidak akan tersedia di integrasi utama. Jika Anda ingin mengakses respons sub-integrasi, pilih opsi Run a single integration.
   3. Jalankan satu integrasi: Pilih opsi ini untuk hanya memanggil integrasi yang ditentukan di Kolom Integrasi name. Anda dapat mengakses dan memetakan respons dari sub-integrasi dengan mengonfigurasi kolom yang dijelaskan di Memetakan variabel respons sub-integrasi.

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

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

        Jika opsi ini dipilih, tetapkan Penundaan eksekusi (dalam milidetik). Jika ditetapkan, atribut ini menentukan penundaan 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. Ruang isian ini menggunakan nilai dalam bentuk pasangan nilai-kunci, 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 variabel Integrasi yang akan dipetakan dan masukkan subIntProductID di Input subintegrasi yang akan dipetakan ke kolom.
Map values to sub-integration output(s)	Memetakan variabel output sub-integrasi ke variabel integrasi utama. Klik Output subintegrasi 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

Untuk mengetahui informasi tentang batas penggunaan yang berlaku bagi 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 informasi tentang cara menggunakan strategi penanganan error, dan mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.