Funkcijos FirstN, Index, Last ir LastN

  • Straipsnis

Taikoma: Drobės programos Darbalaukio srautai Modeliu pagrįstos programos 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 ). Index pateikia klaidą, jei prašoma įrašų rodyklė yra mažesnė nei 1, didesnė nei įrašų skaičius lentelėje arba jei lentelė tuščia.

First, Index ir Last 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ė

First( Table )
Last( Table )

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

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

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

Index( Table, RecordIndex )

  • Table – 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:

Ledų pavyzdys.

Š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
First( IceCream ) Pateikia pirmąjį IceCream įrašą. { Flavor: "Šokoladiniai", Quantity: 100 }
Last( IceCream ) Pateikia paskutinį IceCream įrašą. { Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 ) Pateikia trečiąjį IceCream įrašą. { Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 ) Pateikia lentelę su pirmaisiais dviem IceCream įrašais. Lentelė, kurioje yra šokolado ir vanilės įrašai
LastN( IceCream, 2 ) Pateikia lentelę su paskutiniais dviem IceCream įrašais. Lentelė, kurioje yra mėtų šokolado ir pistacijų įrašai
Index( IceCream, 4 ).Quantity Pateikia ketvirtąjį lentelės įrašą ir išskleidžia stulpelį Kiekis. 60
Index( IceCream, 10 ) Pateikia klaidą, nes prašomas įrašas yra už lentelės ribų. Klaida