First, FirstN, Index, Last és LastN függvény
A következőkre vonatkozik: Vászonalapú alkalmazások Asztali folyamatok Modellvezérelt alkalmazások Power Platform CLI
Egy táblából adja vissza az első, az utolsó vagy bármely meghatározott rekordot, illetve az első vagy utolsó rekordok egy halmazát.
Description
A First függvény a tábla első rekordját adja vissza.
A FirstN függvény a tábla első rekordkészletét adja vissza. A második argumentum határozza meg a visszaadandó rekordok számát.
A Last függvény a tábla utolsó rekordját adja vissza.
A LastN függvény egy tábla utolsó rekordkészletét adja vissza. A második argumentum határozza meg a visszaadandó rekordok számát.
Az Index függvény egy tábla rekordját adja eredményül, a táblában elfoglalt pozíciója alapján. A rekordok számozása 1-nél kezdődik, így a First( table )
függvény ugyanazt a rekordot adja vissza, mint az Index( table, 1 )
függvény.
Az Index függvény hibát ad eredményül, ha a kért rekord indexe 1-nél kisebb, vagy ha nagyobb, mint a táblában lévő rekordok száma, vagy ha a tábla üres.
A First, az Index és a Last függvény egyetlen rekordot ad vissza. A FirstN és a LastN egy táblát ad vissza akkor is, ha csak egyetlen rekordot ad meg.
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.
Ha például olyan adatforrással használják, amely 1 millió rekordot tartalmazó táblát tartalmaz, akkor a Last függvényre érvényesül a nem meghatalmazási korlát, és nem adja vissza a teljes adatforrás utolsó rekordját. Hasonlóképpen, ha az Index függvénnyel 1 millió rekordból szeretnénk lekérni egy adott rekordot, az hibát eredményez, mert az index a tartományon kívül esik a nem meghatalmazási korlátnak megfelelően.
Szintaxis
First( Tábla )
Last( Tábla )
- Tábla – Kötelező megadni. A művelethez használni kívánt tábla.
FirstN( Tábla [, Rekordok száma ] )
LastN( Tábla [, Rekordok száma ] )
- Tábla – Kötelező megadni. A művelethez használni kívánt tábla.
- NumberOfRecords – Nem kötelező. A visszaadandó rekordok száma. Ha nem adja meg ezt az argumentumot, a függvény egy rekordot ad vissza.
Index( Table, RecordIndex )
- Tábla – Kötelező megadni. A művelethez használni kívánt tábla.
- RecordIndex – Kötelező. A visszaadandó rekord indexe. A rekordok számozása 1-től kezdődik.
Példák
A következő példában a Jégkrémadatforrást használjuk, amely ebben a táblában szerepelteti az adatokat:
Ez a tábla a képlettel együtt egy gyűjteményben elhelyezhető (helyezze el az OnStart képletet egy Gombon, és nyomja le a gombot):
Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
{ Flavor: "Vanilla", Quantity: 200 },
{ Flavor: "Strawberry", Quantity: 300 },
{ Flavor: "Mint Chocolate", Quantity: 60 },
{ Flavor: "Pistachio", Quantity: 200 } ) )
Képlet | Description | Result |
---|---|---|
First( Jégkrém ) | A Jégkrém első rekordját adja vissza. | { Íz: "Csokoládé", Mennyiség: 100 } |
Last( Jégkrém ) | A Jégkrém utolsó rekordját adja vissza. | { Íz: "Pisztácia", Mennyiség: 200 } |
Index( Jégkrém, 3 ) | A Jégkrém harmadik rekordját adja vissza. | { Flavor: "Strawberry", Quantity: 300 } |
FirstN( Jégkrém, 2 ) | A Jégkrém első két rekordját tartalmazó táblát ad vissza. | |
LastN( Jégkrém, 2) | A Jégkrém utolsó két rekordját tartalmazó táblát ad vissza. | |
Index( Jégkrém, 4 ).Quantity | Visszaadja a tábla negyedik rekordját, és kivonja a Mennyiség oszlopot. | 60 |
Index( Jégkrém, 10 ) | Hibát ad eredményül, mivel a kért rekord túllépi a tábla korlátját. | Hiba |