A Power Apps Remove és RemoveIf függvényei

Rekordok eltávolítása az adatforrásból.

Ismertetés

A Remove függvény

A Remove függvénnyel egy vagy több adott rekordot távolíthat el az adatforrásból.

Gyűjtemények esetében a teljes rekordnak egyeznie kell. Az All argumentum használatával egy adott rekord összes példányát eltávolíthatja, ellenkező esetben csak az egyik példány lesz eltávolítva.

A RemoveIf függvény

A RemoveIf függvénnyel az egy vagy több megadott feltételnek megfelelő rekordokat távolíthatja el. Az egyes feltételeket bármilyen olyan képlet alkothatja, amely eredménye igaz vagy hamis lehet, és név szerint hivatkozhatnak az adatforrás oszlopaira. A feltételeket minden rekord esetében egyenként értékeli ki a rendszer és a rekordot akkor távolítja el, ha az összes feltétel igaz eredményt ad.

A Remove és a RemoveIf függvény tábla formájában adja vissza a módosított adatforrást. Mindkét függvény csak viselkedésszabályozó képletekben használható.

A Clear függvényt is használhatja az összes rekord eltávolítására a gyűjteményből.

Meghatalmazás

Adatforrással való használat esetén ezek a funkciók nem delegálhatók. Csak az adatforrás első részét kéri le, és utána alkalmazza a funkciót. Előfordulhat, hogy az eredmény nem tükrözi a teljes képet. A szerkesztés során megjelenhet egy figyelmeztetés, amely emlékezteti erre a korlátozásra, és javasolja, hogy lehetőség szerint váltson delegálható alternatívára. További információkért lásd: a delegálás áttekintése.

Szintaxis

Remove( DataSource, Record1 [, Record2, ... ] [, Összes ] )

  • DataSource (Adatforrás) – kötelező. Az adatforrás, amelyből a rekordot vagy rekordokat eltávolítani szeretné.
  • Record(s) – kötelező. Az eltávolítandó rekord vagy rekordok.
  • All – Nem kötelező. Ugyanaz a rekord többször is előfordulhat a gyűjteményben. Az Összes argumentummal jelezheti, hogy mindegyik példányt el szeretné távolítani.

Remove( DataSource, Table [, Összes ] )

  • DataSource (Adatforrás) – kötelező. Az adatforrás, amely az eltávolítani kívánt rekordokat tartalmazza.
  • Table – Kötelező megadni. Az eltávolítani kívánt rekordtábla.
  • All – Nem kötelező. Ugyanaz a rekord többször is előfordulhat a gyűjteményben. Az Összes argumentummal jelezheti, hogy mindegyik példányt el szeretné távolítani.

RemoveIf( DataSource, Feltétel [, ... ] )

  • DataSource (Adatforrás) – kötelező. Az adatforrás, amelyből a rekordot vagy rekordokat eltávolítani szeretné.
  • Feltétel(ek) – Kötelező. Egy olyan képlet, amely igaz eredményt ad az eltávolítandó rekordon vagy rekordokon alkalmazva. Az DataSource oszlopnevei is használhatóak a képletben. Ha több Feltételt is megad, mindegyiknek igaz eredményt kell adnia ahhoz, hogy a rekordot vagy rekordokat eltávolítsa a rendszer.

Példák - egyedi képletek

A következő példákban rekordokat fogunk eltávolítani az IceCream nevű adatforrásból, amely kezdetben az alábbi táblában látható adatokat tartalmazza:

Hozzon létre egy gyűjteményt mintabejegyzésekkel

Ha ezekkel az adatokkal szeretne létrehozni egy gyűjteményt:

  1. Szúrjon be egy Gomb vezérlőt.

  2. Állítsa a gombvezérlő OnSelect tulajdonságát az alábbi képletre:

    ClearCollect( IceCream,
                  { ID: 1, Flavor: "Chocolate",  Quantity: 100 },
                  { ID: 2, Flavor: "Vanilla",    Quantity: 200 },
                  { ID: 3, Flavor: "Strawberry", Quantity: 300 }
    )
    
  3. Az Alt billentyűt lenyomva tartva válassza ki a gombot.

