Jaa

First-, FirstN-, Index-, Last- ja LastN-funktiot

  • Artikkeli

Koskee seuraavia: pohjaan perustuvat sovellukset työpöytätyönkulut Mallipohjaisten sovellusten Power Pages Power Platform CLI

Palauttaa taulukosta ensimmäisen, viimeisen tai tietyn tietueen tai ensimmäisten tai viimeisten tietueiden joukon.

Kuvaus

First-funktio palauttaa taulukon ensimmäisen tietueen.

FirstN-funktio palauttaa taulukon ensimmäiset tietueet. Toinen argumentti määrittää palautettavien tietueiden määrän.

Last-funktio palauttaa taulukon viimeisen tietueen.

LastN-funktio palauttaa taulukon viimeiset tietueet. Toinen argumentti määrittää palautettavien tietueiden määrän.

Index-funktio palauttaa taulukon tietueen sen taulukon mukaisen järjestyssijainnin perusteella. Tietueiden numerointi alkaa numerosta 1, joten First( table ) palauttaa saman tietueen kuin Index( table, 1 ). Indeksi palauttaa virheen, jos pyydetyn tietueindeksin arvo on pienempi kuin 1, suurempi kuin taulukon tietueiden määrä tai taulukko on tyhjä.

Ensimmäinen, Indeksoi ja Viimeinen palauttavat yhden tietueen. FirstN ja LastN palauttavat taulukon, vaikka määrität vain yhden tietueen.

Delegointi

Näitä toimintoja ei voi delegoida tietolähdettä käytettäessä. Vain tietolähteen ensimmäinen osa noudetaan ja sitten suoritetaan toiminto. Tulos ei ehkä vastaa kokonaisuutta. Laatimisvaiheessa saatetaan näyttää varoitus, joka muistuttaa tästä rajoituksesta ja kehottaa vaihtamaan delegoitaviin vaihtoehtoihin, jos mahdollista. Lisätietoja on delegoinnin yleiskatsauksessa.

Jos Last-funktiota esimerkiksi käytetään 1 miljoonaa tietuetta sisältävän suuren taulukon sisältävän tietolähteen yhteydessä, funktioon sovelletaan delegoimattomuusrajaa, eikä se palauta koko tietolähteen viimeistä tietuetta. Myös Index-funktion käyttäminen sellaisen tietueen pyytämiseen, joka sijaitsee 1 miljoonan tietueen keskellä, palauttaa virheen, koska indeksi on delegoimattomuusrajan perusteella alueen ulkopuolella.

Syntaksi

Ensimmäinen( taulukko )
Last( taulukko )

  • Taulukko - Pakollinen. Käsiteltävä taulukko.

FirstN( Table [, NumberOfRecords ] )
LastN( Taulukko [, Tietueiden lukumäärä] )

  • Taulukko - Pakollinen. Käsiteltävä taulukko.
  • NumberOfRecords - valinnainen. Palautettavien tietueiden määrä. Jos et määritä tätä argumenttia, funktio palauttaa yhden tietueen.

Indeksi(taulukko,tietueindeksi )

  • Taulukko - Pakollinen. Käsiteltävä taulukko.
  • RecordIndex - Pakollinen. Palautettavan tietueen indeksi. Tietueiden numerointi alkaa numerosta 1.

Esimerkkejä

Seuraavissa esimerkeissä käytämme IceCream-tietolähdettä, joka sisältää tämän taulukon tiedot:

IceCream-esimerkki.

Tämä taulukko voidaan sijoittaa kokoelmaan tällä kaavalla (lisää se painikkeen OnStart-kaavaan ja paina painiketta):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )
Kaava Kuvaus Tulos
Ensimmäinen( Jäätelö ) Palauttaa IceCream-tietolähteen ensimmäisen tietueen. { Flavor: "Chocolate", Quantity: 100 }
Viimeinen( Jäätelö ) Palauttaa IceCream-tietolähteen viimeisen tietueen. { Flavor: "Pistachio", Quantity: 200 }
Indeksi( Jäätelö, 3 ) Palauttaa IceCream-tietolähteen kolmannen tietueen. { Flavor: "Strawberry", Quantity: 300 }
FirstN( Jäätelö, 2 ) Palauttaa taulukon, joka sisältää IceCream-tietolähteen kaksi ensimmäistä tietuetta. Suklaan ja vaniljan tietueet sisältävä taulukko
LastN( Jäätelö, 2 ) Palauttaa taulukon, joka sisältää IceCream-tietolähteen kaksi viimeistä tietuetta. Minttusuklaan ja pistaasin tietueet sisältävä taulukko
Indeksi( Jäätelö, 4 ). Määrä Palauttaa taulukon neljännen tietueen ja poimii Quantity-sarakkeen. 60
Indeksi( Jäätelö, 10 ) Palauttaa virheen, koska pyydetty tietue ylittää taulukon rajat. Virhe