Udostępnij za pośrednictwem


Przekształcanie danych za pomocą działania ForEach

Działanie ForEach definiuje powtarzający się przepływ kontrolny w potoku Microsoft Fabric. Ta czynność służy do iterowania po kolekcji i wykonywania określonych czynności w pętli. Implementacja pętli tego działania jest podobna do struktury pętli ForEach w językach programowania.

Dodaj działanie ForEach do potoku

W tej sekcji opisano sposób używania działania ForEach w potoku.

Warunki wstępne

Aby rozpocząć pracę, należy spełnić następujące wymagania wstępne:

Tworzenie aktywności

  1. Utwórz nowy potok w obszarze roboczym.

  2. Wyszukaj ForEach w okienku działania potoku i wybierz go, aby dodać go do kanwy potoku. Jeśli początkowo go nie widzisz, użyj strzałki po prawej stronie paska narzędzi działań, aby przewinąć go w prawo, aby go znaleźć.

    Zrzut ekranu przedstawiający Fabric UI z wyróżnionym okienkiem 'Działania' i działaniem 'ForEach'.

  3. Wybierz nowe działanie ForEach na kanwie, jeśli nie zostało jeszcze wybrane.

    Zrzut ekranu przedstawiający zakładkę Ustawienia ogólne działania ForEach.

  4. Na karcie Ogólne w dolnej części Kanwy wprowadź nazwę działania we właściwości Nazwa.

  5. (Opcjonalnie) Możesz również wprowadzić opis.

Ustawienia ForEach

Wybierz kartę ustawienia , na której można określić, czy przetwarzanie elementów w partii powinno być sekwencyjne (lub w inny sposób równoległe). Można również określić maksymalną liczbę elementów do przetworzenia w tym samym czasie przy użyciu liczby partii. Na koniec należy określić listę rozdzielonych przecinkami Items, które mogą być sparametryzowane lub zawierają zawartość dynamiczną. Dodaj kilka elementów do listy Items, jak pokazano w przykładzie.

Zrzut ekranu przedstawiający kartę Ustawienia forEach z kilkoma elementami dodanymi do listy Elementy.

Działania forEach

Zdefiniuj również czynność lub czynności, które mają być wykonywane na każdym z elementów na liście, w okienku Działania ForEach.

Zrzut ekranu przedstawiający okienko działań ForEach.

Wybierz przycisk +, aby dodać nowe działanie do okienka. Zostanie wyświetlona lista działań do wyboru. Do działania ForEach można dodać wiele działań, a każde z nich jest uruchamiane na każdym z elementów w liście Items. Niezależnie od tego, czy opcja sekwencyjna jest zaznaczona w ustawieniach ForEach, czy nie, każde działanie podrzędne w panelu działań ForEach jest przetwarzane sekwencyjnie, jeden po drugim, dla każdego elementu. Jeśli jednak sekwencyjnie nie jest zaznaczone, wiele elementów jest przetwarzanych równolegle, a każdy z nich działa sekwencyjnie przez listę określonych działań podrzędnych.

Zrzut ekranu przedstawiający działanie ForEach z określonymi wieloma działaniami podrzędnymi i wyróżnionym przyciskiem + z listą działań podrzędnych do wyboru podczas dodawania nowych działań do okienka.

Odnoszenie się do elementu w aktywności

Wybierz jedno z działań podrzędnych w okienku Działania ForEach i przejdź do karty Ustawienia. W tym przykładzie wybrano działanie Procedura składowana. Wypełnij ustawienia działania tak, jak zwykle wybierasz połączenie i procedurę składowaną. Można użyć iteratora @item(), aby odwołać się do bieżącego elementu przetwarzanego w dowolnym miejscu w ramach działania obsługującego zawartość dynamiczną. Tutaj, @item() zostało użyte jako wartość parametru FruitName przekazanego do procedury składowanej.

Zrzut ekranu przedstawiający aktywność podrzędną procedury składowanej z parametrem używającym bieżącego @item() z listy elementów ForEach jako jego wartości.