Dijeli putem


Collect, Cleari ClearCollect funkcije

Funkcija Odnosi se na
Clear Canvas apps Desktop flows Power Platform CLI Dataverse functions
ClearCollect Canvas apps Desktop flows Power Platform CLI
Collect Canvas apps Desktop flows Model-driven apps Power Platform CLI Dataverse functions

Stvara i briše zbirke i dodaje zapise na izvor podataka.

Collect

Funkcija Collect dodaje zapise u izvor podataka. Items za dodavanje mogu biti:

  • Jedna vrijednost: Vrijednost je postavljena u polju Value novog zapisa. Sva druga svojstva su ostavljena blank.
  • Zapis: Svako imenovano svojstvo postavljeno je u odgovarajućem svojstvu novog zapisa. Sva druga svojstva su ostavljena prazna.
  • tablica: Svaki zapis tablice dodaje se kao zasebni zapis izvora podataka kao što je opisano. Tablica se ne dodaje kao ugniježđena tablica u zapis. Da biste to učinili, najprije prelomite tablicu u zapis.

Kada se koristi sa zbirkom, dodatni stupci biti će stvoreni po potrebi. Stupce za druge izvore podataka popravlja izvor podataka i nije moguće dodati nove stupce.

Ako izvor podataka još uvijek ne postoji, stvara se zbirka.

Zbirke se ponekad koriste za zadržavanje globalnih varijabli ili privremenu kopiju izvora podataka. Aplikacije radnog područja temelje se na formulama koje automatski preračunavaju dok korisnik radi s aplikacijom. Zbirke ne koriste ovu prednost i njihovo korištenje može vašoj aplikaciji otežati stvaranje i razumijevanje. Prije upotrebe zbirke na ovaj način, pregledajte rad s varijablama.

Možete koristiti i funkciju Patch za stavanje zapisa u izvoru podataka.

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

Clear

Funkcija Clear briše sve zapise zbirke. Ostat će stupci zbirke.

Imajte na Clear umu da funkcionira samo na zbirkama, a ne i na drugim izvorima podataka. Možete koristiti RemoveIf( DataSource, true ) za ovu svrhu. Budite oprezni jer se time uklanjaju svi zapisi iz pohrane izvora podataka i mogu utjecati na druge korisnike.

Možete koristiti funkciju Remove za selektivno uklanjanje zapisa.

Clear nema povratnu vrijednost. Možete se koristiti samo u formula ponašanja.

ClearCollect

Funkcija ClearCollect briše sve zapise iz zbirke. A zatim u istu zbirku dodaje drugačiji skup zapisa. Uz jednu funkciju, ClearCollect nudi kombinaciju Clear , a zatim Collect.

ClearCollect vraća izmijenjenu zbirku kao tablicu. ClearCollect može se koristiti samo u formuli ponašanja.

Delegacija

Kad se koristi uz izvor podataka, te se funkcije ne mogu delegirati. Dohvatit će se samo prvi dio izvora podataka, a zatim će se primijeniti funkcija. Rezultat možda neće predstavljati potpunu priču. Upozorenje će se možda pojaviti u vrijeme stvaranja sadržaja da bi vas podsjetilo na to ograničenje i predložilo prebacivanje na rješenja koja je moguće delegirati kad god je to moguće. Dodatne informacije potražite u odjeljku Pregled delegiranja.

Sintaksa

Collect( DataSource, item, ... )

  • Izvor podataka– obavezno. Izvor podataka u koji želite dodati podatke. Ako već ne postoji, stvara se zbirka.
  • Stavke - obavezno. Jedan ili više zapisa ili tablica koje treba dodati na izvor podataka.

Clear( Zbirka )

  • Zbirka – Obavezno. Zbirka koju želite očistiti.

ClearCollect( Zbirka, stavka, ... )

  • Zbirka – Obavezno. Zbirka koju želite očistiti a zatim dodati podatke.
  • Stavke - obavezno. Jedan ili više zapisa ili tablica koje treba dodati na izvor podataka.

Primjeri

Brisanje i dodavanje zapisa u izvor podataka

U ovim primjerima, izbrisat će i dodati zbirku koje je nazvana Sladoled. Izvor podataka počinje s ovim sadržajem:

Uzorak izvora podataka.

Formula Opis Rezultat
ClearCollect( IceCream, { Okus: "Jagode", Količina: 300 } ) Briše sve podatke iz zbirke Sladoled a zatim dodaje zapis koji uključuje količinu sladoleda od jagode. Tablica s jednim zapisom.

Zbirka Sladoled je također izmijenjena.
Collect( IceCream, { Okus: "Pistachio", Količina: 40 }, { Okus: "Narančasta", Količina: 200 } ) Dodaje dva zapisa za zbirku Sladoled koja uključuje količinu sladoleda od pistacija i naranče. Tablica s dva zapisa.

Zbirka Sladoled je također izmijenjena.
Clear(IceCream) Uklanja sve zapise iz zbirke Sladoled. Prazan stol.

Zbirka Sladoled je također izmijenjena.

Detaljne primjere o tome kako stvoriti zbirku pogledajte Stvori i ažuriraj zbirku.

Zapisi i tablice

U tim se primjerima provjerava na koji način zapis i argumenti tablice obrađuju CollectClearCollect .

Formula Opis Rezultat
ClearCollect( IceCream, { Okus: "Čokolada", Količina: 100 }, { Okus: "Vanilla", Količina: 200 } ) Clear svi podaci, a zatim dodaje dva zapisa u zbirku IceCream koja sadrži količinu čokolade i sladoleda od vanile. Zapisi koji se dodaju navedeni su kao pojedinačni argumenti za funkciju. Ploče čokolade i vanilije dodane su u kolekciju.

Zbirka Sladoled je također izmijenjena.
ClearCollect( IceCream, Table( { Okus: "Čokolada", Količina: 100 }, { Okus: "Vanilla", Količina: 200 } ) ) Isto kao i prethodni primjer, osim što su zapisi kombinirani u tablici i proslijeđeni kroz jedan argument. Sadržaj tablice izdvojen je zapis po zapis prije nego što je dodan u zbirku Sladoled. Ploče o čokoladi i vaniliji dodane u kolekciju i izmijenjene.

Zbirka Sladoled je također izmijenjena.
ClearCollect(IceCream,
{ MyFavorites: Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 200 } ) } )
Isto kao i prethodni primjer, osim što je tablica prelomljena u zapis. Zapisi tablice se ne izdvajaju, a umjesto toga cijela tablica dodaje se kao ćelija zapisa. Ploče čokolade i vanilije dodane u kolekciju modificirane stolom umotanim u ploču.

Zbirka Sladoled je također izmijenjena.