Power Appsin Remove- ja RemoveIf-funktio

Poistaa tietueitatietolähteestä.

Kuvaus

Remove-funktio

Remove-funktiolla voit poistaa tietolähteestä yhden tai useamman tietueen.

Jos kyseessä on kokoelma, koko tietueen on oltava funktion mukainen. Jos haluat poistaa kaikki tietueen kopiot, käytä All-argumenttia; muussa tapauksessa vain yksi tietueen kopio poistetaan.

RemoveIf-funktio

Käytä RemoveIf-funktiota, jos haluat soveltaa tietueen/tietueiden poistamiseen yhtä tai useampaa ehtoa. Kukin ehto voi olla mikä tahansa kaava, jonka tulos on true tai false, ja se voi viitata tietolähteen sarakkeisiin nimen mukaan. Kukin ehto arvioidaan erikseen kunkin tietueen osalta, ja tietue poistetaan, jos kaikkien ehtojen arvoksi tulee true.

Sekä Remove että RemoveIf palauttavat muokatun tietolähteen taulukon muodossa. Näitä funktioita voidaan käyttää vain toimintakaavoissa.

Jos haluat poistaa kaikki kokoelman tietueet, voit käyttää myös Clear-funktiota.

Delegointi

Näitä toimintoja ei voi delegoida tietolähdettä käytettäessä. Vain tietolähteen ensimmäinen osa noudetaan ja sitten suoritetaan toiminto. Tulos ei ehkä vastaa kokonaisuutta. Laatimisvaiheessa saatetaan näyttää varoitus, joka muistuttaa tästä rajoituksesta ja kehottaa vaihtamaan delegoitaviin vaihtoehtoihin, jos mahdollista. Lisätietoja on delegoinnin yleiskatsauksessa.

Syntaksi

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

  • DataSource – Pakollinen. Tietolähde, joka sisältää tietueen tai tietueet, jotka haluat poistaa.
  • Record(s) – Pakollinen. Tietue tai tietueet, jotka haluat poistaa.
  • All – Valinnainen. Sama tietue voi näkyä kokoelmassa useamman kerran. Voit lisätä All-argumentin, jos haluat poistaa kaikki tietueen kopiot.

Remove( DataSource, Table [, All ] )

  • DataSource – Pakollinen. Tietolähde, joka sisältää tietueen tai tietueet, jotka haluat poistaa.
  • Table – Pakollinen. Taulukko, joka sisältää poistettavat tietueet.
  • All – Valinnainen. Sama tietue voi näkyä kokoelmassa useamman kerran. Voit lisätä All-argumentin, jos haluat poistaa kaikki tietueen kopiot.

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

  • DataSource – Pakollinen. Tietolähde, joka sisältää tietueen tai tietueet, jotka haluat poistaa.
  • Condition(s) – Pakollinen. Kaava, joka määrittää poistettavan tietueen tai poistettavien tietueiden arvoksi true. Voit käyttää kaavassa DataSource-tietolähteessä olevia sarakenimiä. Jos määrität useita ehtoja (Conditions), niiden kaikkien arvoksi on tultava true, ennen kuin tietue tai tietueet poistetaan.

Esimerkit – yksittäiset kaavat

Näissä esimerkeissä poistat tietueita tietolähteestä, jonka nimi on IceCream ja joka alkaa seuraavan taulukon tiedoilla:

Näytetietueita sisältävän kokoelman luominen

Voit luoda näiden tietojen kokoelman seuraavasti:

  1. Lisää Painike-ohjausobjekti.

  2. Määritä ohjausobjektin OnSelect-ominaisuudeksi seuraava kaava:

    ClearCollect( IceCream,
                  { ID: 1, Flavor: "Chocolate",  Quantity: 100 },
                  { ID: 2, Flavor: "Vanilla",    Quantity: 200 },
                  { ID: 3, Flavor: "Strawberry", Quantity: 300 }
    )
    
  3. Pidä Alt-näppäintä painettuna ja valitse painike:

