Funkcie Remove a RemoveIf

Platí pre: aplikácie plátna aplikácie riadené modelom Power Platform CLI

Umožňuje odstrániť záznamy zo zdroja údajov.

Poznámka

PAC CLI príkazy pac power-fx nepodporujú funkciu RemoveIf .

Description

Funkcia Remove

Na odstránenie konkrétneho záznamu alebo záznamov zo zdroja údajov použite funkciu Remove.

V prípade kolekcií sa musí zhodovať celý záznam. Na odstránenie všetkých kópií záznamu môžete použiť argument RemoveFlags.All ; inak sa odstráni iba jedna kópia záznamu.

Funkcia RemoveIf

Na odstránenie záznamu alebo záznamov na základe podmienky alebo skupiny podmienok použite funkciu RemoveIf. Každá podmienka môže byť ľubovoľný vzorec, ktorého výsledkom je pravda alebo nepravda, a môže pomocou názvu odkazovať na stĺpce zdroja údajov. Každá podmienka sa vyhodnotí samostatne pre jednotlivé záznamy. Záznam sa odstráni, keď sa všetky podmienky vyhodnotia ako pravda.

Funkcie Remove a RemoveIf vracajú upravený zdroj údajov ako tabuľku. Môžete ich použiť iba vo vzorcoch správania.

Môžete použiť aj funkciu Clear a odstrániť všetky záznamy v kolekcii.

Delegovanie

Pri použití s ​​zdroj údajov tieto funkcie nemožno delegovať. Načíta sa iba prvá časť zdroja údajov a potom sa použije príslušná funkcia. Toto nemusí predstavovať úplný príbeh. V čase tvorby sa môže zobraziť varovanie, ktoré vám toto obmedzenie pripomenie.

Podpora delegácie (experimentálna)

Podpora delegovania pre RemoveIf je teraz v experimentálnej ukážke (predvolene VYPNUTÉ) pre zdroje údajov, ktoré ju podporujú. Ak zdroj údajov nepodporuje túto funkciu, Power Apps odošle dotaz na server a získa všetky údaje, ktoré zodpovedajú výrazu filtra až do maximálnej hodnoty 500, 2000 alebo veľkosti dátovej stránky. Potom vykoná operáciu vymazania každého z týchto záznamov s individuálnymi volaniami na server.

Syntax

Odstrániť( Zdroj údajov, Záznam1 [, Záznam2 , ... ] [, RemoveFlags.All ] )

  • DataSource – povinné. Zdroj údajov obsahujúci záznam alebo záznamy, ktoré chcete odstrániť.
  • Record1, Record2, … – povinné. Záznam alebo záznamy, ktoré chcete odstrániť.
  • RemoveFlags.All – Voliteľné. V kolekcii sa rovnaký záznam môže vyskytovať viackrát. Ak chcete odstrániť všetky kópie záznamu, môžete pridať argument RemoveFlags.All .

Odstrániť( Zdroj údajov, Tabuľka [, Odstrániť príznaky .Všetky ] )

  • DataSource – povinné. Zdroj údajov obsahujúci záznam alebo záznamy, ktoré chcete odstrániť.
  • Table – povinné. Tabuľka so záznamami na odstránenie.
  • RemoveFlags.All – Voliteľné. V kolekcii sa rovnaký záznam môže vyskytovať viackrát. Ak chcete odstrániť všetky kópie záznamu, môžete pridať argument RemoveFlags.All .

RemoveIfDataSource, Condition [, ... ] )

  • DataSource – povinné. Zdroj údajov obsahujúci záznam alebo záznamy, ktoré chcete odstrániť.
  • Condition1, Condition1, … – povinné. Vzorec, ktorý sa vyhodnotí ako pravda v prípade záznamu alebo záznamov, ktoré chcete odstrániť. Vo vzorci môžete použiť názvy stĺpcov z DataSource. Ak určíte viacero podmienok, všetky sa musia vyhodnotiť ako pravda, aby sa záznam alebo záznamy odstránili.

Príklady – jednotlivé vzorce

V týchto príkladoch odstránite záznam alebo záznamy v zdroji údajov s názvom Zmrzlina, ktorý sa začína údajmi uvedenými v tejto tabuľke:

Príklad Zmrzlina.

Vytvorenie kolekcie so vzorkami záznamov

