Lihat konektor yang didukung untuk Integration Aplikasi.

Tugas For Each Loop

Tugas For Each Loop memungkinkan Anda melakukan panggilan berulang ke sub-integrasi dari integrasi (utama) saat ini. Tugas ini melakukan iterasi pada variabel array yang dikonfigurasi dan memanggil sub-integrasi untuk setiap elemen dalam array. Frekuensi sub-integrasi dipanggil sama dengan ukuran variabel array.

API Trigger ID dan Integration name mengidentifikasi sub-integrasi yang ingin Anda jalankan.

Tugas ini juga memungkinkan Anda mengumpulkan respons dari setiap sub-integrasi yang dijalankan dan menyimpan nilai dalam integrasi saat ini untuk digunakan dalam tugas downstream. Anda dapat menggunakan salah satu pendekatan berikut untuk mengumpulkan respons:

  • Gabungkan respons dari setiap operasi dalam variabel array, dengan setiap elemen array memiliki respons dari satu operasi tertentu. Untuk menggabungkan respons, konfigurasikan properti Collect values from sub-integration output(s).
  • Gabungkan respons dari semua operasi dalam satu variabel. Untuk menggabungkan respons, konfigurasikan properti Response parameter override mapping.

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 (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) 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.

Properti konfigurasi

Tabel berikut menjelaskan properti konfigurasi tugas For Each Loop.

Properti Data type Deskripsi
API Trigger ID String ID pemicu sub-integrasi yang akan dijalankan.

Nilai ini tersedia di kolom ID Pemicu pada Pemicu API di sub-integrasi.

Integration name String Nama sub-integrasi yang akan dijalankan.
List to iterate Array dari jenis Boolean, String, Integer, Double, atau JSON. Daftar nilai yang akan dijalankan sub-integrasi. Sub-integrasi berjalan untuk setiap nilai dalam daftar, satu per satu.

Anda dapat meneruskan nilai yang diiterasi ke sub-integrasi dengan menetapkan properti Pemetaan sub-integrasi elemen iterasi. Di properti ini, tentukan variabel dalam sub-integrasi tempat nilai yang di-iterasi harus dipetakan.
Iteration element sub-integration mapping T/A Variabel dalam sub-integrasi yang elemen iterasinya saat ini harus ditetapkan.
Map to additional sub-integration input(s) T/A Nilai tambahan yang akan diteruskan dari integrasi saat ini ke sub-integrasi.

Nilai properti ini berupa pasangan nilai kunci, dengan kunci adalah variabel dalam integrasi saat ini, dan nilainya adalah variabel input yang sesuai dalam sub-integrasi. Misalnya, integrasi utama Anda memiliki variabel productID, yang ingin dipetakan ke variabel sub-integrasi subIntProductID; Anda akan memilih productID dari drop-down Variabel integrasi untuk dipetakan dari dan memilih subIntProductID di drop-down Input sub-integrasi untuk dipetakan ke.

Collect values from sub-integration output(s) T/A Gabungkan hasil dari sub-integrasi yang berjalan.

Setiap kali sub-integrasi berjalan, Anda dapat menyimpan output sub-integrasi dalam variabel array integrasi saat ini. Pilih variabel output sub-integrasi dari drop-down Output sub-integrasi untuk dikumpulkan dari dan variabel array dalam integrasi saat ini dari drop-down Variabel integrasi untuk dikumpulkan ke dalam. Setiap elemen array memiliki respons dari sub-integrasi tertentu yang dijalankan. Misalnya, jika variabel array adalah resultsArray, resultsArray[0] memiliki respons dari operasi pertama dan resultsArray[1] memiliki respons dari operasi kedua.
Response parameter override mapping T/A Baca variabel output dari sub-integrasi yang dijalankan dan simpan dalam variabel integrasi saat ini.

Pilih variabel output sub-integrasi dari drop-down Output sub-integrasi yang akan dipetakan, dan pilih variabel yang sesuai dalam integrasi saat ini dari drop-down Variabel integrasi yang akan diganti. Anda dapat mengirim variabel yang diganti dalam integrasi saat ini ke sub-integrasi berikutnya yang dijalankan dengan memetakan variabel di properti Peta ke input sub-integrasi tambahan. Akibatnya, Anda dapat menggabungkan respons secara kumulatif dari sub-integrasi yang berjalan.
Loop metadata Array JSON Variabel output yang memiliki detail eksekusi sub-integrasi seperti ID eksekusi sub-integrasi, pesan error, dan nilai variabel yang diteruskan selama eksekusi. Metadata loop berisi variabel termasuk variabel output berikut: current_iteration_count, sub_integration_execution_ids, failure_location, current_element, iteration_element, dan failure_message.

Praktik terbaik

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

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