Funkcije Collect, Clear i ClearCollect
Kreira i briše kolekcije i dodaje zapise u svaki izvor podataka.
Collect
Odnosi se na: Canvas apps Kartice Dataverse nisko kodiranje plug-ins Power Platform CLI Desktop tokovi
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.
Prikupiti vraća modifikovani izvor podataka kao tabelu. Collect se može koristiti samo u formuli ponašanja.
Obriši
Odnosi se na: 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
Odnosi se na: Canvas aplikacije Aplikacije zasnovane na modelu
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 modifikovanu kolekciju kao tabelu. ClearCollect se može 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.
- Predmeti - Obavezno. Jedan ili više zapisa ili tabela koje treba dodati u izvor podataka.
Jasno( 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( Sladoled, { 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: "Pistacija", 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. |
Jasno ( sladoled ) | 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 (Sladoled, { ukus: "Čokolada", Količina: 100 }, { Ukus: "Vanila", Količina: 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 (Sladoled, Tabela { (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( { 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. |