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 (service-PROJECT_NUMBER@gcp-sa-integrations.) 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:
Di Google Cloud console, buka halaman Application Integration.
Halaman Integrasi akan muncul yang mencantumkan semua integrasi yang tersedia di project Google Cloud.
Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.
Jika Anda membuat integrasi baru:
Masukkan nama dan deskripsi di panel Buat Integrasi.
Pilih region untuk integrasi.
Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Ringkasan integrasiinfo di toolbar integrasi.
Klik Buat. Integrasi yang baru dibuat akan terbuka di editor integrasi.
Di menu navigasi editor integrasi, klik Tugas untuk melihat daftar tugas dan konektor yang tersedia.
Klik dan tempatkan elemen tugas For Each Parallel di editor integrasi.
Klik elemen tugas For Each Parallel di desainer untuk membuka panel konfigurasi tugas
For Each Parallel.
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 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.
ID pemicu sub-integrasi yang dipublikasikan untuk dijalankan.
Nilai ini tersedia di kolom ID Pemicu dari 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 di 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 yang akan dipetakan dan memasukkan subIntProductID di kolom Input sub-integrasi yang akan dipetakan.
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 jika 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 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.
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-03 UTC."],[[["\u003cp\u003eThe For Each Parallel task enables the execution of multiple sub-integrations in parallel from a main integration, enhancing efficiency.\u003c/p\u003e\n"],["\u003cp\u003eThis task utilizes an API Trigger ID to identify and run the specified sub-integrations, and can run all sub-integrations with the same ID or target one specifically.\u003c/p\u003e\n"],["\u003cp\u003eYou can configure sub-integrations to run synchronously (SYNC), where the main integration waits for completion, or asynchronously (ASYNC), where it doesn't wait.\u003c/p\u003e\n"],["\u003cp\u003eThe task allows for passing data to sub-integrations and optionally collecting their output back into the main integration, but not when running multiple sub-integrations simultaneously.\u003c/p\u003e\n"],["\u003cp\u003eIt's recommended to use the SYNC strategy when the output of the sub-integration is needed, and the ASYNC strategy when sub-integrations might take longer than 2 minutes to run.\u003c/p\u003e\n"]]],[],null,["# For Each Parallel task\n\nSee the [supported connectors](/integration-connectors/docs/connector-reference-overview) for Application Integration.\n\nFor Each Parallel task\n======================\n\nThe **For Each Parallel** task lets you run other\nintegrations (sub-integrations) from your main integration. As the task name\nsuggests, the sub-integrations run in parallel.\n\nThis task uses the API **Trigger ID** as a handle to identify the integrations to run.\nFor example, if you specify the API **Trigger ID**\nas `api_trigger/APITriggerX`, the task runs all the sub-integrations that have\nthe `api_trigger/APITriggerX` trigger ID.\n\nAfter running a sub-integration, you can also\nread the response of the sub-integration in your main integration. Use this task to run sub-integrations as dependencies\nof the main integration.\n\nBefore you begin\n----------------\n\n- Ensure that you have [attached a user-managed service account](/application-integration/docs/access-control#add-service-account) to your integration. If your integration does not have user-managed service account configured, then by default the [default service account](/application-integration/docs/access-control#default-service-account) (`service-`\u003cvar translate=\"no\"\u003ePROJECT_NUMBER\u003c/var\u003e`@gcp-sa-integrations.iam.gserviceaccount.com`) is used for authentication.\n- Ensure that your service account has the **Application Integration Invoker** IAM role. For information about granting roles to a service account, see [Manage access to service accounts](/iam/docs/manage-access-service-accounts).\n\nConfigure the For Each Parallel task\n------------------------------------\n\nTo configure the **For Each Parallel** task:\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. In the navigation menu, click **Integrations** .\n\n\n The **Integrations** page appears listing all the integrations available in the Google Cloud project.\n3. Select an existing integration or click **Create integration** to create a new one.\n\n\n If you are creating a new integration:\n 1. Enter a name and description in the **Create Integration** pane.\n 2. Select a region for the integration. **Note:** The **Regions** dropdown only lists the regions provisioned in your Google Cloud project. To provision a new region, click **Enable Region** . See [Enable new region](/application-integration/docs/enable-new-region) for more information.\n 3. Select a service account for the integration. You can change or update the service account details of an integration any time from the info **Integration summary** pane in the integration toolbar. **Note:** The option to select a service account is displayed only if you have enabled integration governance for the selected region.\n 4. Click **Create** . The newly created integration opens in the *integration editor*.\n\n\n4. In the *integration editor* navigation bar, click **Tasks** to view the list of available tasks and connectors.\n5. Click and place the **For Each Parallel** task element in the integration editor.\n6. Click the **For Each Parallel** task element on the designer to open the **For Each Parallel** task configuration pane.\n7. Configure the displayed fields using the [Configuration properties](#params) for the task as detailed in the tables below.\n\n\n All changes to the properties are saved automatically.\n\nConfiguration properties\n------------------------\n\n\nThis section describes the configuration properties of\nthe **For Each Parallel** task.\n\n### Input properties\n\nBest practices\n--------------\n\nWe recommend the following best practices when using the **For Each Parallel** task:\n\n- Set your cohort size based on any quota limitations imposed by your sub-integrations.\n- Use a **SYNC** execution strategy when you want to collect the output of the sub-integration for later use.\n- Use an **ASYNC** execution strategy when your sub-integration might run longer than **2 minutes**.\n\nFor information about the usage limits that apply to the **For Each Parallel** task, see [Usage limits](/application-integration/docs/quotas#usage-limits).\n\nConsiderations\n--------------\n\nIn general, do not use a **SYNC** execution strategy if your sub-integration takes longer than **2 minutes** to run\nor you plan to use this task in conjunction with naturally asynchronous tasks like the Approval task.\n\nError handling strategy\n-----------------------\n\n\nAn error handling strategy for a task specifies the action to take if the task fails due to a [temporary error](/application-integration/docs/error-handling). For information about how to use an error handling strategy, and to know about the different types of error handling strategies, see [Error handling strategies](/application-integration/docs/error-handling-strategy).\n\nQuotas and limits\n-----------------\n\nFor information about quotas and limits, see [Quotas and limits](/application-integration/docs/quotas).\n\nWhat's next\n-----------\n\n- Learn about [all tasks and triggers](/application-integration/docs/all-triggers-tasks).\n- Learn how to [test and publish an integration](/application-integration/docs/test-publish-integrations).\n\n- Learn about [error handling](/application-integration/docs/error-handling-strategy).\n- Learn about [integration execution logs](/application-integration/docs/introduction-logs)."]]