Mintabejegyzések eltávolítása a gyűjteményből képlet használatával

Képlet Ismertetés Eredmény
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) )
Eltávolítja a Csokoládé rekordot az adatforrásból.

A módosított IceCream adatforrás.
Remove( IceCream,
First( Filter( IceCream, Flavor="Chocolate" ) ) First( Filter( IceCream, Flavor="Strawberry" ) ) )
Két rekordot távolít el az adatforrásból.

A módosított IceCream adatforrás.
RemoveIf( IceCream, Quantity > 150 ) Eltávolítja azokat a rekordokat, amelyeknél a Mennyiség több mint 150.

A módosított IceCream adatforrás.
RemoveIf( IceCream, Quantity > 150, Left( Flavor, 1 ) = "S" ) Eltávolítja azokat a rekordokat, amelyeknél a Mennyiség több mint 150, és az Íz S betűvel kezdődik.


A módosított IceCream adatforrás.
RemoveIf( IceCream, true ) Eltávolítja az összes rekordot az adatforrásból.

A módosított IceCream adatforrás.

Ebben a példában a Katalógus vezérlője segítségével listázhatja a bejegyzéseket egy táblában. Majd a Remove függvény használatával eltávolít egy elemet.

Felkészülés a mintaadatokhoz

Ebben a példában a Kapcsolattartók entitást használjuk a Microsoft Dataverse-szolgáltatásban ami a mintaalkalmazások és adatok között érhető el. A mintaalkalmazásokat és adatokat telepítheti, amikor létrehoz egy környezetet. Ehelyett más adatforrás is használhat.

Ebben a példában az elemet egy olyan gomb segítségével távolítja el , amely kívül esik a katalóguson.

  1. Hozzon létre egy új üres vászonalapú alkalmazást a Telefon elrendezés használatával.

    Üres vászonalapú alkalmazás a telefon elrendezéssel

  2. Válassza a bal navigációs ablaktáblán az Beszúrás elemet.

  3. Válassza a Függőleges katalógus lehetőséget.
    A Katalógus vezérlőjét a rendszer hozzáadhatja a képernyőhöz.

    A Beszúrás eszköz paneljét használhatja függőleges katalógusvezérlő hozzáadásához

  4. A rendszer kéri, hogy jelöljön ki egy adatforrás, ahol kiválaszthat egy adatforrás a rendelkezésre álló adatforrások közül.
    Például jelölje ki a Kapcsolattartók entitást a mintaadatok használatához :

    A katalógusban megjelenítendő Kapcsolattartók entitás kiválasztása

    A Kategória az entitásból származó elemeket jeleníti meg:

    A Kapcsolattartók entitást mutató hozzáadott katalógus

  5. Szúrjon be e Gomb vezérlőt a bal oldali ablaktáblából:

    A Beszúrás eszköz paneljét használhatja gomb hozzáadásához

  6. Mozgassa a hozzáadott gombot a katalóguselemek alá:

    Áthelyezés gomb

  7. Frissítse a gomb szövegtulajdonsáságát Bejegyzés eltávolítása értékre. Bármilyen más szöveget is használhat:

    Gomb átnevezése

  8. A gomb OnSelect tulajdonságánál adja meg a következő képletet:

    Remove( Contacts, Gallery1.Selected )
    

    A gombvezérlő OnSelect tulajdonságának beállítása

    A katalógus vezérlő a Kijelölt tulajdonság használatával elérhetővé teszi a jelenleg kijelölt rekordot. A Remove függvény a kijelölt bejegyzésre hivatkozik.

  9. Tekintse meg az alkalmazást az alkalmazás előnézetét a jobb felső sarokban található Lejátszás gombbal, vagy nyomja meg az F5 billentyűt a billentyűzeten:

    Alkalmazás előnézete

  10. Jelöljön ki egy eltávolítani kívánt bejegyzést, például Nancy rekordját ebben a példában:

    Jelöljön ki egy bejegyzést

  11. Válassza a Rekord eltávolítása lehetőséget:

    A kapcsolattartók katalógusa, immár a Nancy rekord nélkül, ami el lett távolítva

    A gomb kiválasztásával eltávolítja a kijelölt rekordot (ebben a példában a Nancy rekordját).

  12. Zárja be az alkalmazás előnézetét.

    Tipp

    Alternatív viselkedést is előhívhat az Alt billentyű használatával, ahelyett, hogy az alkalmazás előnézetét a Lejátszás gombbal vagy az F5 billentyűvel jeleníti meg.

