Funkcije Collect, Clear in ClearCollect

Ustvari in počisti zbirke ter doda zapise kateremu koli viru podatkov.

Collect

Velja za: Aplikacije Canvas Kartice Dataverse vtičnike z nizko kodo Power Platform CLI Tokove namizja

Funkcija Collect doda zapise v vir podatkov. Dodati je mogoče elemente:

• Ena vrednost: vrednost, umeščena v polje Value novega zapisa. Vse druge lastnosti so puščene prazne (blank).
• Zapis: vsaka imenovana lastnost je umeščena v ustrezno lastnost novega zapisa. Vse druge lastnosti so puščene prazne.
• Tabela: vsak zapis tabele je dodan kot ločeni zapis vira podatkov, kot je opisano zgoraj. Tabela ni dodana kot ugnezdena tabela v zapisu. To storite tako, da najprej tabelo prelomite v zapisu.

Ob uporabi z zbirko bodo po potrebi ustvarjeni dodatni stolpci. Stolpce za druge vire podatkov fiksira vir podatkov in novih stolpcev ni mogoče dodati.

Če vir podatkov še ne obstaja, je ustvarjena zbirka.

Zbirke se včasih uporabijo, da držijo globalne spremenljivke ali ustvarijo začasno kopijo vira podatkov. Aplikacije delovnega območja temeljijo na formulah, ki se samodejno preračunajo, ko uporabnik uporablja aplikacijo. Zbirke nimajo te prednosti, zato lahko njihova uporaba oteži ustvarjanje in razumevanje vaše aplikacije. Pred uporabo zbirke na ta način, si oglejte delo s spremenljivkami.

Uporabite lahko tudi funkcijo Patch, da ustvarite zapise v viru podatkov.

Collect vrne spremenjeni vir podatkov kot tabelo. Collect se lahko uporabi samo v formuli vedenja.

Počisti

Velja za: aplikacije Canvas

Funkcija Clear izbriše vse zapise zbirke. Stolpci zbirke ostanejo.

Upoštevajte, da funkcija Clear operira samo na zbirkah in ne na drugih virih podatkov. V ta namen lahko uporabite RemoveIf( DataSource, true ). Bodite previdni, saj s tem odstranite vse zapise iz prostora za shranjevanje vira podatkov in lahko vplivate na druge uporabnike.

Uporabite lahko funkcijo Remove za selektivno odstranitev zapisov.

Funkcija Clear ne vrne vrednosti. Uporabi se lahko samo v formuli vedenja.

ClearCollect

Velja za: Aplikacije Canvas Aplikacije, ki temeljijo na modelu

Funkcija ClearCollect izbriše vse zapise iz zbirke. Nato pa doda drug nabor zapisov v isto zbirko. V eni funkciji ClearCollect ponuja kombinacijo funkcij Clear in Collect.

ClearCollect vrne spremenjeno zbirko kot tabelo. ClearCollect se lahko uporabi samo v formuli vedenja.

Pooblastitev

Ko so uporabljene z virom podatkov, teh funkcij ni mogoče pooblastiti. Pridobljen bo samo prvi del vira podatkov, nato bo uporabljena funkcija. Rezultat morda ne pokaže celotne slike. V času ustvarjanja se lahko prikaže opozorilo, ki vas opomni na to omejitev in predlaga, da uporabite možnosti, ki jih je mogoče pooblastiti, če so na voljo. Če želite več informacij, glejte razdelek Pregled pooblastitev.

Sintaksa

Collect( DataSource, Item, ... )

• DataSource – obvezno. Vir podatkov, ki mu želite dodati podatke. Če še ne obstaja, je ustvarjena nova zbirka.
• Item(s) – obvezno. Eden ali več zapisov ali tabel, ki jih želite dodati v vir podatkov.

Clear( Collection )

• Collection – obvezno. Zbirka, ki jo želite počistiti.

ClearCollect( Collection, Item, ... )

• Collection – obvezno. Zbirka, ki jo želite počistiti in ji nato dodati podatke.
• Item(s) – obvezno. Eden ali več zapisov ali tabel, ki jih želite dodati v vir podatkov.

Primeri

Brisanje in dodajanje zapisov v vir podatkov

V teh primerih boste izbrisali in dodali zbirko, ki se imenuje IceCream. Vir podatkov se začne s temi vsebinami:

Formula	Opis	Rezultat
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )	Počisti vse podatke iz zbirke IceCream in nato doda zapis, ki vključuje količino sladoleda z okusom jagode.	Zbirka IceCream je bila tudi spremenjena.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	Doda dva zapisa v zbirko IceCream, ki vključujeta količino sladoleda z okusom pistacije in pomaranče.	Zbirka IceCream je bila tudi spremenjena.
Clear( IceCream )	Odstrani vse zapise iz zbirke IceCream.	Zbirka IceCream je bila tudi spremenjena.

Za primere po korakih, kako ustvarite zbirko, glejte Ustvarjanje in posodabljanje zbirke.

Zapisi in tabele

V teh primerih preučujemo, kako so obravnavani argumenti zapisa in tabele za funkciji Collect in ClearCollect.

Formula	Opis	Rezultat
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Počisti vse podatke in nato doda dva zapisa v zbirko IceCream, ki vključujeta količino sladoleda z okusom čokolade in vanilje. Zapisa, ki se dodata, sta zagotovljena kot posamezna argumenta za funkcijo.	Zbirka IceCream je bila tudi spremenjena.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) )	Enako kot v prejšnjem primeru, razen da sta zapisa združena v tabeli in posredovana prek enega argumenta. Vsebine tabele so izvlečene zapis za zapisom, preden se dodajo v zbirko IceCream.	Zbirka IceCream je bila tudi spremenjena.
ClearCollect( IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	Enako kot prejšnji primer, le da je tabela prelomljena v zapisu. Zapisi tabele se ne izvlečejo in celotna tabela je dodana kot celica zapisa.	Zbirka IceCream je bila tudi spremenjena.