Funkcijas Noņemt un noņemtIf

Attiecas uz: Audekla programmām Modeļa vadītas programmas Power Platform CLI

Noņem ierakstus no datu avota.

Piezīmes

PAC CLI pac power-fx komandas neatbalsta funkciju RemoveIf .

Apraksts

Noņemšanas funkcija

Izmantojiet funkciju Remove funkciju, lai no datu avota noņemtu konkrētu ierakstu vai ierakstus.

Kolekcijām jāatbilst visam ierakstam. Varat izmantot argumentu RemoveFlags.All , lai noņemtu visas ieraksta kopijas; pretējā gadījumā tiek noņemta tikai viena ieraksta kopija.

Funkcija RemoveIf

Izmantojiet funkciju RemoveIf, lai noņemtu ierakstu vai ierakstus, pamatojoties uz nosacījumu vai nosacījumu kopu. Katrs nosacījums var būt jebkura formula, kas rezultējas vērtībā true vai false un var atsaukties uz datu avota kolonnām pēc nosaukuma. Katrs nosacījums tiek izvērtēts atsevišķi katram ierakstam, un ieraksts tiek noņemts ja visu nosacījumu vērtība ir true.

Funkcijas Remove un RemoveIf atgriež pārveidoto datu avotu kā tabulu. Šīs abas funkcijas varat izmantot vienīgi uzvedības formulās.

Varat izmantot arī funkciju Clear, lai noņemtu visus kolekcijas ierakstus.

Deleģēšana

Lietojot kopā ar datu avots, šīs funkcijas nevar deleģēt. Tiks izgūta tikai pirmā datu avota daļa, un pēc tam tiks izmantota funkcija. Tas var neatspoguļot visu stāstu. Autorēšanas laikā var tikt parādīts brīdinājums, lai atgādinātu jums par šo ierobežojumu.

Deleģēšanas atbalsts (eksperimentāls)

RemoveIf deleģēšanas atbalsts tagad ir pieejams eksperimentālajā priekšskatījumā (noklusējuma IZSLĒGTS) datu avotiem, kas to atbalsta. Ja datu avots neatbalsta šo līdzekli, tiks nosūtīts vaicājums uz serveri un izgūti visi dati, kas atbilst filtra izteiksmei, līdz maksimālajam līmenim 500, Power Apps 2000 vai datu lappuses lielumam. Pēc tam tas veiks dzēšanas darbību katram no šiem ierakstiem ar atsevišķiem zvaniem uz serveri.

Sintakse

Remove( DataSource,Record1[,Record2 , ... ] [, RemoveFlags.All ] )

• DataSource – Obligāti. Datu avots, kas satur ierakstu vai ierakstus, kurus vēlaties noņemt.
• Ieraksts(i) — Obligāti. Noņemamais ieraksts vai ieraksti.
• RemoveFlags.All – Pēc izvēles. Kolekcijā viens un tas pats ieraksts var parādīties vairāk nekā vienu reizi. Varat pievienot argumentu RemoveFlags.All , lai noņemtu visas ieraksta kopijas.

Remove( DataSource,Table[,RemoveFlags.All ] )

• DataSource – Obligāti. Datu avots, kas satur ierakstus, kurus vēlaties noņemt.
• Tabula — Obligāti. Noņemamo ierakstu tabula.
• RemoveFlags.All – Pēc izvēles. Kolekcijā viens un tas pats ieraksts var parādīties vairāk nekā vienu reizi. Varat pievienot argumentu RemoveFlags.All , lai noņemtu visas ieraksta kopijas.

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

• DataSource – Obligāti. Datu avots, kas satur ierakstu vai ierakstus, kurus vēlaties noņemt.
• Nosacījums(-i) – Obligāti. Formula ar vērtību true noņemamajam ierakstam vai ierakstiem. Formulā varat izmantot kolonnu nosaukumus no DataSource. Ja norādāt vairākus Nosacījumus, visiem ir jābūt ar vērtību true, lai ierakstu vai ierakstus noņemtu.

Piemēri — atsevišķas formulas

Šajos piemēros noņemti ierakstu vai ierakstus datu avotā ar nosaukumu IceCream, kurš sākas ar šīs tabulas datiem:

Izveidojiet parauga ierakstu kolekciju

Lai izveidotu kolekciju ar šiem datiem:

1. Ievietojiet Button vadīklu.

2. Pogas vadīklas rekvizītu OnSelect iestatiet uz šādu formulu:

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

3. Atlasiet pogu, turot nospiestu Alt taustiņu:

Noņem ierakstu paraugus no kolekcijas, izmantojot formulu

Formula	Apraksts	Rezultāts
Remove( IceCream, LookUp( IceCream, Flavor="Šokolāde" ))	Noņem ierakstu Šokolādes no datu avota.	Datu avots IceCream ticis modificēts.
Remove( IceCream, LookUp( IceCream, Flavor="Chocolate" ), LookUp( IceCream, Flavor="Strawberry" ) )	Noņem divus ierakstus no datu avota.	Datu avots IceCream ticis modificēts.
RemoveIf(IceCream, Daudzums > 150 )	Noņem ierakstus, kuriem Daudzums ir lielāks par 150.	Datu avots IceCream ticis modificēts.
RemoveIf( IceCream, Daudzums > 150, Left ( Flavor, 1) = "S" )	Noņem ierakstus, kuru Daudzums ir lielāks par 150 un Garša sākas ar S.	Datu avots IceCream ticis modificēts.
RemoveIf( IceCream, true )	Noņem visus ierakstus no datu avota.	Datu avots IceCream ticis modificēts.

Piemēri — noņemšanas poga galerijas ārpusē

