Funkcie Collect, Clear a ClearCollect v službe PowerAppsCollect, Clear, and ClearCollect functions in PowerApps

Vytvoria a vymažú kolekcie a pridajú záznamy do ľubovoľného zdroja údajov.Creates and clears collections and adds records to any data source.

PopisDescription

Funkcia CollectCollect

Funkcia Collect pridáva záznamy do zdroja údajov.The Collect function adds records to a data source. Pridávané položky môžu byť:The items to be added can be:

  • Jedna hodnota: Hodnota sa umiestni do hodnota pole nového záznamu.A single value: The value is placed in the Value field of a new record. Všetky ostatné vlastnosti sa ponechajú prázdne.All other properties are left blank.
  • Záznam: Každá pomenovaná vlastnosť sa umiestni do zodpovedajúcej vlastnosti nového záznamu.A record: Each named property is placed in the corresponding property of a new record. Všetky ostatné vlastnosti sa ponechajú prázdne.All other properties are left blank.
  • A tabuľky: Každý záznam tabuľky sa pridá ako samostatný záznam zdroja údajov, ako je popísané vyššie.A table: Each record of the table is added as a separate record of the data source as described above. Tabuľka sa k záznamu nepridá ako vnorená tabuľka.The table is not added as a nested table to a record. To docielite tak, že tabuľku najprv zabalíte do záznamu.To accomplish this, wrap the table in a record first.

Pri použití s kolekciou sa môžu podľa potreby vytvoriť ďalšie stĺpce.When used with a collection, additional columns will be created as needed. Počet stĺpcov pre iné zdroje údajov je stanovený týmito zdrojmi údajov a nové stĺpce sa nedajú pridať.The columns for other data sources are fixed by the data source and new columns cannot be added.

Ak zdroj údajov ešte neexistuje, vytvorí sa kolekcia.If the data source doesn't already exist, a collection is created.

Kolekcie sa niekedy používajú na uchovávanie globálnych premenných alebo na vytvorenie dočasnej kópie zdroja údajov.Collections are sometimes used to hold global variables or make a temporary copy of a data source. Základom PowerApps sú vzorce, ktoré sa automaticky prepočítajú v priebehu interakcie používateľa s aplikáciou.PowerApps are based on formulas that automatically recalculate as the user interacts with an app. Kolekcie túto výhodu neponúkajú a ich použitie môže sťažiť vytvorenie a pochopenie vašej aplikácie.Collections do not enjoy this benefit and their use can make your app harder to create and understand. Skôr ako kolekciu takýmto spôsobom použijete, prečítajte si článok o práci s premennými.Before using a collection in this manner, review working with variables.

Na vytvorenie záznamu v zdroji údajov môžete použiť aj funkciu Patch.You can also use the Patch function to create records in a data source.

Funkcia Collect vráti upravený zdroj údajov vo forme tabuľky.Collect returns the modified data source as a table. Funkcia Collect sa dá použiť iba vo vzorcoch správania.Collect can only be used in a behavior formula.

Funkcia ClearClear

Funkcia Clear odstráni všetky záznamy v kolekcii.The Clear function deletes all the records of a collection. Stĺpce v kolekcii zostanú.The columns of the collection will remain.

Nezabudnite, že funkcia Clear pracuje iba s kolekciami, nie s inými zdrojmi údajov.Note that Clear only operates on collections and not other data sources. Na tento účel môžete použiť funkciu RemoveIf( DataSource; true ).You can use RemoveIf( DataSource; true ) for this purpose. Buďte opatrní, pretože táto funkcia odstráni všetky záznamy z úložiska zdroja údajov a môže ovplyvniť ostatných používateľov.Use caution as this will remove all records from the data source's storage and can affect other users.

Ak chcete odobrať záznamy selektívnym spôsobom, môžete použiť funkciu Remove.You can use the Remove function to selectively remove records.

Funkcia Clear nemá žiadnu návratovú hodnotu.Clear has no return value. Dá sa použiť iba vo vzorci správania.It can only be used in a behavior formula.

