Funkcijos FirstN, Index, Last ir LastN

Taikoma: Drobės programos Darbalaukio srautai Modeliu pagrįstos programos Power Pages Power Platform CLI

Iš lentelės pateikia pirmąjį, paskutinį ar konkretų įrašą arba pirmųjų ar paskutinių įrašų rinkinį.

Aprašą

Funkcija First pateikia pirmąjį lentelės įrašą.

Funkcija FirstN pateikia pirmąjį lentelės įrašų rinkinį; antrasis argumentas nurodo pateiktinų įrašų skaičių.

Funkcija Last pateikia paskutinįjį lentelės įrašą.

Funkcija LastN pateikia paskutinįjį lentelės įrašų rinkinį; antrasis argumentas nurodo pateiktinų įrašų skaičių.

Funkcija Index pateikia lentelės įrašą pagal išdėstymo padėtį lentelėje. Įrašų numeravimas prasideda nuo 1, todėl First( table ) pateikia tokį patį įrašą kaip Index( table, 1 ). Indeksas pateikia klaidą, jei pageidaujamas įrašų indeksas yra mažesnis nei 1, didesnis už įrašų skaičių lentelėje arba lentelė tuščia.

Pirmas, Indeksas ir Paskutinis pateikia vieną įrašą. FirstN ir LastN pateikia lentelę, net jei nurodote tik vieną įrašą.

Perdavimas

Kai šios funkcijos naudojamos su duomenų šaltiniu, jų perduoti negalima. Bus gauta tik pirmoji duomenų šaltinio dalis, o tada bus taikoma funkcija. Rezultatas gali apimti ne visą informaciją. Kuriant gali pasirodyti įspėjimas, priminsiantis šį apribojimą ir pasiūlysiantis, kur įmanoma, pereiti prie perduodamųjų alternatyvų. Norėdami gauti daugiau informacijos, žr. perdavimo apžvalgą.

Pvz., kai naudojama su duomenų šaltiniu, kuriame yra didelė lentelė su 1 milijonu įrašų, Paskutinis bus taikomas neperdavimo riba ir paskutinis viso duomenų šaltinio įrašas nebus pateiktas. Panašiai naudojant Index norint pateikti užklausą dėl įrašo, esančio 1 milijone įrašų, gaunama klaida, nes rodyklė nepatenka į diapazoną, remiantis neperdavimo riba.

Sintaksė

Pirmas( lentelė )
Last( lentelė )

• Lentelė - būtina. Lentelė, kurią norite naudoti.

FirstN( lentelė [, NumberOfRecords ] )
LastN( lentelė [, NumberOfRecords ] )

• Lentelė - būtina. Lentelė, kurią norite naudoti.
• NumberOfRecords - neprivaloma. Pateiktinų įrašų skaičius. Jei šio argumento nenurodote, funkcija pateikia vieną įrašą.

Index(lentelė,RecordIndex )

• Lentelė - būtina. Lentelė, kurią norite naudoti.
• RecordIndex - būtina. Pateiktina įrašo rodyklė. Įrašų numeravimas prasideda nuo 1.

Pavyzdžiai

Toliau pateiktuose pavyzdžiuose naudosime Ledųduomenų šaltinį, kuriame yra šios lentelės duomenys:

Šią lentelę galima įdėti į rinkinį su toliau nurodyta formule (įdėkite į valdiklio „Button“ OnStart formulę ir paspauskite mygtuką):

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

Formulė	Aprašą	Rezultatas
Pirmas( IceCream )	Pateikia pirmąjį IceCream įrašą.	{ Flavor: "Šokoladiniai", Quantity: 100 }
Paskutinis( IceCream )	Pateikia paskutinį IceCream įrašą.	{ Flavor: "Pistachio", Quantity: 200 }
Indeksas( IceCream, 3 )	Pateikia trečiąjį IceCream įrašą.	{ Flavor: "Strawberry", Quantity: 300 }
FirstN( Ledai, 2 )	Pateikia lentelę su pirmaisiais dviem IceCream įrašais.
LastN( Ledai, 2 )	Grąžina lentelę, kurioje yra du paskutiniai "IceCream "įrašai.
Indeksas( IceCream, 4 ). Kiekis	Pateikia ketvirtą lentelės įrašą ir išskleidžia stulpelį Kiekis.	60
Indeksas( IceCream, 10 )	Pateikia klaidą, nes prašomas įrašas yra už lentelės ribų.	Klaida