Funkcijas FirstN, Index, Last un LastN

Attiecas uz: Audekla programmām Darbvirsmas plūsmas Modeļa vadītas programmas Power Pages Power Platform CLI

No tabulas atgriež pirmo, pēdējo vai konkrētu ierakstu vai pirmo un pēdējo ierakstu kopu.

Apraksts

Funkcija First atgriež tabulas pirmo ierakstu.

Funkcija FirstN atgriež pirmo tabulas ierakstu kopu; otrajā argumentā ir norādīts atgriežamo ierakstu skaits.

Funkcija Last atgriež tabulas pēdējo ierakstu.

Funkcija LastN atgriež pēdējo tabulas ierakstu kopu; otrajā argumentā ir norādīts atgriežamo ierakstu skaits.

Funkcija Index atgriež tabulas ierakstu, pamatojoties uz tās sakārtoto pozīciju tabulā. Ierakstu numerācija sākas ar 1, tādējādi First( table ) atgriež tādu pašu ierakstu kā Index( table, 1 ). Indekss atgriež kļūdu, ja pieprasītais ierakstu indekss ir mazāks par 1, lielāks par ierakstu skaitu tabulā vai ja tabula ir tukša.

Pirmais,Indekss un Pēdējais atgriež vienu ierakstu. Funkcija FirstN un LastN atgriež tabulu, pat ja norādāt tikai vienu ierakstu.

Deleģēšana

Ja tiek izmantots arī datu avots, šīs funkcijas nevar deleģēt. Tiks izgūta tikai pirmā datu avota daļa, un pēc tam tiks izmantota funkcija. Rezultātā var nebūt iekļauts viss saturs. Lai atgādinātu par šo ierobežojumu un ieteiktu pārslēgties uz deleģējamu alternatīvu (ja tas ir iespējams), autorēšanas laikā var tikt parādīts brīdinājums. Papildinformāciju skatiet sadaļā Pārskats par deleģēšanu.

Piemēram, ja izmantojat kopā ar datu avots tabulu ar 1 miljonus ierakstu, uz Pēdējais attiecas pilnvarojuma neesamības ierobežojums, un tas neatgriezīs visa datu avota pēdējo ierakstu. Tāpat, izmantojot Rādītājs lai pieprasītu ierakstu 1 miljonus ierakstu vidū, radīsies kļūda, jo rādītājs ir ārpus diapazona, pamatojoties uz ierobežojumu, kas nav pilnvaras ierobežojums.

Sintakse

Pirmais( tabula )
Last( tabula )

• Tabula - Obligāts. Tabula, ar kuru strādāt.

FirstN( tabula [, NumberOfRecords ] )
LastN( Tabula [, NumberOfRecords ] )

• Tabula - Obligāts. Tabula, ar kuru strādāt.
• NumberOfRecords - pēc izvēles. Atgriežamo ierakstu skaits. Ja šis arguments netiek konkretizēts, funkcija atgriež vienu ierakstu.

Index(Tabula,RecordIndex )

• Tabula - Obligāts. Tabula, ar kuru strādāt.
• RecordIndex - obligāts. Atgriežamā ieraksta rādītājs. Ierakstu numerācija sākas ar 1.

Piemēri

Šiem piemēriem izmantosim IceCream datu avotu, kas satur datus šajā tabulā:

Šo tabulu var ievietot kolekcijā ar šo formulas vērtību (ievietojiet pogas vadīklas OnStart formulā un nospiediet pogu):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )

Formula	Apraksts	Rezultāts
Pirmais( IceCream )	Atgriež pirmo IceCream ierakstu.	{ Garša "Šokolādes", Daudzums: 100 }
Pēdējais( Saldējums )	Atgriež pēdējo IceCream ierakstu.	{ Garša "Pistāciju", Daudzums: 200 }
Indekss( Saldējums, 3 )	Atgriež trešo IceCream ierakstu.	{ Garša: "Zemeņu", Daudzums: 300 }
FirstN( Saldējums, 2 )	Atgriež tabulu, kas satur pirmos divus IceCream ierakstus.
LastN( Saldējums, 2 )	Atgriež tabulu, kurā ir pēdējie divi IceCream ieraksti.
Indekss( IceCream, 4 ). Daudzums	Atgriež tabulas ceturto ierakstu un izvelk kolonnu Daudzums.	60
Indekss( Saldējums, 10 )	Atgriež kļūdu, jo pieprasītais ieraksts pārsniedz tabulas robežas.	Kļūda