Zdieľať cez


Transformácia údajov pomocou aktivity ForEach

Aktivita ForEach definuje opakujúci sa tok ovládacieho prvku v kanáli služby Microsoft Fabric. Táto aktivita sa používa na iterovanie v kolekcii a spúšťa zadané aktivity v slučke. Slučka implementácie tejto aktivity je podobná štruktúre slučiek ForEach v programovacích jazykoch.

Pridanie aktivity ForEach do kanála

Táto časť popisuje, ako používať aktivitu ForEach v kanáli.

Predpoklady

Na začiatok musíte splniť nasledujúce predpoklady:

Vytvorenie aktivity

  1. Vytvorte nový kanál vo svojom pracovnom priestore.

  2. Vyhľadajte forEach v table aktivity kanála a vyberte ho, ak ho chcete pridať na plátno kanála. Ak sa na začiatku nezobrazuje, pomocou šípky na pravej strane panela s nástrojmi aktivity sa posuňte doprava a vyhľadajte ju.

    Snímka obrazovky používateľského rozhrania služby Fabric so zvýraznenou tablou Aktivity a aktivitami forEach.

  3. Vyberte novú aktivitu ForEach na plátne, ak ešte nie je vybratá.

    Snímka obrazovky zobrazujúca kartu Všeobecné nastavenia aktivity ForEach.

  4. Na karte Všeobecné v dolnej časti plátna zadajte názov aktivity do vlastnosti Názov.

  5. (Voliteľné) Môžete tiež zadať popis.

Nastavenia forEach

Vyberte kartu Nastavenia, kde môžete určiť, či má byť spracovanie položiek v dávke sekvenčné (alebo inak paralelne). Môžete tiež určiť maximálny počet položiek, ktoré sa majú spracovať v rovnakom čase s Počet dávky. Nakoniec musíte zadať zoznam položiek položiek oddelených čiarkou, ktorý možno parametrizovať alebo zahrnúť dynamický obsah. Pridajte niekoľko položiek do zoznamu Items, ako je to znázornené v príklade.

Snímka obrazovky zobrazujúca kartu Nastavenia forEach s niekoľkými položkami pridanými do zoznamu Položky.

Aktivity ForEach

Môžete tiež definovať aktivitu alebo aktivity, ktoré sa majú vykonať na každej položke v zozname na table ForEach Aktivity.

Snímka obrazovky zobrazujúca tablu Aktivity forEach.

Vyberte tlačidlo + a pridajte na tablu novú aktivitu. Zobrazí sa zoznam aktivít, ktoré treba vybrať. Do aktivity ForEach môžete pridať viacero aktivít a každá z nich sa spustí na každej položke v zozname Items. Bez ohľadu na to, či je možnosť Sekvenčná vybratá v nastaveniach forEach alebo nie, každá podradená aktivita na table Aktivity forEach sa spracováva jednotlivo pre každú položku. Ak však nie je vybratá sekvenčné, súbežne sa spracujú viaceré položky, každá z nich prebieha sekvenčne prostredníctvom zoznamu zadaných podriadených aktivít.

Snímka obrazovky zobrazujúca aktivitu typu ForEach so zadanými viacerými podriadenými aktivitami a zvýraznené tlačidlom + zobrazujúca zoznam podriadených aktivít, z ktorých si možno vybrať pri pridávaní nových aktivít na tablu.

Odkazovanie na položku v rámci aktivity

Vyberte jednu z podriadených aktivít na table ForEach Aktivity a prepnite na kartu Nastavenia. V tomto príklade bola vybratá aktivita uloženej procedúry. Vyplňte nastavenia aktivity tak, ako by ste zvyčajne vybrali pripojenie a uloženú procedúru. V iterátore @item() môžete odkazovať na aktuálnu spracovávanú položku kdekoľvek v rámci aktivity, ktorá podporuje dynamický obsah. V tomto príklade sa @item() použil ako hodnota parametra FruitName, ktorá sa odovzdá do uloženej procedúry.

Snímka obrazovky, ktorá znázorňuje podriadenú aktivitu uloženej procedúry s parametrom pomocou aktuálneho @item() zo zoznamu položiek forEach pre jej hodnotu.