Tugas For Each Loop

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 For Setiap Loop memungkinkan Anda melakukan panggilan berulang ke sub-integrasi dari integrasi (utama) Anda saat ini. Tugas ini melakukan iterasi pada variabel array yang dikonfigurasi dan memanggil sub-integrasi untuk setiap elemen dalam array. Berapa kali dipanggil sub-integrasi sama dengan ukuran variabel array.

ID Pemicu API dan Nama integrasi mengidentifikasi sub-integrasi yang Anda ingin dijalankan.

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

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

Catatan:

• Tugas For Setiap Loop dapat menjalankan maksimum 8.000 iterasi.
• Ukuran kumulatif data yang dikumpulkan dari setiap proses sub-integrasi tidak boleh melebihi 50 MB. Jika ukurannya melebihi 50 MB, integrasi akan gagal, dan tugas downstream tidak berjalan.
• Jika integrasi dalam tugas For Setiap Loop gagal, maka seluruh tugas akan gagal, dan tugas downstream tidak berjalan. Untuk mencegah kegagalan seluruh integrasi, Anda dapat menentukan Execution strategy untuk tugas di Join configuration pane. Lihat Gabung untuk mengetahui detail selengkapnya.

Sebelum memulai

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

Properti konfigurasi

Tabel berikut menjelaskan properti konfigurasi tugas For Setiap Loop.

Properti	Data type	Deskripsi
API Trigger ID	String	ID Pemicu sub-integrasi untuk dijalankan. Nilai ini tersedia di kolom ID Pemicu pada Pemicu API dalam sub-integrasi.
Integration name	String	Nama sub-integrasi yang akan dijalankan.
List to iterate	Array jenis Boolean, String, Bilangan Bulat, Ganda, atau JSON.	Daftar nilai tempat sub-integrasi harus dijalankan. Tujuan 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 di sub-integrasi tempat nilai yang diiterasi harus dipetakan.
Iteration element sub-integration mapping	T/A	Variabel dalam sub-integrasi yang harus ditetapkan elemen iterasi saat ini.
Map to additional sub-integration input(s)	T/A	Nilai tambahan yang akan diteruskan dari integrasi saat ini ke sub-integrasi. Nilai properti ini berbentuk pasangan nilai kunci, dengan kunci berupa variabel dalam integrasi saat ini, dan nilainya adalah variabel input yang sesuai dalam sub-integrasi. Sebagai contoh, misalkan integrasi utama Anda memiliki variabel productID, yang ingin Anda petakan ke Variabel sub-integrasi subIntProductID; Anda akan pilih productID dari variabel Integrasi yang akan dipetakan dan pilih subIntProductID di menu Input subintegrasi yang akan dipetakan ke.
Collect values from sub-integration output(s)	T/A	Menyusun hasil dari proses sub-integrasi. Setiap kali sub-integrasi berjalan, Anda dapat menyimpan output sub-integrasi dalam variabel array integrasi saat ini. Pilih variabel output sub-integrasi dari Output sub-integrasi yang akan dikumpulkan dan variabel array dalam integrasi saat ini dari Variabel integrasi untuk dikumpulkan ke dalam drop-down. Setiap elemen array memiliki respons dari dan menjalankan sub-integrasi tertentu. Misalnya, jika variabel array adalah resultsArray, resultsArray[0] memiliki respons dari proses pertama dan resultsArray[1] memiliki respons dari proses kedua.
Response parameter override mapping	T/A	Membaca variabel output dari proses sub-integrasi dan menyimpannya dalam variabel integrasi saat ini. Pilih variabel output sub-integrasi dari Output sub-integrasi yang ingin dipetakan lalu pilih variabel yang sesuai dalam integrasi saat ini dari Drop-down Variabel integrasi untuk diganti. Anda dapat mengirim variabel yang diganti dalam integrasi saat ini ke sub-integrasi berikutnya yang dijalankan dengan memetakan variabel di menu Peta ke sub-integrasi tambahan input. Hasilnya, Anda dapat menggabungkan respons secara kumulatif dari sub-integrasi.
Loop metadata	Array JSON	Variabel output yang memiliki detail eksekusi dari sub-integrasi seperti sub-integrasi ID eksekusi, 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. Peringatan: Di metadata Loop, Anda akan menemukan kunci duplikat untuk variabel output, misalnya, Current Iteration Count dan current_iteration_count. Sebaiknya gunakan variabel yang berisi simbol garis bawah (_) karena kunci lainnya tidak digunakan lagi.

Praktik terbaik

Untuk informasi tentang batas penggunaan yang berlaku pada tugas Untuk Setiap Loop, 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.