Funkcia ClearCollectClearCollect

Funkcia ClearCollect odstráni všetky záznamy z kolekcie a potom pridá inú množinu záznamov do tej istej kolekcie.The ClearCollect function deletes all the records from a collection and then adds a different set of records to the same collection. Jediná funkcia ClearCollect tak ponúka kombináciu funkcií Clear a Collect.With a single function, ClearCollect offers the combination of Clear and then Collect.

Funkcia ClearCollect vráti upravenú kolekciu vo forme tabuľky.ClearCollect returns the modified collection as a table. Funkcia ClearCollect sa dá použiť iba vo vzorci správania.ClearCollect can only be used in a behavior formula.

SyntaxSyntax

Collect( DataSource; Item; ... )Collect( DataSource; Item; ... )

  • DataSource – povinné.DataSource – Required. Zdroj údajov, do ktorého chcete pridať údaje.The data source that you want to add data to. Ak ešte neexistuje, vytvorí sa nová kolekcia.If it does not already exist, a new collection is created.
  • Položky - povinné.Item(s) - Required. Jeden alebo viac záznamov alebo tabuliek, ktoré sa majú pridať do zdroja údajov.One or more records or tables to add to the data source.

Clear( Kolekcia )Clear( Collection )

  • Collection – povinné.Collection – Required. Kolekcia, ktorú chcete vymazať.The collection that you want to clear.

ClearCollect( Kolekcia; Položka; ... )ClearCollect( Collection; Item; ... )

  • Collection – povinné.Collection – Required. Kolekcia, ktorú chcete vymazať a následne do nej pridať údaje.The collection that you want to clear and then add data to.
  • Položky - povinné.Item(s) - Required. Jeden alebo viac záznamov alebo tabuliek, ktoré sa majú pridať do zdroja údajov.One or more records or tables to add to the data source.

PríkladyExamples

Vymazanie a pridanie záznamov do zdroja údajovClearing and adding records to a data source

V týchto príkladoch vymažete kolekciu s názvom IceCream a potom do nej pridáte údaje.In these examples, you'll erase and add to a collection that's named IceCream. Na začiatku zdroj údajov obsahuje:The data source begins with these contents:

Zdroj údajov vzorky

VzorecFormula PopisDescription VýsledokResult
ClearCollect( IceCream; { Flavor: "Strawberry"; Quantity: 300 } )ClearCollect( IceCream; { Flavor: "Strawberry"; Quantity: 300 } ) Vymaže všetky údaje z kolekcie IceCream a potom pridá záznam obsahujúci množstvo jahodovej zmrzliny.Clears all data from the IceCream collection and then adds a record that includes a quantity of strawberry ice cream. tabuľky s jedným záznamom Table with one record

Zdroj údajov IceCream bol tiež upravený.The IceCream data source has also been modified.
Collect( IceCream; { Flavor: "Pistachio"; Quantity: 40 }; { Flavor: "Orange"; Quantity: 200 } )Collect( IceCream; { Flavor: "Pistachio"; Quantity: 40 }; { Flavor: "Orange"; Quantity: 200 } ) Pridá dva záznamy do kolekcie IceCream obsahujúce množstvo pistáciovej a pomarančovej zmrzliny.Adds two records to the IceCream collection that includes a quantity of pistachio and Orange ice cream. Tabuľka s dva záznamyTable with two records

Zdroj údajov IceCream bol tiež upravený.The IceCream data source has also been modified.
Clear( IceCream )Clear( IceCream ) Odstráni všetky záznamy z kolekcie IceCream.Removes all records from the IceCream collection. Prázdna tabuľkaEmpty table

Zdroj údajov IceCream bol tiež upravený.The IceCream data source has also been modified.

Krok za krokom príkladov toho, ako vytvoriť kolekciu nájdete v článku vytvorenie a aktualizácia kolekcie.For step-by-step examples of how to create a collection, see Create and update a collection.