Eltávolítás és RemoveIf funkciók

A következőkre vonatkozik: Vászonalapú alkalmazások Modellvezérelt alkalmazások Power Platform CLI

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

Feljegyzés

A PAC CLI PAC POWER-FX parancsok nem támogatják a RemoveIf függvényt.

Description

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. A RemoveFlags.All argumentummal eltávolíthatja a rekord összes másolatát, ellenkező esetben a rekordnak csak egy példánya törlődik.

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ás használata esetén ezek a függvények nem delegálhatók. Csak az adatforrás első részét kéri le, és utána alkalmazza a funkciót. Lehet, hogy ez nem tükrözi a teljes történetet. A létrehozáskor figyelmeztetés jelenhet meg, amely emlékezteti erre a korlátozásra.

Delegálás támogatása (kísérleti)

A RemoveIf delegálási támogatása mostantól kísérleti előzetes verzióban (alapértelmezett OFF) érhető el az azt támogató adatforrások esetében. Ha egy adatforrás nem támogatja ezt a funkciót, lekérdezést küld a kiszolgálónak, és lekéri az összes olyan adatot, amely megfelel a szűrőkifejezésnek legfeljebb 500, Power Apps 2000 vagy az adatoldal méretéig. Ezután törlési műveletet hajt végre minden egyes rekordon a kiszolgálóra irányuló egyedi hívásokkal.

Szintaxis

Eltávolítás(DataSource,Record1 [,Record2; ... ] [,RemoveFlags.All ] )

• 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.
• RemoveFlags.All – Nem kötelező. Ugyanaz a rekord többször is előfordulhat a gyűjteményben. A RemoveFlags.All argumentum hozzáadásával eltávolíthatja a rekord összes másolatát.

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

• DataSource (Adatforrás) – kötelező. Az adatforrás, amely az eltávolítani kívánt rekordokat tartalmazza.
• Tábla – Kötelező megadni. Az eltávolítani kívánt rekordtábla.
• RemoveFlags.All – Nem kötelező. Ugyanaz a rekord többször is előfordulhat a gyűjteményben. A RemoveFlags.All argumentum hozzáadásával eltávolíthatja a rekord összes másolatát.

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	Description	Result
Remove( Jégkrém, LookUp( IceCream, Flavor="Chocolate" ))	Eltávolítja a Csokoládé rekordot az adatforrásból.	A módosított IceCream adatforrás.
Remove( Jégkrém, LookUp( IceCream, Flavor="Chocolate" ), LookUp( IceCream, Flavor="Strawberry" ) )	Két rekordot távolít el az adatforrásból.	A módosított IceCream adatforrás.
RemoveIf( Jégkrém, 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( Jégkrém, Quantity > 150, Left( Flavor, 1 ) = "S" )	Eltávolítja azokat a rekordokat, amelyeknél a Mennyiség több mint 150, és az ÍzS betűvel kezdődik.	A módosított IceCream adatforrás.
RemoveIf( Jégkrém, true )	Eltávolítja az összes rekordot az adatforrásból.	A módosított IceCream adatforrás.

Példák – eltávolítás gomb a galérián kívül

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

Ez a példa a Microsoft Dataverse alkalmazásban a mintaalkalmazásokkal és -adatokkal együtt rendelkezésre álló Kapcsolatok táblázatot használja. A mintaalkalmazásokat és adatokat telepítheti, amikor létrehoz egy környezetet. Ehelyett más adatforrás is használhat.

Eltávolítás gomb a galérián kívül

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.

   

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.

   

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 válassza ki a Kapcsolatok táblázatot a mintaadatok használatához:

   

   A galéria az ebből a táblázatból származó elemeket jeleníti meg:

   

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

   

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

   

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:

   

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

   Remove( Contacts, Gallery1.Selected )
   

   

   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 eltávolítandó 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:

   

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:

    

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

    

    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.

Példák – a Kuka ikon a katalóguson belül

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.

A Kuka ikon a katalóguson belül

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

   

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.

   

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 válassza ki a Kapcsolatok táblázatot a mintaadatok használatához:

   

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

   

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.

   

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

   

   Feljegyzé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.

   

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
   

   Feljegyzés

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

   

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

   Remove( [@Contacts], ThisItem )
   

   Feljegyzés

   Ebben a példában a globális egyértelműsítő operátort [@...] kell használnia olyan mintaadatokkal, amelyek a Kapcsolatok táblázatot használják az Egy-a-többhöz kapcsolattal való összeütközés elkerülése érdekében. Ha olyan adatforrásokat használ, mint lista vagy SQL Server-tábla, nem szükéges globális egyértelműsítő operátort használnia.

   

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:

    

    A rekord törölve lett:

    

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