Collect, Cleari ClearCollect funkcije

Function	Odnosi se na
Clear	Aplikacije podloge za računare prenose Power Platform CLI Dataverse funkcije
ClearCollect	Aplikacije podloge za računare prenose Power Platform CLI
Collect	Aplikacije sa podlogom za računare prenose aplikacije zasnovane na modelima Power Platform CLI Dataverse funkcije

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

Collect

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 da se koristi samo u formuli ponašanja.

Clear

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

Imajte na umu Clear da radi samo na kolekcijama, a ne i u drugim izvorima 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

Funkcija ClearCollect briše sve zapise iz kolekcije. A onda u istu kolekciju dodaje drugačiji skup zapisa. Sa jednom funkcijom nudi ClearCollect kombinaciju Clear , a zatim Collect.

ClearCollect daje izmenjenu kolekciju kao tabelu. ClearCollect može da se koristi 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( Izvor podataka, Stavka, ... )

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

Clear( Kolekcija )

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

ClearCollect( kolekcija, stavka, ... )

• Kolekcija – Obavezno. Kolekciju koju želite da obrišete, a zatim u nju dodate podatke.
• Predmeti - 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, { Ukus: "Jagoda", Količina: 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, { Ukus: "Pistaćio", Količina: 40 }, { Ukus: "Narandžasta", Količina: 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( Ledeni koru)	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 zapisa CollectClearCollect i tabele.

Formula	Opis	rezultat
ClearCollect( Ledeni krem, { Ukus: "Čokolada", Količina: 100 }, { Ukus: "Vanila", Količina: 200 } )	Clear svi podaci, a zatim dodaje dva zapisa u kolekciju IceCream koja uključuje količinu čokolade i sladoleda od vanile. Zapisi koji se dodaju daju se kao pojedinačni argumenti funkcije.	Kolekcija IceCream je takođe izmenjena.
ClearCollect( IceCream, Table( { Ukus: "Čokolada", Količina: 100 }, { Ukus: "Vanila", Količina: 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( { Ukus: "Čokolada", Količina: 100 }, { Ukus: "Vanila", Količina: 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.