Mallitietueiden poistaminen kokoelmasta kaavan avulla

Kaava Kuvaus Tulos
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Poistaa tietolähteestä Chocolate-tietueen.

IceCream-tietolähdettä on muokattu.
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ) )
Poistaa tietolähteestä kaksi tietuetta.

IceCream-tietolähdettä on muokattu.
RemoveIf( IceCream, Quantity > 150 ) Muokkaa tietueita, joiden määrä (Quantity) on suurempi kuin 150.

IceCream-tietolähdettä on muokattu.
RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" ) Poistaa tietueita, joiden määrä (Quantity) on suurempi kuin 150 ja maku (Flavor) alkaa S-kirjaimella.


IceCream-tietolähdettä on muokattu.
RemoveIf( IceCream, true ) Poistaa tietolähteestä kaikki tietueet.

IceCream-tietolähdettä on muokattu.

Tässä esimerkissä taulukon tietueet luetellaan Valikoima-ohjausobjektin avulla. Sitten käytetään Remove-funktiota kohteen poistamiseen valikoivasti.

Näytetietojen valmisteleminen

Tämä esimerkki käyttää Contacts-entiteettiä, joka on Common Data Servicessa käytettävissä mallisovelluksissa ja -tiedoissa. Voit ottaa näytesovellukset ja -tiedot käyttöön luodessasi ympäristöä. Voit myös käyttää muita tietolähteitä sen sijaan.

Tässä esimerkissä kohde poistetaan gallerian ulkopuolella olevalla painikkeella.

  1. Luo uusi tyhjä kaaviosovellus käyttämällä puhelinasettelua.

    Tyhjä kaaviosovellus käyttämällä puhelinasettelua.

  2. Valitse vasemmassa siirtymisruudussa Lisää.

  3. Valitse Pystysuora valikoima.
    Valikoima-ohjausobjekti lisätään näyttöön.

    Pystysuuntaisen galleriaohjausobjektin lisääminen Lisää-työkaluruudun avulla

  4. Näyttöön tulee kehote valita tietolähde, jossa voit valita tietolähteen käytettävissä olevista tietolähteistä.
    Valitse esimerkiksi Contacts-entiteetti, jos haluat käyttää näytetietoja:

    Valikoimassa näytettävän Contacts-kohteen valitseminen

    Valikoimassa näkyvät tämän entiteetin kohteet:

    Lisätty Galleria, jossa on Contacts-entiteetti

  5. Painike-ohjausobjektin lisääminen vasemmasta ruudusta:

    Painikeohjausobjektin lisääminen Lisää-työkaluruudun avulla

  6. Siirrä lisätty painike gallerian kohteiden alapuolelle:

    Siirrä-painike

  7. Päivitä painikkeen tekstiominaisuudeksi Poista tietue. Voit myös käyttää mitä tahansa muuta tekstiä:

    Nimeä painike uudelleen

  8. Määritä tämän painikkeen OnSelect-ominaisuudeksi seuraava kaava:

    Remove( Contacts, Gallery1.Selected )
    

    Määritetään painikkeen OnSelect-ominaisuus

    Valikoima-ohjausobjektin avulla valittu tietue on käytettävissä Selected-ominaisuuden avulla. Remove-funktio viittaa tähän valittuun tietueeseen, jotta se voidaan poistaa.

  9. Esikatsele sovellusta oikeassa yläkulmassa olevalla Toista-painikkeella tai paina F5-näppäintä:

    Esikatsele sovellusta

  10. Valitse poistettava tietue, kuten tämän esimerkin Nancy-tietue:

    Valitse tietue

  11. Valitse Poista tietue:

    Yhteyshenkilöiden valikoima, ilman poistettua Nancy-tietuetta

    Painikkeen valitseminen poistaa valitun tietueen (tässä esimerkissä Nancyn tietueen).

  12. Sulje sovelluksen esikatselu.

    Vihje

    Voit myös käyttää vaihtoehtoisia toimintoja Alt- näppäimen avulla sovelluksen esikatselussa Toista-painikkeen tai F5-näppäimen sijaan.

