Bagikan melalui


Mengubah data dengan aktivitas ForEach

Aktivitas ForEach mendefinisikan alur kontrol berulang dalam alur Microsoft Fabric. Aktivitas ini digunakan untuk iterasi atas koleksi dan menjalankan tugas tertentu dalam perulangan. Implementasi perulangan dari aktivitas ini mirip dengan struktur perulangan ForEach dalam bahasa pemrograman.

Menambahkan aktivitas ForEach ke alur

Bagian ini menjelaskan cara menggunakan aktivitas ForEach dalam alur.

Prasyarat

Untuk memulai, Anda harus menyelesaikan prasyarat berikut:

Membuat aktivitas

  1. Buat alur baru di ruang kerja Anda.

  2. Cari ForEach di panel Aktivitas dalam alur kerja, dan pilih agar menambahkannya ke kanvas alur kerja. Jika Anda tidak dapat melihatnya pada awalnya, gunakan panah di sisi kanan toolbar aktivitas untuk menggulir ke kanan untuk menemukannya.

    Cuplikan layar UI Fabric dengan panel Aktivitas dan aktivitas ForEach disorot.

  3. Pilih aktivitas ForEach baru di kanvas jika belum dipilih.

    Cuplikan layar memperlihatkan tab Pengaturan umum aktivitas ForEach.

  4. Di tab Umum di bagian bawah kanvas, masukkan nama untuk aktivitas di properti Nama.

  5. (Opsional) Anda juga dapat memasukkan deskripsi.

Pengaturan ForEach

Pilih tab Pengaturan, tempat Anda dapat menentukan apakah pemrosesan item dalam batch harus Berurutan (atau pilihan lainnya secara paralel). Anda juga dapat menentukan jumlah maksimum item yang akan diproses secara bersamaan dengan jumlah batch . Terakhir, Anda harus menentukan daftar Item yang dibatasi koma, yang dapat diparameterkan atau menyertakan konten dinamis. Tambahkan beberapa item ke daftar Item seperti yang diperlihatkan dalam contoh.

Cuplikan layar memperlihatkan tab pengaturan ForEach dengan beberapa item ditambahkan ke daftar Item.

Aktivitas ForEach

Anda juga menentukan aktivitas atau aktivitas-aktivitas yang akan dilakukan pada setiap item dalam daftar, di panel ForEach Aktivitas.

Cuplikan layar memperlihatkan panel aktivitas ForEach.

Pilih tombol + untuk menambahkan aktivitas baru ke panel. Anda akan melihat daftar aktivitas yang akan dipilih. Anda dapat menambahkan beberapa aktivitas ke aktivitas ForEach, dan masing-masing dijalankan pada setiap item dalam daftar Item. Apakah opsi Berurutan dipilih dalam pengaturan ForEach atau tidak, setiap aktivitas anak di panel aktivitas ForEach diproses secara berurutan untuk setiap item. Namun, jika Berurutan tidak dipilih, beberapa item diproses secara paralel, masing-masing berjalan secara berurutan melalui daftar aktivitas anak yang ditentukan.

Cuplikan layar memperlihatkan aktivitas ForEach dengan beberapa aktivitas anak yang ditentukan, dan tombol + disorot memperlihatkan daftar aktivitas anak yang akan dipilih saat menambahkan aktivitas baru ke panel.

Mereferensikan item dalam aktivitas

Pilih salah satu aktivitas anak di panel Aktivitas ForEach, dan beralih ke tab Pengaturan . Dalam contoh ini, aktivitas Prosedur Tersimpan dipilih. Isi pengaturan untuk aktivitas seperti biasa dengan memilih koneksi dan prosedur tersimpan. Anda dapat menggunakan @item() iterator untuk merujuk ke item saat ini yang sedang diproses di mana saja dalam aktivitas yang mendukung konten dinamis. Di sini, @item() digunakan sebagai nilai untuk parameter FruitName yang diteruskan ke prosedur tersimpan.

Cuplikan layar memperlihatkan aktivitas anak dari prosedur tersimpan dengan parameter yang menggunakan @item() saat ini dari daftar item ForEach sebagai nilainya.