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 poľa Value 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.
  • Tabuľka: každý záznam tabuľky sa pridá ako samostatný záznam zdroja údajov, ako je to 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( ZdrojÚdajov, 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( ZdrojÚdajov, Položka, ... )Collect( DataSource, Item, ... )

  • ZdrojÚdajov – 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 )

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

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

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

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.

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.

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.

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

Zhromažďovanie statického zoznamuCollect a static list

  1. Pridajte tlačidlo a jeho vlastnosť OnSelect nastavte na tento vzorec:Add a button, and set its OnSelect property to this function:
    Collect(Products, "Europa", "Ganymede", "Callisto")Collect(Products, "Europa", "Ganymede", "Callisto")

    Táto funkcia vytvorí kolekciu pomenovanú Products obsahujúcu riadok pre každý z troch názvov produktov.This function creates a collection that's named Products and that contains a row for each of three product names.

  2. Podržte kláves Alt a vyberte tlačidlo.While holding down the Alt key, select the button.

  3. (voliteľné) Ak chcete zobraziť ukážku kolekcie, ktorú ste vytvorili, vyberte položku Kolekcie v ponuke Súbor.(optional) To preview the collection that you created, select Collections on the File menu.

Vloženie zoznamu služby SharePoint do kolekciePut a SharePoint list into a collection

  1. Vytvorenie pripojenia k zoznamu služby SharePoint.Create a connection to a SharePoint list.

  2. Pridajte tlačidlo a nastavte jeho vlastnosť OnSelect na túto funkciu, pričom nahradíte položku ListName názvom vášho zoznamu služby SharePoint:Add a button, and set its OnSelect property to this function, replacing ListName with the name of your SharePoint list:
    Zhromaždiť(MySPCollection, ListName)Collect(MySPCollection, ListName)

    Táto funkcia vytvorí kolekciu s názvom MySPCollection, ktorá obsahuje rovnaké údaje ako zoznam služby SharePoint.This function creates a collection that's named MySPCollection and that contains the same data as your SharePoint list.

  3. Podržte kláves Alt a vyberte tlačidlo.While holding down the Alt key, select the button.

  4. (voliteľné) Ak chcete zobraziť ukážku kolekcie, ktorú ste vytvorili, vyberte položku Kolekcie v ponuke Súbor.(optional) To preview the collection that you created, select Collections on the File menu.

Informácie o zobrazovaní údajov zo zoznamu služby SharePoint (ako napríklad dátumy, rozhodnutia a ľudia) v galérii sú uvedené v téme Zobrazenie údajov v galérii.For information about how to show data from a SharePoint list (such as dates, choices, and people) in a gallery, see Show data in a gallery. Informácie o zobrazovaní údajov vo formulári (s rozbaľovacími zoznamami, výbermi dátumu a osôb) sú uvedené v téme Ovládacie prvky Formulár na zobrazenie a Formulár na úpravy.For information about how to show data in a form (with drop-down lists, date pickers, and people pickers), see Edit form and Display form controls.