Lihat konektor yang didukung untuk Application Integration.

Tugas Integrasi Panggilan

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 konsol Google Cloud, buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Integrasi.

   Halaman Integrations akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

   Jika Anda membuat integrasi baru:

   1. Masukkan nama dan deskripsi di panel Create Integration.
   2. Pilih region untuk integrasi.
      Catatan: Dropdown Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan wilayah baru untuk informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary di toolbar integrasi.
      Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
   4. Klik Create.

   Tindakan ini akan membuka integrasi di editor integrasi.

4. Di menu navigasi editor integrasi, klik 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.