Ak chcete vytvoriť kolekciu s týmito údajmi:

  1. Vložte ovládací prvok Tlačidlo.

  2. Vlastnosť OnSelect ovládacieho prvku Tlačidlo nastavte na nižšie uvedený vzorec:

    ClearCollect( IceCream,
                  { ID: 1, Flavor: "Chocolate",  Quantity: 100 },
                  { ID: 2, Flavor: "Vanilla",    Quantity: 200 },
                  { ID: 3, Flavor: "Strawberry", Quantity: 300 }
    )
    
  3. Podržte kláves Alt a vyberte tlačidlo:

Odstránenie ukážkových záznamov z kolekcie pomocou vzorca

Vzorec Description Result
Remove( IceCream,
LookUp( IceCream, Flavor="Chocolate" ))
Odstráni zo zdroja údajov záznam Čokoláda. Výsledok s vanilkou a jahodou.

Zdroj údajov IceCream bol zmenený.
Remove( IceCream,
LookUp( IceCream, Flavor="Chocolate" ), LookUp( IceCream, Flavor="Jahoda" ) )
Odstráni dva záznamy zo zdroja údajov. Výsledkom je iba vanilka.

Zdroj údajov IceCream bol zmenený.
RemoveIf( Zmrzlina, Množstvo > 150 ) Odstráni záznamy, ktorých hodnota Množstvo je väčšia ako 150. Výsledok iba s čokoládou.

Zdroj údajov IceCream bol zmenený.
RemoveIf( Zmrzlina, Množstvo > 150, Left( Príchuť, 1 ) = "S" ) Odstráni záznamy, ktoré majú hodnotu Množstvo väčšiu ako 150, a hodnota Príchuť sa začína písmenom S. Výsledok s čokoládou a vanilkou.


Zdroj údajov IceCream bol zmenený.
RemoveIf( Zmrzlina, true ) Odstráni všetky záznamy zo zdroja údajov. Výsledok bez zmrzliny.

Zdroj údajov IceCream bol zmenený.

V tomto príklade použijete ovládací prvok Galéria na zobrazenie zoznamu záznamov v tabuľke. A potom použite funkciu Remove na selektívne odstránenie položky.

Príprava pre vzorové údaje

Tento príklad používa tabuľku Kontakty v Microsoft Dataverse k dispozícii so vzorovými aplikáciami a údajmi. Môžete nasadiť vzorové aplikácie a údaje, keď vytvoríte prostredie. Namiesto toho môžete použiť aj zdroj údajov.

V tomto príklade odstránite položku pomocou tlačidla, ktoré je mimo galérie.

  1. Vytvorenie novej prázdnej aplikácie plátna pomocou rozloženia telefónu.

    Prázdna aplikácia plátna, ktorá využíva rozloženie telefónu.

  2. Na ľavej navigačnej table vyberte položku Vložiť.

  3. Vyberte Vertikálna galéria.
    Ovládací prvok Galéria sa pridá na vašu obrazovku.

    Pomocou tably s nástrojmi Vložiť pridajte ovládací prvok vertikálnej galérie.

  4. Zobrazí sa výzva na výber zdroja údajov, kde si môžete z dostupných zdrojov údajov vybrať zdroj údajov.
    Napríklad vyberte tabuľku Kontakty na použitie vzorových údajov:

    Výber tabuľky Kontakty, ktorá sa má zobraziť v galérii.

    Galéria zobrazuje položky z tejto tabuľky:

    Bola pridaná galéria zobrazujúca tabuľku Kontakty.

  5. Vložte ovládací prvok Tlačidlo z ľavej tably:

    Pomocou tably s nástrojmi Vložiť pridajte ovládací prvok tlačidlo.

  6. Presuňte pridané tlačidlo pod položky galérie:

    Tlačidlo Presunúť.

  7. Aktualizujte vlastnosť textu tlačidla na Odstrániť záznam. Môžete tiež použiť ľubovoľný text:

    Tlačidlo Premenovať.

  8. Vlastnosť OnSelect pre tento ovládací prvok tlačidla nastavte na tento vzorec:

    Remove( Contacts, Gallery1.Selected )
    

    Nastavenie vlastnosti OnSelect ovládacieho prvku Tlačidlo.

    Ovládací prvok galérie sprístupňuje aktuálne vybraný záznam pomocou vlastnosti Selected. Funkcia Remove odkazuje na tento vybraný záznam na jeho odstránenie.

  9. Zobrazte ukážku aplikácie pomocou tlačidla Prehrať v pravom hornom rohu alebo stlačte F5 na klávesnici:

    Ukážka aplikácie.

  10. Vyberte záznam, ktorý chcete odstrániť, napr. záznam od Nancy v tomto príklade:

    Výber záznam.

  11. Vyberte Odstrániť záznam:

    Galéria kontaktov, teraz bez záznamu Nancy, ktorý bol odstránený.

    Výberom tlačidla sa vybraný záznam odstráni (v tomto príklade záznam od Nancy).

  12. Zatvorte ukážku aplikácie.

    Prepitné

    Môžete tiež použiť alternatívne správanie s klávesom Alt namiesto použitia ukážky aplikácie pomocou tlačidla Prehrať alebo F5.

