Funkciji Remove in RemoveIf

Velja za: Aplikacije Canvas Aplikacije, ki temeljijo na modelu Power Platform CLI

Odstrani zapise iz vira podatkov.

opomba,

Ukazi PAC CLI pac power-fx ne podpirajo funkcije RemoveIf .

Description

Odstranjevanje funkcije

Uporabite funkcijo Remove, da odstranite določen zapis ali zapise iz vira podatkov.

Pri zbirkah se mora ujemati celoten zapis. Za odstranitev vseh kopij zapisa lahko uporabite argument RemoveFlags.All ; sicer se odstrani le ena kopija zapisa.

Funkcija »RemoveIf«

Uporabite funkcijo RemoveIf in odstranite zapis ali zapise na podlagi pogoja ali nabora pogojev. Posamezni pogoj je lahko katera koli formula, ki vrne vrednost true ali false in se lahko sklicuje na stolpce vira podatkov po imenu. Vsak pogoj je ovrednoten posebej za vsak zapis in zapis se odstrani, če imajo vsi pogoji vrednost true.

Funkciji Remove in RemoveIf vrneta spremenjeni vir podatkov kot tabelo. Funkciji lahko uporabljate samo v formulah za delovanje.

Uporabite lahko tudi funkcijo Clear in odstranite vse zapise v zbirki.

Pooblastitev

Pri uporabi z vir podatkov teh funkcij ni mogoče delegirati. Pridobljen bo samo prvi del vira podatkov, nato bo uporabljena funkcija. To morda ne predstavlja celotne zgodbe. Med avtorskim delom se lahko pojavi opozorilo, ki vas opomni na to omejitev.

Podpora za delegiranje (eksperimentalno)

Podpora za delegiranje za RemoveIf je zdaj v poskusnem predogledu (privzeto IZKLOPLJENO) za vire podatkov, ki to podpirajo. Če vir podatkov ne podpira te funkcije, Power Apps bo poslal poizvedbo strežniku in pridobil vse podatke, ki se ujemajo z izrazom filtra do največ 500, 2000 ali velikosti podatkovne strani. Nato bo izvedel operacijo brisanja vsakega od teh zapisov s posameznimi klici strežnika.

Sintaksa

Odstrani( Vir podatkov, Zapis1 [, Zapis2 , ... ] [, Odstrani zastavice. Vse ] )

• DataSource – obvezno. Vir podatkov, ki vsebuje zapis ali zapise, ki jih želite odstraniti.
• Record(s) – obvezno. Zapis ali zapisi, ki jih želite odstraniti.
• RemoveFlags.All – Izbirno. V zbirki se lahko isti zapis prikaže večkrat. Dodate lahko argument RemoveFlags.All , da odstranite vse kopije zapisa.

Odstrani( Vir podatkov, Tabela [, Odstrani zastavice .Vse ] )

• DataSource – obvezno. Vir podatkov, ki vsebuje zapise, ki jih želite odstraniti.
• Table – obvezno. Tabela zapisov, ki jo želite odstraniti.
• RemoveFlags.All – Izbirno. V zbirki se lahko isti zapis prikaže večkrat. Dodate lahko argument RemoveFlags.All , da odstranite vse kopije zapisa.

RemoveIf( DataSource, Condition [, ... ] )

• DataSource – obvezno. Vir podatkov, ki vsebuje zapis ali zapise, ki jih želite odstraniti.
• Condition(s) – obvezno. Formula, ki vrne vrednost true za zapis ali zapise, ki jih želite odstraniti. V formuli lahko uporabite imena stolpcev iz vira podatkov DataSource. Če določite več pogojev, morajo imeti vsi vrednost true za zapis ali zapise, ki jih želite odstraniti.

Primeri – posamezne formule

V teh primerih boste odstranite zapis ali zapise v viru podatkov z imenom IceCream, ki se začne s podatki v tej tabeli:

Ustvarjanje zbirke z vzorčnimi zapisi

Ustvarjanje zbirke s temi podatki:

1. Vstavite kontrolnik Button.

2. Lastnost OnSelect kontrolnika »Button« nastavite na spodnjo formulo:

   ClearCollect( IceCream,
                 { ID: 1, Flavor: "Chocolate",  Quantity: 100 },
                 { ID: 2, Flavor: "Vanilla",    Quantity: 200 },
                 { ID: 3, Flavor: "Strawberry", Quantity: 300 }
   )
   

3. Izberite gumb, medtem ko držite tipko Alt:

Odstranjevanje vzorčnih zapisov iz zbirke s formulo

Formula	Description	Rezultat
Remove( IceCream, LookUp (sladoled, okus="čokolada"))	Odstrani zapis Chocolate iz vira podatkov.	Vir podatkov IceCream je bil spremenjen.
Remove( IceCream, LookUp( IceCream, Flavor="Čokolada"), LookUp( IceCream, Flavor="Jagoda" ) )	Odstrani dva zapisa iz vira podatkov.	Vir podatkov IceCream je bil spremenjen.
RemoveIf( IceCream, Quantity > 150 )	Odstrani zapise, pri katerih je količina večja od 150.	Vir podatkov IceCream je bil spremenjen.
RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" )	Odstrani zapise, pri katerih je količina večja od 150 in pri katerih se okus začne s črko S.	Vir podatkov IceCream je bil spremenjen.
RemoveIf( IceCream, true )	Odstrani vse zapise iz vira podatkov.	Vir podatkov IceCream je bil spremenjen.

Primeri – gumb za odstranjevanje zunaj galerije

V tem primeru boste uporabili kontrolnik Gallery za seznam zapisov v tabeli. Nato uporabite funkcijo Remove za selektivno odstranitev elementa.

Priprava za vzorčne podatke