Ebben a példában az elemet egy olyan ikon segítségével távolítja el , amely a katalóguson belül található.

Hozzon létre egy gyűjteményt mintaadatokkal

Ha már vannak előkészített mintaadatai, akkor hagyja ki ezt a lépést, és folyatta a Kuka ikon a katalóguson belül résszel.

  1. Adjon egy Gomb vezérlőt a képernyőhöz.

  2. Az OnSelect tulajdonság értékeként adja meg a következő képletet:

    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. Az Alt billentyűt lenyomva tartva válassza ki a gombot.

A következő példában használható mintagyűjtemény jön létre.

  1. Hozzon létre egy új üres vászonalapú alkalmazást a Telefon elrendezés használatával.

    Üres vászonalapú alkalmazás a telefon elrendezéssel

  2. Válassza a bal navigációs ablaktáblán az Beszúrás elemet.

  3. Válassza a Függőleges katalógus lehetőséget.
    A Katalógus vezérlőjét a rendszer hozzáadhatja a képernyőhöz.

    A Beszúrás eszköz paneljét használhatja függőleges katalógusvezérlő hozzáadásához

  4. A rendszer kéri, hogy jelöljön ki egy adatforrás, ahol kiválaszthat egy adatforrás a rendelkezésre álló adatforrások közül.
    Például jelölje ki a Kapcsolattartók entitást a mintaadatok használatához :

    A katalógusban megjelenítendő Kapcsolattartók entitás kiválasztása

    Ha létrehozott egy gyűjteményt, akkor válassza ki a gyűjteményt ehelyett:

    Minta kapcsolattartók gyűjtemény

  5. Jelöljön ki egy vezérlőelemet a katalógus felső részén belül.

    Annak érdekében, hogy a következő lépés beillesztse az elemet a Katalógus sablonjába, és ne a katalóguson kívülre, mindenképpen végezze el ezt a lépést, mielőtt a következő lépésre lépne.

    Felső bejegyzés kijelölése egy galériában

  6. Válassza az Ikon hozzáadása lehetőséget a bal ablaktáblából.

    A Beszúrás eszköz paneljét használhatja egy ikonvezérlő hozzáadásához

    Megjegyzés

    Az Ikon hozzádása egy + ikont szúr be a Katalógus bal oldalán, amely a galériában szereplő minden elemre replikálódik.

  7. A felső elemben mozgassa az ikont a képernyő jobb oldalára.

    Ikon áthelyezése

  8. Jelölje ki az ikon Ikon tulajdonságát , és állítsa be a következő képletre ,hogy az ikon képét a kuka ikonjára frissítse:

    Icon.Trash
    

    Megjegyzés

    Az Ikon. előtag csak akkor jelenik meg, ha éppen aktívan szerkeszti a képletet.

    Az ikon megváltoztatása a kuka ikonra

  9. Az OnSelect tulajdonság értékeként adja meg a következő képletet:

    Remove( [@Contacts], ThisItem )
    

    Megjegyzés

    Ebben a példában a globális egyértelműsítő operátort kell használnia [@...] olyan mintaadatokkal, amelyek a Kapcsolattartók entitást használja, hogy ne legyen ütközés egy Egy-a-sokhoz kapcsolattal. Ha olyan adatforrásokat használ, mint egy SharePoint-lista vagy SQL Server-tábla, nem szükéges globális egyértelműsítő operátort használnia.

    A Kuka OnSelect eleme

  10. Tekintse meg az alkalmazást az alkalmazás előnézetét a jobb felső sarokban található Lejátszás gombbal, vagy nyomja meg az F5 billentyűt a billentyűzeten.

  11. Jelölje ki a bejegyzés melletti Kuka ikont például a Maria rekordhoz tartozót:

    Katalógus egy eltávolított kapcsolattartóval

    A rekord törölve lett:

    Törölt rekord

  12. Zárja be az alkalmazás előnézetét.

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).