Funkce Collect, Clear a ClearCollect

Vytvoří a vymaže kolekce a přidá záznamy k libovolnému zdroji dat.

Collect

Platí pro: aplikace Canvas Karty Dataverse s minimálním psaním kódu plug-iny Power Platform CLI Toky na počítači

Funkce Collect umožňuje přidat záznamy ke zdroji dat. Mezi přidávané položky může patřit:

• Jedna hodnota: Tato hodnota se nachází v poli Value nového záznamu. Pro všechny ostatní vlastnosti je ponechána hodnota blank.
• Záznam: Jednotlivé pojmenované vlastnosti se nacházejí v odpovídající vlastnosti nového záznamu. Všechny ostatní vlastnosti se ponechají prázdné.
• Tabulka: Každý záznam tabulky se přidá jako samostatný záznam zdroje dat, jak je popsáno výše. Tato tabulka se k záznamu nepřidá jako vnořená tabulka. Toho docílíte tak, že tabulku v záznamu napřed zabalíte.

Pokud se používá s kolekcí, vytvoří se podle potřeby další sloupce. Sloupce pro jiné zdroje dat jsou vázané na daný zdroj dat a nové sloupce nelze přidat.

Pokud zdroj dat ještě neexistuje, vytvoří se kolekce.

Kolekce se někdy používají k uchování globálních proměnných nebo k vytvoření dočasné kopie zdroje dat. Základem aplikací plátna jsou vzorce, které se automaticky přepočítávají během interakce uživatele s aplikací. Kolekce tuto výhodu nenabízejí a jejich použití může znesnadnit vytvoření a pochopení vaší aplikace. Dříve, než kolekci tímto způsobem použijete, si přečtěte téma o práci s proměnnými.

K vytvoření záznamů ve zdroji dat můžete použít také funkci Patch.

Collect vrátí upravený zdroj dat jako tabulku. Collect lze použít pouze v vzorci chování.

Clear

Platí pro: aplikace Canvas

Funkce Clear odstraní všechny záznamy kolekce. Sloupce v kolekci zůstanou.

Mějte na paměti, že funkce Clear funguje jenom u kolekcemi a nefunguje s jinými zdroji dat. K tomuto účelu můžete použít funkci RemoveIf( ZdrojDat; true). Buďte obezřetní, protože tím odeberete všechny záznamy z úložiště zdroje dat, což může ovlivnit jiné uživatele.

Funkci Remove můžete použít k selektivnímu odebrání záznamů.

Clear nemá žádnou návratovou hodnotu. Dá se použít jenom ve vzorci chování.

ClearCollect

Platí pro: Aplikace plátna Modelem řízené aplikace

Funkce ClearCollect odstraní všechny záznamy z kolekce. A poté přidá do stejné kolekce jinou sadu záznamů. Jediná funkce ClearCollect tak nabízí kombinaci funkcí Clear a Collect.

ClearCollect vrátí upravenou kolekci jako tabulku. ClearCollect lze použít pouze ve vzorci chování.

Delegování

Tyto funkce nelze delegovat, pokud se používají se zdrojem dat. Bude načtena pouze první část zdroje dat a pak se tato funkce použije. Výsledek nemusí být zcela reprezentativní. V době vytvoření se může zobrazit upozornění, které na toto omezení upozorňuje a doporučuje přepnutí na delegovatelné alternativy tam, kde to je možné. Další informace získáte v přehledu delegování.

Syntaxe

Shromáždit( Zdroj dat, Položka, ... )

• DataSource – Povinné. Zdroj dat, do kterého se mají přidat data. Pokud ještě neexistuje, vytvoří se nová kolekce.
• Položky – Povinné. Jeden nebo několik záznamů nebo tabulek, které se mají přidat do zdroje dat.

Vymazat( Sbírka )

• Kolekce – Povinné. Kolekce, která se má vymazat.

ClearCollect( Kolekce, Položka, ... )

• Kolekce – Povinné. Kolekce, která se má vymazat a do které se následně mají přidat data.
• Položky – Povinné. Jeden nebo několik záznamů nebo tabulek, které se mají přidat do zdroje dat.

Příklady

Vymazání a přidání záznamů do zdroje dat

V těchto příkladech vymažete kolekci s názvem Zmrzlina a přidáte do ní data. Zdroj dat začíná tímto obsahem:

Vzorec	Popis	Výsledek
ClearCollect( IceCream, { Příchuť: "Jahoda", Množství: 300 } )	Vymaže všechna data z kolekce Zmrzlina a pak přidá záznam obsahující množství jahodové (Strawberry) zmrzliny.	Kolekce Zmrzlina je také změněna.
Collect( IceCream, { Příchuť: "Pistácie", Množství: 40 }, { Příchuť: "Pomeranč", Množství: 200 } )	Přidá do kolekce Zmrzlina dva záznamy obsahující množství pistáciové (Pistachio) a pomerančové (Orange) zmrzliny.	Kolekce Zmrzlina je také změněna.
Čirá (zmrzlina)	Odebere z kolekce Zmrzlina všechny záznamy.	Kolekce Zmrzlina je také změněna.

Příklady krok za krokem, jak vytvořit kolekci, viz Vytvoření a aktualizujte kolekce.

Záznamy a tabulky

Tyto příklady zkoumají, jak argumenty záznamu a tabulky Collect a ClearCollect jsou zpracovány.

Vzorec	Popis	Výsledek
ClearCollect( IceCream, { Příchuť: "Čokoláda", Množství: 100 }, { Příchuť: "Vanilka", Množství: 200 } )	Vymaže všechna a poté přidá dva záznamy do kolekce Zmrzlina obsahující množství čokoládové (Chocolate) a vanilkové (Vanilla) zmrzliny. Záznamy, které mají být přidány, jsou poskytovány jako jednotlivé argumenty funkce.	Kolekce Zmrzlina je také změněna.
ClearCollect( IceCream, Table( { Příchuť: "Čokoláda", Množství: 100 }, { Příchuť: "Vanilka", Množství: 200 } ))	Stejné jako v předchozím příkladu s tou výjimkou, že záznamy jsou kombinovány v tabulce a předávány prostřednictvím jediného argumentu. Před přidáním do kolekce Zmrzlina se obsah tabulky extrahuje záznam po záznamu.	Kolekce Zmrzlina je také změněna.
ClearCollect (IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	Stejné jako v předchozím příkladu s tou výjimkou, že tabulka je zabalena do záznamu. Záznamy tabulky nejsou extrahovány a místo toho je celá tabulka přidána jako buňka záznamu.	Kolekce Zmrzlina je také změněna.