Funkcije "Prikupi", "Obriši" i "ClearCollect"

Kreira i briše kolekcije i dodaje zapise u svaki izvor podataka.

Collect

Odnosi se na: Canvas aplikacije Kartice Dataverse nisko kodiranje dodatne komponente Power Platform CLI Desktop tokove

Funkcija Collect dodaje zapise u izvor podataka. Stavke koje treba dodati mogu biti:

• Jedna vrednost: Vrednost je smeštena u polje Value novog zapisa. Sva ostala svojstva su ostavljena prazno.
• Zapis: Svako imenovano svojstvo se nalazi u odgovarajućem svojstvu novog zapisa. Sva ostala svojstva su ostavljena prazna.
• Tabela: Svaki zapis tabele dodaje se kao poseban zapis izvora podataka, kao što je gore opisano. Tabela se ne dodaje kao ugnežđena tabela u zapis. Da biste to učinili, prvo umotajte tabelu u zapis.

Kada se koriste sa kolekcijom, dodatne kolone kreiraće se po potrebi. Kolone za druge izvore podataka su fiksirane prema izvoru podataka i nove kolone se ne mogu dodavati.

Ako izvor podataka već ne postoji, kreira se kolekcija.

Kolekcije se ponekad koriste za zadržavanje globalnih promenljivih ili za privremenu kopiju izvora podataka. Aplikacije sa podlogom se zasnivaju na formulama koje se automatski preračunavaju dok je korisnik u interakciji sa aplikacijom. Kolekcije ne uživaju ovu prednost i njihovo korišćenje može vašoj aplikaciji otežati kreiranje i razumevanje. Pre upotrebe kolekcije na ovaj način, pregledajte rad sa promenljivim.

Takođe možete da koristite funkciju Patch da biste kreirali zapise u izvoru podataka.

Collect vraća izmenjeni izvor podataka kao tabelu. Collect može se koristiti samo u formuli ponašanja.

Obriši

Važi za: Canvas aplikacije

Funkcija Clear briše sve zapise zbirke. Kolone zbirke će ostati.

Imajte u vidu da funkcija Clear deluje samo na zbirke, a ne na druge izvore podataka. Možete koristiti RemoveIf( DataSource, true ) za ovu svrhu. Budite oprezni, jer ćete tako ukloniti sve zapise iz skladišta izvora podataka i to može uticati na druge korisnike.

Možete koristiti funkciju Remove za selektivno uklanjanje zapisa.

Clear nema povratnu vrednost. Može se koristiti samo u formuli ponašanja.

ClearCollect

Važi za: Canvas aplikacije Model-driven aplikacije

Funkcija ClearCollect briše sve zapise iz kolekcije. A onda u istu kolekciju dodaje drugačiji skup zapisa. U jednoj funkciji, ClearCollect nudi kombinaciju funkcija Clear i Collect.

ClearCollect vraća izmenjenu kolekciju kao tabelu. ClearCollect može se koristiti samo u formuli ponašanja.

Delegiranje

Kada ove funkcije koristite uz izvor podataka, ne možete ih delegirati. Samo prvi deo izvora podataka će biti preuzet, a zatim primenjena funkcija. Rezultat možda ne predstavlja kompletnu sliku. Upozorenje može da se prikazuje u trenutku kreiranja kao podsetnik na ovo ograničenje i da vam predloži prelazak na alternativne opcije koje je moguće delegirati, gde je to moguće. Više informacija potražite u pregledu delegiranja.

Sintaksa

Collect( DataSource, Item, ... )

• DataSource – Obavezno. Izvor podataka u koji želite da dodate podatke. Ako već ne postoji, kreira se nova kolekcija.
• Item(s) – Obavezno. Jedan ili više zapisa ili tabela koje treba dodati u izvor podataka.

Clear( Collection )

• Collection – Obavezno. Kolekcija koju želite da obrišete.

ClearCollect( Collection, Item, ... )

• Collection – Obavezno. Kolekciju koju želite da obrišete, a zatim u nju dodate podatke.
• Item(s) – Obavezno. Jedan ili više zapisa ili tabela koje treba dodati u izvor podataka.

Primeri

Brisanje i dodavanje zapisa u izvor podataka

U ovim primerima ćete izbrisati i dodati u kolekciju koja je nazvana IceCream. Izvor podataka počinje sa ovim sadržajem:

Formula	Opis	rezultat
ClearCollect( IceCream, { Flavor: "Strawberry", Quantity: 300 } )	Briše sve podatke iz kolekcije IceCream, a zatim dodaje zapis koji uključuje količinu sladoleda od jagode.	Kolekcija IceCream je takođe izmenjena.
Collect( IceCream, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 200 } )	Dodaje dva zapisa u kolekciju IceCream koja uključuje količinu sladoleda od pistacije i narandže.	Kolekcija IceCream je takođe izmenjena.
Clear( IceCream )	Uklanja sve zapise iz kolekcije IceCream.	Kolekcija IceCream je takođe izmenjena.

Detaljne primere kako da napravite kolekciju potražite u članku Kreiranje i ažuriranje kolekcije.

Zapisi i tabele

Ovi primeri istražuju kako se rukuje argumentima tabela i zapisa u funkcijama Collect i ClearCollect.

Formula	Opis	Rezultat
ClearCollect( IceCream, { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } )	Briše sve podatke, a zatim dodaje dva zapisa u kolekciju IceCream, koja sadrži količinu sladoleda od čokolade i vanile. Zapisi koji se dodaju daju se kao pojedinačni argumenti funkcije.	Kolekcija IceCream je takođe izmenjena.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) )	Isto kao i prethodni primer, osim što su zapisi kombinovani u tabeli i prosleđeni kroz jedan argument. Sadržaj tabele izvlači se jedan po jedan zapis pre nego što se doda u kolekciju IceCream.	Kolekcija IceCream je takođe izmenjena.
ClearCollect( IceCream, { MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )	Isto kao i prethodni primer, osim što je tabela umotana u zapis. Zapisi tabele se ne izvlače i umesto toga cela tabela se dodaje kao ćelija zapisa.	Kolekcija IceCream je takođe izmenjena.