Lihat konektor yang didukung untuk Application Integration.

Untuk setiap tugas Paralel

Tugas Untuk Setiap Paralel memungkinkan Anda menjalankan integrasi lain (sub-integrasi) dari integrasi utama Anda. Sesuai dengan nama tugas, sub-integrasi berjalan secara paralel.

Tugas ini menggunakan ID Pemicu API sebagai handle 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 dalam integrasi utama Anda. Gunakan tugas ini untuk menjalankan sub-integrasi sebagai dependensi dari integrasi utama.

Sebelum memulai

Mengonfigurasi tugas Untuk Setiap Paralel

Untuk mengonfigurasi tugas For Every Parallel:

  1. Di konsol Google Cloud, buka halaman Application Integration.

    Buka Application Integration

  2. Di menu navigasi, klik Integrasi.

    Halaman Integrations akan muncul dan mencantumkan semua integrasi yang tersedia di project Google Cloud.

  3. Pilih integrasi yang ada atau klik Buat integrasi untuk membuat integrasi baru.

    Jika Anda membuat integrasi baru:

    1. Masukkan nama dan deskripsi di panel Create Integration.
    2. Pilih region untuk integrasi.
    3. Pilih akun layanan untuk integrasi. Anda dapat mengubah atau memperbarui detail akun layanan integrasi kapan saja dari panel Integration summary di toolbar integrasi.
    4. Klik Create.

    Tindakan ini akan membuka integrasi di editor integrasi.

  4. Di menu navigasi editor integrasi, klik Tasks untuk melihat daftar tugas yang tersedia.
  5. Klik dan tempatkan elemen tugas For Every Parallel di editor integrasi.
  6. Klik elemen tugas For Every Parallel pada desainer untuk membuka panel konfigurasi tugas For Every Parallel.
  7. Konfigurasikan kolom yang ditampilkan menggunakan Properti konfigurasi untuk tugas seperti yang dijelaskan dalam tabel di bawah.

    Semua perubahan pada properti disimpan secara otomatis.

Properti konfigurasi

Bagian ini menjelaskan properti konfigurasi tugas Untuk Tiap Paralel.

Properti input

Nama Properti Nama Parameter Data type Deskripsi
Pilihan Array List to iterate Array jenis string, integer, double, atau JSON. Daftar nilai yang harus dijalankan oleh sub-integrasi. Thread sub-integrasi terpisah berjalan untuk setiap nilai dalam daftar, dan semua thread berjalan secara paralel.

Anda dapat meneruskan nilai iterasi ke sub-integrasi dengan menetapkan kolom Tempat memetakan setiap elemen array.

Anda juga dapat meneruskan nilai tambahan dari integrasi utama ke sub-integrasi di kolom Peta ke input sub-integrasi tambahan.

Detail Sub-integrasi API Trigger ID String ID pemicu dari sub-integrasi yang dipublikasikan untuk dijalankan.

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

Execution strategy T/A

SYNC: Menjalankan sub-integrasi dalam mode sinkron. Dalam mode ini, integrasi utama menunggu hingga sub-integrasi selesai sebelum melanjutkan tugas downstream.

ASYNC: Menjalankan sub-integrasi dalam mode asinkron. Dalam mode ini, integrasi utama tidak menunggu hingga 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 dalam Daftar yang akan diiterasi.

Catatan: Jika Anda memilih opsi ini, respons dari sub-integrasi tidak akan tersedia dalam integrasi utama. Jika Anda ingin menggunakan respons sub-integrasi, pilih opsi Run a single integration.

Run a single integration T/A Hanya menjalankan integrasi yang ditentukan dalam kolom Integration name. 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 key-value pair, dengan kunci adalah variabel dalam integrasi utama, dan nilainya adalah variabel input yang sesuai dalam sub-integrasi.

Misalnya, anggaplah integrasi utama Anda memiliki variabel productID, yang ingin Anda petakan ke variabel sub-integrasi subIntProductID; Anda harus memilih productID dari kolom Integration variable to map from, lalu masukkan subIntProductID di kolom Input sub-integrasi untuk dipetakan ke.

Collect values from sub-integration output(s) String Jika strategi eksekusi bersifat sinkron (SYNC) dan satu sub-integrasi (Jalankan integrasi tunggal) 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 sebuah kelompok berjalan sepenuhnya sebelum kelompok sub-integrasi berikutnya dijalankan.

Ignore failures Boolean

Anda dapat menentukan salah satu nilai berikut:

  • Benar: Tugas mengabaikan kegagalan sub-integrasi dan menjalankan semua eksekusi.
  • Salah: Tugas gagal untuk kegagalan sub-integrasi dan mengakhiri semua eksekusi.

Praktik terbaik

Sebaiknya gunakan praktik terbaik berikut saat menggunakan tugas Untuk Tiap Paralel:

  • Tetapkan ukuran kelompok Anda 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 mungkin berjalan lebih dari 2 menit.

Guna mengetahui informasi tentang batas penggunaan yang berlaku untuk tugas Untuk Setiap Paralel, lihat Batas penggunaan.

Pertimbangan

Secara umum, jangan gunakan strategi eksekusi SYNC jika sub-integrasi membutuhkan waktu lebih dari 2 menit untuk dijalankan atau Anda berencana menggunakan tugas ini bersamaan 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 mendapatkan informasi tentang cara menggunakan strategi penanganan error, dan mengetahui berbagai jenis strategi penanganan error, lihat Strategi penanganan error.