Tässä esimerkissä kohde poistetaan gallerian sisäpuolella olevalla kuvakkeella.

Näytetietoja sisältävän kokoelman luominen

Jos olet jo valmistellut näytetiedot, ohita tämä vaihe ja siirry kohtaan Valikoiman sisällä oleva roskakori.

  1. Lisää Painike-ohjausobjekti näyttöön.

  2. Määritä sen OnSelect-ominaisuudeksi seuraava kaava:

    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. Pidä Alt-näppäintä painettuna ja valitse painike.

Luodaan esimerkkikokoelma, jota voit käyttää seuraavassa esimerkissä.

  1. Luo uusi tyhjä kaaviosovellus käyttämällä puhelinasettelua.

    Tyhjä kaaviosovellus käyttämällä puhelinasettelua.

  2. Valitse vasemmassa siirtymisruudussa Lisää.

  3. Valitse Pystysuora valikoima.
    Valikoima-ohjausobjekti lisätään näyttöön.

    Pystysuuntaisen galleriaohjausobjektin lisääminen Lisää-työkaluruudun avulla

  4. Näyttöön tulee kehote valita tietolähde, jossa voit valita tietolähteen käytettävissä olevista tietolähteistä.
    Valitse esimerkiksi Contacts-entiteetti, jos haluat käyttää näytetietoja:

    Valikoimassa näytettävän Contacts-kohteen valitseminen

    Jos olet luonut kokoelman, valitse sen sijaan oma kokoelmasi:

    Esimerkkiyhteyshenkilökokoelma

  5. Valitse ohjausobjekti valikoiman yläkohteessa.

    Jos haluat varmistaa, että seuraava vaihe lisää kohteen gallerian malliin eikä gallerian ulkopuolelle, varmista, että noudatat tätä vaihetta, ennen kuin siirryt seuraavaan vaiheeseen.

    Valitse gallerian ylin tietue

  6. Valitse Lisää kuvake vasemmasta ruudusta.

    Kuvakeohjausobjektin lisääminen Lisää-työkaluruudun avulla

    Huomautus

    Lisää kuvake lisää kuvakkeen + gallerian vasempaan reunaan, ja se replikoidaan gallerian jokaiselle kohteelle.

  7. Siirrä kuvake yläosassa näytön oikealle puolelle.

    Siirrä kuvake

  8. Valitse kuvakkeen Kuvake-ominaisuus ja aseta se seuraavaan kaavaan, jotta kuvake kuva päivittyy roskakorikuvakkeeksi:

    Icon.Trash
    

    Huomautus

    Icon. etuliite näkyy vain, jos muokkaat kaavaa aktiivisesti.

    Kuvakkeen muuttaminen roskakorikuvakkeeksi

  9. Määritä sen OnSelect-ominaisuudeksi seuraava kaava:

    Remove( [@Contacts], ThisItem )
    

    Huomautus

    Käytä yleistä selvitysoperaattoria [@...] tässä esimerkissä näytetiedoilla, jossa on Contacts-entiteetti välttääksesi ristiriidan yksi-moneen-suhteissa. Jos käytät tietolähteitä, kuten SharePointia, luetteloa tai SQL Server -taulukkoa, yleisen selvitysoperaattorin käyttäminen ei ole pakollista.

    Roskakori-kuvakkeen OnSelect-kaava

  10. Esikatsele sovellusta oikeassa yläkulmassa olevalla Toista-painikkeella tai paina F5-näppäintä.

  11. Valitse tietueen vieressä oleva roskakori kuvake, esimerkiksi kohdassa Maria:

    Galleria, jonka yksi yhteyshenkilö on poistettu

    Tietue poistetaan:

    Poistettu tietue

  12. Sulje sovelluksen esikatselu.