Lihat konektor yang didukung untuk Integration Aplikasi.

Tugas For Each Parallel

Tugas For Each Parallel memungkinkan Anda menjalankan integrasi lain (sub-integrasi) dari integrasi utama. Seperti namanya, sub-integrasi berjalan secara paralel.

Tugas ini menggunakan ID Pemicu API sebagai nama sebutan untuk mengidentifikasi integrasi yang akan dijalankan. Misalnya, jika Anda menentukan ID Pemicu API sebagai api_trigger/APITriggerX, tugas akan menjalankan semua sub-integrasi yang memiliki ID pemicu api_trigger/APITriggerX.

Setelah menjalankan sub-integrasi, Anda juga dapat membaca respons sub-integrasi di integrasi utama. Gunakan tugas ini untuk menjalankan sub-integrasi sebagai dependensi integrasi utama.

Sebelum memulai

• Pastikan Anda telah melampirkan akun layanan yang dikelola pengguna ke integrasi. Jika integrasi Anda tidak memiliki akun layanan yang dikelola pengguna yang dikonfigurasi, secara default akun layanan default ([e-mail]) akan digunakan untuk autentikasi.
• 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 For Each Parallel

Untuk mengonfigurasi tugas For Each Parallel:

1. Di konsol Google Cloud, buka halaman Integrasi Aplikasi.

   Buka Application Integration

2. Di menu navigasi, klik Integrations.

   Halaman Integrasi akan muncul yang 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: Drop-down Regions hanya mencantumkan region yang disediakan di project Google Cloud Anda. Untuk menyediakan wilayah baru, klik Aktifkan Wilayah. Lihat Mengaktifkan region baru untuk 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 Create.

   Tindakan ini akan membuka integrasi di editor integrasi.

4. Di menu navigasi editor integrasi, klik Tugas untuk melihat daftar tugas dan konektor yang tersedia.
5. Klik dan tempatkan elemen tugas For Each Parallel di editor integrasi.
6. Klik elemen tugas For Each Parallel di desainer untuk membuka panel konfigurasi tugas For Each Parallel.
7. Konfigurasikan kolom yang ditampilkan menggunakan Properti konfigurasi untuk tugas seperti yang dijelaskan dalam tabel di bawah.

   Semua perubahan pada properti akan disimpan secara otomatis.

Properti konfigurasi

Bagian ini menjelaskan properti konfigurasi tugas For Each Parallel.

Properti input

Nama Properti	Nama Parameter	Data type	Deskripsi
Pilihan Array	List to iterate	Array dari jenis string, bilangan bulat, ganda, atau JSON.	Daftar nilai yang harus dijalankan sub-integrasi. Thread sub-integrasi terpisah berjalan untuk setiap nilai dalam daftar, dan semua thread berjalan secara paralel. Anda dapat meneruskan nilai yang diiterasi ke sub-integrasi dengan menetapkan kolom Tempat memetakan setiap elemen array. Anda juga dapat meneruskan nilai tambahan dari integrasi utama ke sub-integrasi di kolom Pemetaan ke input sub-integrasi tambahan.
Detail Sub-integrasi	API Trigger ID	String	ID pemicu sub-integrasi yang dipublikasikan untuk dijalankan. Nilai ini tersedia di kolom ID Pemicu pada Pemicu API di sub-integrasi.
	Execution strategy	T/A	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 akan menjalankan tugas downstream.
	Run all integrations with this API Trigger ID	T/A	Menjalankan 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 untuk setiap item dalam Daftar untuk di-iterasi. Catatan: Jika Anda memilih opsi ini, respons dari sub-integrasi tidak akan tersedia di integrasi utama. Jika Anda ingin menggunakan respons sub-integrasi, pilih opsi Jalankan satu integrasi.
	Run a single integration	T/A	Hanya menjalankan integrasi yang ditentukan di kolom Nama integrasi. Anda dapat menggunakan respons dari sub-integrasi dengan mengonfigurasi bagian Kumpulkan nilai dari output sub-integrasi.
Pada setiap eksekusi	Where to map individual array elements	String	Nama variabel input sub-integrasi tempat elemen array harus dipetakan. Elemen array dapat dipetakan langsung ke variabel input sub-integrasi. Jika satu sub-integrasi dipilih, Anda dapat memilih variabel input sub-integrasi dari daftar dropdown.
	Map to additional sub-integration input(s)	String	Opsi pemetaan sub-integrasi tambahan. Variabel integrasi yang akan dipetakan: Nama variabel dalam integrasi saat ini yang akan diteruskan ke variabel input sub-integrasi. Input sub-integrasi yang akan dipetakan: Nama variabel input sub-integrasi yang akan dipetakan. Kolom ini menggunakan nilai dalam bentuk pasangan nilai kunci, dengan kunci adalah variabel dalam integrasi utama, dan nilai adalah variabel input yang sesuai dalam sub-integrasi. Misalnya, anggap integrasi utama Anda memiliki variabel productID, yang ingin Anda petakan ke variabel sub-integrasi subIntProductID; Anda harus memilih productID dari kolom Variabel integrasi untuk dipetakan dari dan memasukkan subIntProductID di kolom Input sub-integrasi untuk dipetakan ke.
	Collect values from sub-integration output(s)	String	Jika strategi eksekusi bersifat sinkron (SYNC) dan satu sub-integrasi (Jalankan satu integrasi) dipilih, output sub-integrasi dapat dikumpulkan ke dalam variabel array dalam integrasi saat ini. Output sub-integrasi yang akan dikumpulkan: Nama variabel output sub-integrasi yang akan digabungkan. Variabel integrasi yang akan dikumpulkan: Nama variabel dalam integrasi saat ini untuk mengumpulkan output gabungan.
Setelan Eksekusi	Integrations to execute at a time (parallel)	Bilangan bulat	Jumlah maksimum eksekusi paralel yang diizinkan untuk sub-integrasi. Nilai defaultnya adalah 50 (maksimum 10000). Semua sub-integrasi dalam kohor berjalan sepenuhnya sebelum kohor sub-integrasi berikutnya berjalan.
	Ignore failures	Boolean	Anda dapat menentukan salah satu nilai berikut: Benar: Tugas mengabaikan kegagalan sub-integrasi dan menjalankan semua eksekusi. Salah: Tugas gagal karena kegagalan sub-integrasi dan mengakhiri semua eksekusi.

Praktik terbaik

Sebaiknya lakukan praktik terbaik berikut saat menggunakan tugas For Each Parallel:

• Tetapkan ukuran kelompok berdasarkan batasan kuota yang diberlakukan oleh sub-integrasi Anda.
• Gunakan strategi eksekusi SYNC saat Anda ingin mengumpulkan output sub-integrasi untuk digunakan nanti.
• Gunakan strategi eksekusi ASYNC jika sub-integrasi Anda mungkin berjalan lebih dari 2 menit.

Untuk mengetahui informasi tentang batas penggunaan yang berlaku untuk tugas For Each Parallel, lihat Batas penggunaan.

Pertimbangan

Secara umum, jangan gunakan strategi eksekusi SYNC jika sub-integrasi Anda memerlukan waktu lebih dari 2 menit untuk dijalankan atau Anda berencana menggunakan tugas ini bersama dengan tugas asinkron alami seperti tugas Persetujuan.

Strategi penanganan error

Strategi penanganan error untuk tugas menentukan tindakan yang akan diambil jika tugas gagal karena error sementara. Untuk mengetahui informasi tentang cara menggunakan strategi penanganan error, dan 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 selanjutnya

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