Ta primer uporablja tabelo Stiki v okolju Microsoft Dataverse, ki je na voljo z vzorčnimi aplikacijami in podatki. Ko ustvarjate okolje, lahko uporabite vzorčne aplikacije in podatke. Uporabite lahko tudi katerikoli drug vir podatkov.

Gumb za odstranjevanje zunaj galerije

V tem primeru boste element odstranili z uporabo gumba zunaj galerije.

1. Ustvarite novo prazno aplikacijo s platnom z uporabo postavitve za telefon.

   

2. V levem podoknu izberite Vstavljanje.

3. Izberite Navpična galerija.
   Kontrolnik Gallery je dodan na vaš zaslon.

   

4. Izbrati morate vir podatkov, pri katerem lahko izberete vir podatkov med razpoložljivimi viri podatkov.
   Izberite na primer tabelo Stiki za uporabo vzorčnih podatkov:

   

   Galerija prikazuje predmete iz te tabele:

   

5. Vstavite kontrolnik Button iz levega podokna:

   

6. Dodani gumb premaknite pod elemente galerije:

   

7. Posodobite lastnost besedila gumba na Odstrani zapis. Uporabite lahko tudi besedilo pa lastni izbiri:

   

8. Nastavite lastnost OnSelect za ta kontrolnik »Button« na to formulo:

   Remove( Contacts, Gallery1.Selected )
   

   

   V kontrolniku galerije je trenutno izbran zapis na voljo z uporabo lastnosti Selected. Funkcija Remove se nanaša na ta izbrani zapis, ki ga želite odstraniti.

9. Odprite predogled aplikacije z gumbom Predvajaj v zgornjem desnem kotu ali pritisnite F5 na tipkovnici:

   

10. Izberite zapis, ki ga želite odstraniti, na primer Nancyjin zapis v tem primeru:

    

11. Izberite Odstrani zapis:

    

    Če izberete gumb, odstranite izbrani zapis (v tem primeru Nancyjin zapis).

12. Zaprite predogled aplikacije.

    Napitnina

    Namesto predogleda aplikacije z gumbom Predvajaj ali tipko F5 lahko s tipko Alt uporabite tudi drugačno delovanje.

Primeri – ikona koša v galeriji

V tem primeru boste element odstranili z uporabo ikone v galeriji.

Ustvarjanje zbirke z vzorčnimi podatki

Če že imate pripravljene vzorčne podatke, preskočite ta korak in se premaknite na razdelek Ikona koša v galeriji.

1. Dodajte kontrolnik Button na svoj zaslon.

2. Lastnost OnSelect nastavite na to formulo:

   ClearCollect( SampleContacts,
         { 'Full Name': "Yvonne McKay (sample)",      'Primary Email': "someone_a@example.com" },
         { 'Full Name': "Susanna Stubberod (sample)", 'Primary Email': "someone_b@example.com" },
         { 'Full Name': "Nancy Anderson (sample)",    'Primary Email': "someone_c@example.com" },
         { 'Full Name': "Maria Campbell (sample)",    'Primary Email': "someone_d@example.com" },
         { 'Full Name': "Robert Lyon (sample)",       'Primary Email': "someone_e@example.com" },
         { 'Full Name': "Paul Cannon (sample)",       'Primary Email': "someone_f@example.com" },
         { 'Full Name': "Rene Valdes (sample)",       'Primary Email': "someone_g@example.com" }
   )
   

3. Izberite gumb, medtem ko držite tipko Alt.

Ustvari se vzorčna zbirka, ki jo lahko uporabite v spodnjem primeru.

Ikona koša v galeriji

1. Ustvarite novo prazno aplikacijo s platnom z uporabo postavitve za telefon.

   

2. V levem podoknu izberite Vstavljanje.

3. Izberite Navpična galerija.
   Kontrolnik Gallery je dodan na vaš zaslon.

   

4. Izbrati morate vir podatkov, pri katerem lahko izberete vir podatkov med razpoložljivimi viri podatkov.
   Izberite na primer tabelo Stiki za uporabo vzorčnih podatkov:

   

   Če ste ustvarili zbirko, izberite svojo zbirko:

   

5. Izberite kontrolnik v zgornjem elementu v galeriji.
   

   Če želite zagotoviti, da naslednji korak vstavi element v predlogo galerije in ne izven galerije, morate slediti temu koraku, preden se pomaknete na naslednji korak.

   

6. V levem podoknu izberite Dodaj ikono.
   

   

   opomba,

   Možnost Dodaj ikono vstavi ikono + na levi strani galerije in podvoji dejanje za vsak element v galeriji.

7. V zgornjem elementu premaknite ikono na desno stran zaslona.

   

8. Izberite lastnost Icon za ikono in jo nastavite na spodnjo formulo, da posodobite sliko ikone z ikono koša:

   Icon.Trash
   

   opomba,

   Predpona Icon. je prikazana samo, ko aktivno urejate formulo.

   

9. Lastnost OnSelect nastavite na to formulo:

   Remove( [@Contacts], ThisItem )
   

   opomba,

   Uporabiti morate globalni operator za razločitev[@...] v tem primeru z vzorčnimi podatki, ki uporabljajo tabelo Stiki, da se izognete sporu z odnosom eden proti mnogo. Če uporabljate vire podatkov, kot je seznam ali tabela strežnika SQL Server, vam ni treba uporabiti operatorja za globalno razločitev.

   

10. Odprite predogled aplikacije z gumbom Predvajaj v zgornjem desnem kotu ali pritisnite F5 na tipkovnici.

11. Izberite ikono koša poleg zapisa, na primer Marijinega:

    

    Zapis je izbrisan:

    

12. Zaprite predogled aplikacije.