Tugas Loop Sementara

Pengumuman: Application Integration kini telah tersedia untuk project Google Cloud Anda. Sekarang Anda dapat menggunakan Apigee Integration dan Application Integration dalam project Google Cloud yang sama. Pelajari lebih lanjut

Tugas Temporary Loop memungkinkan Anda melakukan panggilan berulang ke sub-integrasi dari integrasi (utama) saat ini sampai kondisi tertentu terpenuhi.

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

Dengan tugas ini, Anda juga dapat 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:

• Kumpulkan respons dari setiap proses dalam sebuah 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 dari semua operasi dalam satu variabel. Untuk menggabungkan respons, konfigurasikan properti Override values from sub-integration output(s).

Catatan:

• Tugas Sementara Loop dapat menjalankan maksimum 8.000 iterasi. Batasan ini berlaku meskipun kondisi yang dikonfigurasi menghasilkan loop tak terbatas.
• 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.

Sebelum memulai

• Pastikan Anda telah melampirkan akun layanan yang dikelola pengguna ke integrasi. Jika integrasi Anda tidak 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 mengetahui informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Properti konfigurasi

Tabel berikut menjelaskan properti konfigurasi tugas Sementara 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 dalam sub-integrasi.
Integration name	String	Nama sub-integrasi yang akan dijalankan.
While loop condition	T/A	Kondisi untuk menghentikan loop. Sub-integrasi berjalan hingga kondisi terpenuhi.
Map to sub-integration input(s)	T/A	Nilai yang akan diteruskan dari integrasi saat ini ke sub-integrasi. Nilai properti ini berada dalam bentuk key-value pair, dengan kuncinya 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 Anda petakan ke variabel sub-integrasi subIntProductID; Anda akan memilih productID dari drop-down Variabel integrasi untuk dipetakan dan memasukkan subIntProductID di kolom Input Sub-Integrasi untuk dipetakan.
Collect values from sub-integration output(s)	T/A	Susun hasil operasi sub-integrasi. Setiap kali sub-integrasi berjalan, Anda dapat menyimpan output sub-integrasi dalam variabel array integrasi saat ini. Masukkan variabel output sub-integrasi ke dalam kolom Output Sub-Integrasi yang akan dikumpulkan dari dan pilih variabel array dalam integrasi saat ini dari drop-down Variabel integrasi yang akan dikumpulkan ke. Setiap elemen array memiliki respons dari operasi sub-integrasi tertentu. Misalnya, jika variabel array adalah resultsArray, resultsArray[0] memiliki respons dari proses pertama dan resultsArray[1] memiliki respons dari proses kedua.
Override values from sub-integration output(s)	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 untuk dipetakan, lalu pilih variabel yang sesuai dalam integrasi saat ini dari drop-down Variabel integrasi untuk diganti. Dalam integrasi saat ini, 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 dari sub-integrasi yang dijalankan secara kumulatif.
Loop metadata	Array JSON	Variabel output yang memiliki detail eksekusi sub-integrasi berjalan seperti ID eksekusi sub-integrasi, pesan error, dan nilai variabel yang diteruskan selama eksekusi.

Praktik terbaik

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

Strategi penanganan error

Strategi penanganan error untuk tugas menentukan tindakan yang harus 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.