ForEach etkinliğiyle verileri dönüştürme

ForEach Etkinliği, Bir Microsoft Fabric işlem hattında yinelenen bir denetim akışı tanımlar. Bu etkinlik bir koleksiyon üzerinde yinelemek için kullanılır ve bir döngüde belirtilen etkinlikleri yürütür. Bu etkinliğin döngü uygulaması, programlama dillerindeki ForEach döngü yapısına benzer.

İşlem hattına ForEach etkinliği ekleme

Bu bölümde, bir forEach etkinliğinin işlem hattında nasıl kullanılacağı açıklanmaktadır.

Önkoşullar

Başlamak için aşağıdaki önkoşulları tamamlamanız gerekir:

Etkinlik oluşturma

  1. Çalışma alanınızda yeni bir işlem hattı oluşturun.

  2. İşlem hattı Etkinlikleri bölmesinde ForEach'i arayın ve bunu seçerek işlem hattı tuvaline ekleyin. Başlangıçta göremiyorsanız, etkinlikler araç çubuğunu bulmak için sağa kaydırmak için sağ taraftaki oku kullanın.

    Screenshot of the Fabric UI with the Activities pane and ForEach activity highlighted.

  3. Henüz seçili değilse tuvaldeki yeni ForEach etkinliğini seçin.

    Screenshot showing the General settings tab of the ForEach activity.

  4. Tuvalin en altındaki Genel sekmesinde, Ad özelliğinde etkinlik için bir ad girin.

  5. (İsteğe bağlı) Ayrıca bir açıklama da girebilirsiniz.

ForEach ayarları

Toplu iş içindeki öğelerin işlenmesinin Sıralı (veya başka bir şekilde paralel) olup olmayacağını belirtebileceğiniz Ayarlar sekmesini seçin. Batch sayısıyla aynı anda işlenmek üzere en fazla öğe sayısını da belirtebilirsiniz. Son olarak, parametreleştirilebilen veya dinamik içerik içerebilen virgülle ayrılmış Öğeler listesini belirtmeniz gerekir. Örnekte gösterildiği gibi Öğeler listesine birkaç öğe ekleyin.

Screenshot showing the ForEach settings tab with several items added to the Items list.

ForEach etkinlikleri

ForEach Etkinlikleri bölmesinde listedeki öğelerin her birinde gerçekleştirilecek bir etkinlik veya etkinlik de tanımlayacaksınız.

Screenshot showing the ForEach activities pane.

Bölmeye + yeni etkinlik eklemek için düğmeyi seçin. Seçebileceğiniz etkinliklerin listesini görürsünüz. ForEach etkinliğine birden çok etkinlik ekleyebilirsiniz ve her biri Öğeler listesindeki öğelerin her birinde çalıştırılır. ForEach ayarlarında Sıralı seçeneğinin belirlenip belirlenmediği, ForEach etkinlikleri bölmesindeki alt etkinliklerin her biri, her öğe için sırayla işlenir. Ancak Sıralı seçilmezse, birden çok öğe paralel olarak işlenir ve her biri belirtilen alt etkinlikler listesinden sırayla çalışır.

Screenshot showing a ForEach activity with multiple child activities specified, and the + button highlighted showing a list of child activities to choose from when adding new activities to the pane.

Etkinlik içindeki bir öğeye başvurma

ForEach Etkinlikleri bölmesinde alt etkinliklerden birini seçin ve Ayarlar sekmesine geçin. Bu örnekte saklı yordam etkinliği seçilmiştir. Normalde bir bağlantı ve saklı yordam seçeceğiniz gibi etkinliğin ayarlarını doldurun. @item() yineleyicisini kullanarak dinamik içeriği destekleyen bir etkinliğin herhangi bir yerinde işlenen geçerli öğeye başvurabilirsiniz. Burada @item() saklı yordama geçirilen FruitName parametresinin değeri olarak kullanılmıştır.

Screenshot showing a stored procedure child activity with a parameter using the current @item() from the ForEach items list for its value.