Esmakordne, funktsioon FirstN, Index, Last ja LastN

  • Artikkel

Kehtib: Lõuendirakendused Töölauavood Mudelipõhised rakendused Power Platform CLI

Tagastab tabelist esimese, viimase või konkreetse kirje või esimeste või viimaste kirjete kogumi.

Kirjeldus

First funktsioon tagastab tabeli esimese kirje.

Fuktsioon FirstN tagastab tabeli esimese kirjete kogumi; teine argument määrab tagastatavate kirjete arvu.

Funktsioon Last tabeli viimase kirje.

Funktsioon LastN tagastab tabeli viimase kirjete kogumi; teine argument määrab tagastatavate kirjete arvu.

Funktsioon Register tagastab tabeli kirje, mis põhineb selle tellitud positsioonil tabelis. Kirjete nummerdamine algab numbriga 1, seega tagastab First( table ) sama kirje mis Index( table, 1 ). Register tagastab tõrke, kui taotletud kirje register on väiksem kui 1, suurem kui tabeli kirjete arv või kui tabel on tühi.

Funktsioonid Esimene, Register ja Viimane tagastavad ühe kirje. Funktsioonid FirstN ja LastN tagastavad tabeli, isegi kui määrate ainult ühe kirje.

Delegeerimine

Koos andmeallikaga kasutamisel ei saa neid funktsioone delegeerida. Tuuakse ainult andmeallika esimene osa ja seejärel rakendatakse funktsioon. Tulem ei pruugi esindada täielikku lugu. Koostamise ajal võidakse kuvada hoiatus, mis tuletab teile seda piirangut meelde ja soovitab võimalusel lülituda delegeeritavatele alternatiividele. Lisateabe saamiseks vt delegeerimise ülevaadet.

Kui seda kasutatakse näiteks andmeallikaga, mis sisaldab suurt tabelit ühe miljoni kirjega, kehtib funktsioonile Viimane mitte-delegatsiooni limiit ja see ei tagasta kogu andmeallika viimast kirjet. Samuti võib funktsiooni Register kasutamine ühe miljoni kirje seas oleva kirje taotlemiseks kaasa tuua tõrke, kuna register on mitte-delegatsiooni limiidi järgi vahemikust väljas.

Süntaks

First( Table )
Last( Table )

  • Tabel – nõutav. Tabel, kus töötada.

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

  • Tabel – nõutav. Tabel, kus töötada.
  • NumberOfRecords – valikuline. Tagastatavate kirjete arv. Kui te seda argumenti ei määra, tagastab funktsioon ühe kirje.

Register( Tabel, RecordIndex )

  • Tabel – nõutav. Tabel, kus töötada.
  • RecordIndex – nõutav. Tagastatava kirje register. Kirjete nummerdamine algab numbriga 1.

Näited

Järgmiste näidete puhul kasutame väärtuse Jäätisandmeallikat, mis sisaldab andmeid selles tabelis.

IceCream näide.

Selle tabeli saab paigutada kogumisse selle valemiga (lisage nupu juhtelemendi jaoks rakenduse OnStart valem ja vajutage nuppu):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )
Valem Kirjeldus Tulemus
Esimene( IceCream ) Tagastab kogumi IceCream esimese kirje. { Flavor: "Chocolate", Quantity: 100 }
Viimane( IceCream ) Tagastab kogumi IceCream viimase kirje. { Flavor: "Pistachio", Quantity: 200 }
Register( IceCream, 3 ) Tagastab kogumi IceCream kolmanda kirje. { Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 ) Tagastab tabeli kogumi IceCream kahe esimese kirjega. Tabel, mis sisaldab šokolaadi ja vanilli kirjeid
LastN( IceCream, 2 ) Tagastab tabeli kogumi IceCream kahe viimase kirjega. Müntide šokolaadi ja pistaatsiapähklite kirjeid sisaldav tabel
Register( IceCream, 4 ).Quantity Tagastab tabeli neljanda kirje ja ekstraktib koguse veeru. 60
Register( IceCream, 10 ) Tagastab tõrke, kuna taotletud kirje on väljaspool tabeli piire. Tõrge