Funkcijas FirstN, Index, Last un LastN

  • Raksts

Attiecas uz: Audekla programmām Darbvirsmas plūsmas Modeļa vadītas programmas 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 ). Rādītājs atgriež kļūdu, ja pieprasītais ierakstu indekss ir mazāks par 1, lielāks nekā tabulā ierakstu skaits vai tabula ir tukša.

Pirmais, Rādītājs un Pēdējais atgriež vienu ierakstu. FirstN un LastN atgriež tabulu, pat ja tiek norādīts tikai viens ieraksts.

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

First( Tabula )
Last( Tabula )

  • Tabula — Obligāti. Tabula, ar kuru strādāt.

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

  • Tabula — Obligāti. Tabula, ar kuru strādāt.
  • NumberOfRecords — Neobligāti. Atgriežamo ierakstu skaits. Ja šis arguments netiek konkretizēts, funkcija atgriež vienu ierakstu.

Rādītājs( Table, RecordIndex )

  • Tabula — Obligāti. Tabula, ar kuru strādāt.
  • Ieraksts(i) — Obligāti. Atgriežamā ieraksta rādītājs. Ierakstu numerācija sākas ar 1.

Piemēri

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

Piemērs ar saldējumu.

Š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( IceCream ) Atgriež pirmo IceCream ierakstu. { Garša "Šokolādes", Daudzums: 100 }
Last( IceCream ) Atgriež pēdējo IceCream ierakstu. { Garša "Pistāciju", Daudzums: 200 }
Index( IceCream, 3 ) Atgriež trešo IceCream ierakstu. { Garša: "Zemeņu", Daudzums: 300 }
FirstN( IceCream, 2 ) Atgriež tabulu, kas satur pirmos divus IceCream ierakstus. Tabula ar šokolādes un vaniļas ierakstiem
LastN( IceCream, 2 ) Atgriež tabulu, kas satur pēdējos divus IceCream ierakstus. Tabula ar piparmētru šokolādes un pistāciju ierakstiem
Index( IceCream, 4 ).Quantity Atgriež tabulas ceturto ierakstu un izvelk Daudzuma kolonnu. 60
Index( IceCream, 10 ) Atgriež kļūdu, jo pieprasītais ieraksts pārsniedz tabulas robežas. Kļūda