Funkce Collect, Clear a ClearCollect

  • Článek

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

Collect

Platí pro: Aplikace plátna Karty Moduly plug-in s minimálním psaním kódu Dataverse Power Platform CLI Desktopové toky

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.

Funkce Collect vrací změněný zdroj dat jako tabulku. Funkce Collect se dá použít jenom ve vzorci chování.

Clear

Platí pro: aplikace plátna

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ů.

Funkce 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.

Funkce ClearCollect vrací změněnou kolekci jako tabulku. Funkce ClearCollect se dá použít jenom 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

Collect( ZdrojDat; Položka; ... )

  • ZdrojDat – 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.

Clear( Kolekce )

  • 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:

Ukázkový zdroj dat.

Vzorec Popis Výsledek
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } ) Vymaže všechna data z kolekce Zmrzlina a pak přidá záznam obsahující množství jahodové (Strawberry) zmrzliny. Tabulka s jedním záznamem.

Kolekce Zmrzlina je také změněna.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } ) Přidá do kolekce Zmrzlina dva záznamy obsahující množství pistáciové (Pistachio) a pomerančové (Orange) zmrzliny. Tabulka se dvěma záznamy.

Kolekce Zmrzlina je také změněna.
Clear( Zmrzlina ) Odebere z kolekce Zmrzlina všechny záznamy. Prázdná tabulka.

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, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 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. Do kolekce byly přidány záznamy čokolády a vanilky.

Kolekce Zmrzlina je také změněna.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 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. Záznamy o čokoládě a vanilce byly přidány do sbírky a upraveny.

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. Záznamy o čokoládě a vanilce přidané do kolekce, upravené s tabulkou zabalenou do záznamu.

Kolekce Zmrzlina je také změněna.