Tugas Integrasi Panggilan

Tugas Call Integration memungkinkan Anda memanggil atau memicu 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.

Sebelum memulai

• Tugas Integrasi Panggilan 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 Anda. Jika integrasi Anda tidak memiliki akun layanan yang dikelola pengguna yang dikonfigurasi, maka secara default akun layanan default ([e-mail]) akan digunakan untuk autentikasi.
• 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 Integrasi Panggilan:

1. Di konsol Google Cloud , buka halaman Application Integration.

   Buka Application Integration

2. Di menu navigasi, klik Integrasi.

   Halaman Integrasi 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 Buat Integrasi.
   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 region baru untuk mengetahui informasi selengkapnya.
   3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasi di toolbar integrasi.
      Catatan: Opsi untuk memilih akun layanan hanya ditampilkan jika Anda telah mengaktifkan tata kelola integrasi untuk wilayah yang dipilih.
   4. Klik Buat. Integrasi yang baru dibuat akan terbuka di editor integrasi.

4. Di menu navigasi editor integrasi, klik Tugas untuk melihat daftar tugas dan konektor yang tersedia.
5. Klik dan tempatkan elemen Call Integration di editor integrasi.
6. Klik elemen tugas Call Integration di perancang untuk melihat panel konfigurasi tugas Call Integration.
7. Konfigurasikan detail sub-integrasi berikut:
   1. ID Pemicu API: Ketik ID pemicu API 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 di integrasi utama. Jika Anda ingin mengakses respons sub-integrasi, pilih opsi Jalankan satu integrasi.
   3. Jalankan satu integrasi: Pilih opsi ini untuk memanggil hanya integrasi yang ditentukan di kolom Nama integrasi. Anda dapat mengakses dan memetakan respons dari sub-integrasi dengan mengonfigurasi kolom yang dijelaskan dalam Memetakan variabel respons sub-integrasi.

   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 hilir.

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

        Jika opsi ini dipilih, tetapkan Penundaan eksekusi (dalam milidetik). Jika ditetapkan, opsi ini akan menentukan penundaan waktu hingga integrasi dijalankan.

      Semua perubahan pada properti akan 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 mengambil nilai dalam bentuk pasangan nilai kunci, dengan kunci adalah variabel dalam integrasi utama, dan nilai 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 Variabel integrasi yang akan dipetakan dari dan masukkan subIntProductID di kolom Input sub-integrasi yang akan 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, lalu pilih variabel integrasi utama yang sesuai. Catatan: Kolom ini hanya ditampilkan jika opsi Jalankan satu integrasi dipilih dengan strategi eksekusi SYNC.

Praktik terbaik

Untuk 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 harus dilakukan jika tugas gagal karena error sementara. Untuk mengetahui informasi tentang cara menggunakan strategi penanganan error, dan untuk mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.

Kuota dan batas

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

Langkah berikutnya

• Pelajari semua tugas dan pemicu.
• Pelajari cara menguji dan memublikasikan integrasi.
• Pelajari penanganan error.
• Pelajari log eksekusi integrasi.