Šajā piemērā jūs izmantosiet Galerijas vadīklu, lai tabulā uzskaitītu ierakstus. Un tad izmantojiet funkciju Remove, lai selektīvi noņemtu vienumu.

Parauga datu sagatavošana

Šajā piemērā tiek izmantota tabula Kontaktpersonas programmā Microsoft Dataverse, kas pieejama programmas un datu paraugā. Varat izvietot programmu un datu paraugus, kad veidojat vidi. Varat arī tā vietā lietot jebkuru citu datu avotu.

Noņemšanas poga galerijas ārpusē

Šajā piemērā jūs noņemsit vienumu, izmantojot pogu, kas atrodas galerijas ārpusē.

1. Izveidojiet jaunu, tukšu pamatnes programmu, izmantojot tālruņa izkārtojumu.

   

2. Kreisajā rūtī atlasiet Ievietot.

3. Atlasiet Vertikāla galerija.
   Galerijas vadīklu pievienos jūsu ekrānam.

   

4. Jums tiks piedāvāts atlasīt datu avotu, kurā varat atlasīt datu avotu no pieejamajiem datu avotiem.
   Piemēram, atlasiet tabulu Kontaktpersonas, lai izmantotu datu paraugu:

   

   Galerija parāda šīs tabulas elementus:

   

5. Ievietojiet Button vadīklu no kreisās rūts:

   

6. Pārvietojiet pievienoto pogu zem galerijas vienumiem:

   

7. Atjauniniet pogas teksta rekvizītu uz Noņemt ierakstu. Varat arī izmantot paša izvēlētu tekstu:

   

8. Iestatiet šīs pogas vadīklas rekvizītu OnSelect uz šādu formulu:

   Remove( Contacts, Gallery1.Selected )
   

   

   Galerijas vadīkla padara pašreiz atlasīto ierakstu pieejamu, izmantojot rekvizītu Atlasīts. Remove funkcija atsaucas uz šo atlasīto ierakstu, lai to noņemtu.

9. Priekšskatiet programmu, izmantojot pogu Atskaņot augšējā labajā pusē vai uz klaviatūras nospiežot F5:

   

10. Atlasiet noņemamo ierakstu, piemēram, šī piemēra ierakstu Rūta:

    

11. Atlasiet Noņemt ierakstu:

    

    Atlasot pogu, tiek noņemts atlasītais ieraksts (šajā gadījumā — Rūtas ieraksts).

12. Aizveriet programmas priekšskatījumu.

    Padoms

    Varat arī izmantot alternatīvu rīcību ar taustiņu Alt, nevis lietot programmas priekšskatījumu ar Atskaņošanas pogu vai F5.

Piemēri — atkritnes ikona galerijas iekšpusē

Šajā piemērā jūs noņemsit vienumu, izmantojot ikonu, kas atrodas galerijas iekšpusē.

Izveidojiet kolekciju ar parauga datiem

Ja jums jau ir sagatavots datu paraugs, izlaidiet šo darbību un pārejiet uz Atkritnes ikona galerijas iekšpusē.

1. Pievienojiet savam ekrānam vadīklu Button.

2. OnSelect rekvizītam iestatiet šādu formulu:

   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. Atlasiet pogu, turot nospiestu Alt taustiņu.

Tiek izveidota parauga kolekcija, kuru varat izmantot šajā piemērā.

Atkritnes ikona galerijas iekšpusē

1. Izveidojiet jaunu, tukšu pamatnes programmu, izmantojot tālruņa izkārtojumu.

   

2. Kreisajā rūtī atlasiet Ievietot.

3. Atlasiet Vertikāla galerija.
   Galerijas vadīklu pievienos jūsu ekrānam.

   

4. Jums tiks piedāvāts atlasīt datu avotu, kurā varat atlasīt datu avotu no pieejamajiem datu avotiem.
   Piemēram, atlasiet tabulu Kontaktpersonas, lai izmantotu datu paraugu:

   

   Ja izveidojāt kolekciju, tā vietā atlasiet savu kolekciju:

   

5. Galerijas augšējā vienumā atlasiet vadīklu.
   

   Lai nodrošinātu, ka nākamā darbība tos ievada galerijas vadīklā un nevis ārpusē, pārliecinieties, ka izpildāt šo darbību, pirms pārejat pie nākamās.

   

6. Kreisajā rūtī atlasiet Pievienot ikonu.
   

   

   Piezīmes

   Pievienot ikonu ievada + ikonu galerijas kreisajā pusē, kuru replicē katram galerijas vienumam.

7. Augšējā vienumā pārvietojiet ikonu uz ekrāna labo pusi.

   

8. Atlasiet rekvizītu Ikona ikonai un iestatiet to uz šādu formulu, lai atjauninātu ikonas attēlu kā atkritnes ikonu:

   Icon.Trash
   

   Note

   Ikona tiek radīta vienīgi tad, ja aktīvi rediģējat formulu.

   

9. OnSelect rekvizītam iestatiet šādu formulu:

   Remove( [@Contacts], ThisItem )
   

   Piezīmes

   Šajā piemērā jāizmanto globālais viennozīmīgais operators[@...] ar datu paraugu, kas izmanto tabulu Kontaktpersonas, lai izvairītos no konfliktsituācijas ar attiecībām Viens pret daudziem. Ja izmantojat datu avotus, piemēram, sarakstu vai SQL Server tabulu, nav nepieciešams izmantot vispārējo nozīmju operatoru.

   

10. Priekšskatiet programmu, izmantojot pogu Atskaņot augšējā labajā pusē vai uz klaviatūras nospiežot F5.

11. Atlasiet atkritnes ikonu blakus ierakstam, piemēram Maria.

    

    Ieraksts ir dzēsts:

    

12. Aizveriet programmas priekšskatījumu.