Funkcije Prikupljanje, Brisanje i ClearCollect

  • Članak

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

Collect

Odnosi se na: Aplikacije od gotovih gradivnih elemenata Kartice Dataverse s niskim kodom CLI Power Platform dodaci

Funkcija Collect dodaje zapise na 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 formula ponašanja.

Clear

Odnosi se na: Aplikacije od gotovih gradivnih elemenata

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

Imajte na umu da Clear radi samo na zbirkama, 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

Odnosi se na: Aplikacije od gotovih gradivnih elemenata Aplikacije stvorene prema modelu

Funkcija ClearCollect briše sve zapise iz zbirke. A zatim u istu zbirku dodaje drugačiji skup zapisa. S jednom funkcijom, 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, ... )

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

Clear( Zbirka )

  • Collection – obavezno. Zbirka koju želite očistiti.

ClearCollect( Zbirka, Item, ... )

  • Collection – obavezno. Zbirka koju želite očistiti a zatim dodati podatke.
  • Item(s) – 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, { Flavor: "Strawberry", Quantity: 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, { Flavor: "Pistachio", Quantity: 40 }, { Flavor: "Orange", Quantity: 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

Ovi primjeri ispituju kako su odraženi argumenti zapis i tablica za 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 za zbirku Sladoled koja uključuje količinu sladoleda od čokolade i vanilije. Zapisi koji se dodaju navedeni su kao pojedinačni argumenti za funkciju. Zapisi o čokoladi i vaniliji dodani u kolekciju.

Zbirka Sladoled je također izmijenjena.
ClearCollect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 }, { Flavor: "Vanilla", Quantity: 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. Zapisi o čokoladi i vaniliji dodani u kolekciju i modificirani.

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. Zapisi o čokoladi i vaniliji dodani u kolekciju izmijenjeni stolom omotanim u zapis.

Zbirka Sladoled je također izmijenjena.