Sdílet prostřednictvím


Transformace dat pomocí aktivity ForEach

Aktivita ForEach definuje opakující se tok řízení v kanálu Microsoft Fabric. Tato aktivita se používá k iteraci přes kolekci a k provádění zadaných aktivit ve smyčce. Implementace smyčky této aktivity je podobná struktuře smyčky ForEach v programovacích jazycích.

Přidejte aktivitu ForEach do potrubí

Tato část popisuje, jak používat aktivitu ForEach v datovém potrubí.

Požadavky

Abyste mohli začít, musíte splnit následující požadavky:

Vytvoření aktivity

  1. Vytvořte v pracovním prostoru nový kanál.

  2. Vyhledejte ForEach v podokně Aktivity kanálu a vyberte ho, abyste ho přidali na plátno kanálu. Pokud ho zpočátku nevidíte, pomocí šipky na pravé straně panelu nástrojů aktivit se posuňte doprava, abyste ho našli.

    snímek obrazovky s Fabric UI se zvýrazněným podoknem Aktivity a zvýrazněnou aktivitou ForEach

  3. Pokud ještě není vybraná, vyberte na plátně novou aktivitu ForEach.

    Snímek obrazovky zobrazující kartu Obecné nastavení aktivity ForEach

  4. Na kartě Obecné v dolní části plátna zadejte do pole Název název aktivity.

  5. (Volitelné) Můžete také zadat popis.

Nastavení ForEach

Vyberte kartu Nastavení, kde můžete určit, jestli má být zpracování položek v dávce sekvenční (nebo jinak paralelně). Můžete také zadat maximální počet položek ke zpracování současně s počtem dávek . Nakonec je nutné zadat seznam čárkami oddělených Položky, které lze parametrizovat nebo zahrnout dynamický obsah. Do seznamu Položky přidejte několik položek, jak je znázorněno v příkladu.

Snímek obrazovky zobrazující kartu Nastavení ForEach s několika položkami přidanými do seznamu položek

Aktivity ForEach

Také definujete aktivitu nebo aktivity, které se mají provést u každé položky v seznamu, v podokně ForEach Aktivity.

Snímek obrazovky s podoknem aktivit ForEach

Vyberte tlačítko + a přidejte do podokna novou aktivitu. Zobrazí se seznam aktivit, které chcete zvolit. Do aktivity ForEach můžete přidat více aktivit a každý z nich se spustí u každé položky v seznamu Položky. Bez ohledu na to, jestli je v nastavení ForEach vybraná možnost Sekvenční, každá podřízená aktivita v podokně aktivit ForEach je zpracovávána postupně, jedna po druhé, pro každou položku. Pokud ale Sekvenční není vybráno, zpracovává se paralelně více položek, přičemž každá z nich postupně prochází seznamem specifikovaných podřízených aktivit.

Snímek obrazovky znázorňující aktivitu ForEach obsahující několik zadaných podřízených aktivit, s tlačítkem + zvýrazněným pro zobrazení seznamu podřízených aktivit, ze kterých si můžete vybrat při přidávání nových aktivit do okna.

Odkazování na položku v rámci aktivity

Vyberte jednu z podřízených aktivit v podokně ForEach Aktivity a přepněte na kartu Nastavení. V tomto příkladu byla vybrána aktivita Uložená procedura. Naplňte nastavení aktivity tak, jak byste normálně vybrali připojení a uloženou proceduru. Pomocí iterátoru @item() můžete odkazovat na aktuální položku zpracovávanou kdekoli v rámci aktivity, která podporuje dynamický obsah. Tady @item() byl použit jako hodnota parametru FruitName, který se předá uložené proceduře.

Snímek obrazovky znázorňující podřízenou aktivitu uložené procedury s parametrem, který používá aktuální @item() ze seznamu položek ForEach jako svou hodnotu.