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

  • Artikkeli

Koskee seuraavia: Pohjaan perustuvat sovellukset Työpöytätyönkulut Mallipohjaiset sovellukset 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 ). Index palauttaa virheen, jos pyydetty tietueindeksi on pienempi kuin 1, suurempi kuin taulukon tietueiden määrä tai jos taulukko on tyhjä.

First, Index ja Last palauttavat yksittäisen tietueen. FirstN ja LastN palauttavat taulukon, vaikka määrittäisit 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

First( Table )
Last( Table )

  • Table – Pakollinen. Käsiteltävä taulukko.

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

  • Table – Pakollinen. Käsiteltävä taulukko.
  • NumberOfRecords – Valinnainen. Palautettavien tietueiden määrä. Jos et määritä tätä argumenttia, funktio palauttaa yhden tietueen.

Index( Table, RecordIndex )

  • Table – 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
First( IceCream ) Palauttaa IceCream-tietolähteen ensimmäisen tietueen. { Flavor: "Chocolate", Quantity: 100 }
Last( IceCream ) Palauttaa IceCream-tietolähteen viimeisen tietueen. { Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 ) Palauttaa IceCream-tietolähteen kolmannen tietueen. { Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 ) Palauttaa taulukon, joka sisältää IceCream-tietolähteen kaksi ensimmäistä tietuetta. Suklaan ja vaniljan tietueet sisältävä taulukko
LastN( IceCream, 2 ) Palauttaa taulukon, joka sisältää IceCream-tietolähteen kaksi viimeistä tietuetta. Minttusuklaan ja pistaasin tietueet sisältävä taulukko
Index( IceCream, 4 ).Quantity Palauttaa taulukon neljännen tietueen ja poimii Quantity-sarakkeen. 60
Index( IceCream, 10 ) Palauttaa virheen, koska pyydetty tietue ylittää taulukon rajat. Virhe