V tomto príklade odstránite položku pomocou ikony, ktorá je vnútri galérie.

Vytvorenie kolekcie so vzorkami údajov

Ak už máte pripravené údaje so vzorkami, tento krok preskočte a prejdite na Ikona koša v galérii.

  1. Pridajte na obrazovku ovládací prvok Tlačidlo.

  2. Vlastnosť OnSelect nastavte na tento vzorec:

    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. Podržte kláves Alt a vyberte tlačidlo.

Vytvorí sa kolekcia vzoriek, ktorú môžete použiť v nasledujúcom príklade.

  1. Vytvorenie novej prázdnej aplikácie plátna pomocou rozloženia telefónu.

    Prázdna aplikácia plátna, ktorá využíva rozloženie telefónu.

  2. Na ľavej navigačnej table vyberte položku Vložiť.

  3. Vyberte Vertikálna galéria.
    Ovládací prvok Galéria sa pridá na vašu obrazovku.

    Pomocou tably s nástrojmi Vložiť pridajte ovládací prvok vertikálnej galérie.

  4. Zobrazí sa výzva na výber zdroja údajov, kde si môžete z dostupných zdrojov údajov vybrať zdroj údajov.
    Napríklad vyberte tabuľku Kontakty na použitie vzorových údajov:

    Výber tabuľky Kontakty, ktorá sa má zobraziť v galérii.

    Ak ste vytvorili a kolekciu, namiesto toho vyberte svoju kolekciu:

    Kolekcia vzorky kontaktov.

  5. Vyberte ovládací prvok v hornej položke v galérii.

    Ak chcete zaistiť, aby ďalší krok vložil položku do šablóny galérie a nie mimo galérie, uistite sa, že ste pred ďalším krokom vykonali tento krok.

    Vyberte horný záznam v galérii.

  6. Vyberte Pridať ikonu z ľavej tably.

    Pomocou tably s nástrojmi Vložiť pridajte ovládací prvok ikony.

    Poznámka

    Pridať ikonu vloží ikonu + na ľavej strane galérie, replikovane pre každú položku v galérii.

  7. V hornej časti presuňte ikonu na pravú stranu obrazovky.

    Presun ikony.

  8. Vyberte vlastnosť Icon pre ikonu a nastavte ju na nasledujúci vzorec na aktualizáciu obrázka ikony ako ikony koša:

    Icon.Trash
    

    Poznámka

    Predpona Icon. sa zobrazuje iba vtedy, keď aktívne upravujete vzorec.

    Zmena ikony na ikonu koša.

  9. Vlastnosť OnSelect nastavte na tento vzorec:

    Remove( [@Contacts], ThisItem )
    

    Poznámka

    Musíte použiť operátor globálneho rozlišovania [@...] v tomto príklade so vzorovými údajmi, ktoré používajú tabuľku Kontakty, aby nedošlo ku konfliktu so vzťahom typu Jeden k mnohým. Ak používate zdroje údajov, ako napríklad zoznam alebo tabuľku SQL Server, použitie globálneho operátora rozlišovania sa nevyžaduje.

    OnSelect pre ikonu koša.

  10. Zobrazte ukážku aplikácie pomocou tlačidla Prehrať v pravom hornom rohu alebo stlačte F5 na klávesnici.

  11. Vyberte ikonu koša vedľa záznamu, napríklad Maria:

    Galéria s odstráneným jedným z kontaktov.

    Záznam je odstránený:

    Odstránený záznam.

  12. Zatvorte ukážku aplikácie.