Tugas While Loop

Tugas While Loop memungkinkan Anda melakukan panggilan berulang ke sub-integrasi dari integrasi saat ini (utama) hingga kondisi yang ditentukan terpenuhi.

ID Pemicu API dan Nama integrasi 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 hilir. Anda dapat menggunakan salah satu pendekatan berikut untuk mengumpulkan respons:

  • Gabungkan respons setiap proses dalam variabel array, dengan setiap elemen array memiliki respons dari satu proses tertentu. Untuk mengumpulkan respons, konfigurasi properti Collect values from sub-integration output(s).
  • Gabungkan respons semua proses dalam satu variabel. Untuk menggabungkan respons, konfigurasi properti Override values from sub-integration output(s).

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, maka 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 mengetahui informasi tentang cara memberikan peran ke akun layanan, lihat Mengelola akses ke akun layanan.

Properti konfigurasi

Tabel berikut menjelaskan properti konfigurasi tugas While Loop.

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

Nilai ini tersedia di kolom ID Pemicu dari 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. Misalnya, $loopMetadata.current_iteration_count$< 10.
Map to sub-integration input(s) T/A Nilai yang akan diteruskan dari integrasi saat ini ke sub-integrasi.

Nilai properti ini dalam bentuk pasangan nilai kunci, dengan kunci adalah variabel dalam integrasi saat ini, dan nilai 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 yang akan dipetakan dari dan memasukkan subIntProductID di kolom Input Sub-Integrasi yang akan dipetakan ke.

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

Setiap kali sub-integrasi berjalan, Anda dapat menyimpan output sub-integrasi dalam variabel array integrasi saat ini. Masukkan variabel output sub-integrasi di kolom Output sub-integrasi yang akan dikumpulkan dan pilih variabel array di integrasi saat ini dari drop-down Variabel integrasi yang akan dikumpulkan. Setiap elemen array memiliki respons dari jalankan sub-integrasi tertentu. Misalnya, jika variabel array adalah resultsArray, resultsArray[0] memiliki respons dari run pertama dan resultsArray[1] memiliki respons dari run kedua.

Override values from sub-integration output(s) T/A Baca variabel output dari sub-integrasi yang berjalan dan simpan dalam variabel integrasi saat ini.

Pilih variabel output sub-integrasi dari menu drop-down Output sub-integrasi yang akan dipetakan dari, dan pilih variabel yang sesuai di integrasi saat ini dari menu drop-down Variabel integrasi yang akan diganti. Anda dapat mengirim variabel yang diganti dalam integrasi saat ini ke sub-integrasi berikutnya dengan memetakan variabel di properti Map to additional sub-integration input(s). Dengan demikian, Anda dapat mengagregasi respons secara kumulatif dari proses sub-integrasi.
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. 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 While Loop, 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