First, FirstN, , IndexLast, un LastN funkcijas

Attiecas uz: Audekla programmas Copilot Studio Desktop plūsmas Modeļa vadītas programmas Power Platform CLI Dataverse funkcijas Power Pages

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ž tabulas pirmo ierakstu kopu; otrais arguments norāda atgriežamo ierakstu skaitu.

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

Funkcija LastN atgriež tabulas pēdējo ierakstu kopu; otrais arguments norāda atgriežamo ierakstu skaitu.

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 ). Index Atgriež kļūdu, ja pieprasītais ieraksta indekss ir mazāks par 1, lielāks par ierakstu skaitu tabulā vai tabula ir tukša.

First, Indexun Last atgriež vienu ierakstu. FirstN un LastN atgriež tabulu pat tad, 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 to lieto kopā ar datu avotu, kurā ir liela tabula ar 1 miljonu ierakstu, Last uz to attiecas deleģēšanas ierobežojums un netiek atgriezts visa datu avota pēdējais ieraksts. Tāpat, pieprasot Index ierakstu 1 miljona ierakstu vidū, rodas kļūda, jo indekss ir ārpus diapazona, pamatojoties uz deleģēšanas ierobežojumu.

Sintakse

First( 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

Tālāk norādītajos piemēros tiek izmantots IceCreamdatu avots, kas satur šajā tabulā norādītos datus.

Š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
First( Saldējums )	Atgriež pirmo IceCream ierakstu.	{ Garša "Šokolādes", Daudzums: 100 }
Last( Saldējums )	Atgriež pēdējo IceCream ierakstu.	{ Garša "Pistāciju", Daudzums: 200 }
Index( 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.
Index( Saldējums, 4 ). Daudzums	Atgriež tabulas ceturto ierakstu un izvelk kolonnu Daudzums.	60
Index( Saldējums, 10 )	Atgriež kļūdu, jo pieprasītais ieraksts pārsniedz tabulas robežas.	Kļūda