First, FirstN, Index, Last és LastN függvény

  • Cikk

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:

IceCream példa.

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. A csokoládéra és vaníliára vonatkozó rekordokat tartalmazó táblázat
LastN( Jégkrém, 2) A Jégkrém utolsó két rekordját tartalmazó táblát ad vissza. A mentacsokoládéra és a pisztáciára vonatkozó rekordokat tartalmazó táblázat
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