First-, FirstN-, Index-, Last- ja LastN-funktiot
Koskee seuraavia: Pohjaan perustuvat sovellukset Työpöytätyönkulut Mallipohjaiset sovellukset 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 )
.
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:
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. | |
LastN( IceCream, 2 ) | Palauttaa taulukon, joka sisältää IceCream-tietolähteen kaksi viimeistä tietuetta. | |
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 |
Palaute
https://aka.ms/ContentUserFeedback.
Tulossa pian: Vuoden 2024 aikana poistamme asteittain GitHub Issuesin käytöstä sisällön palautemekanismina ja korvaamme sen uudella palautejärjestelmällä. Lisätietoja on täällä:Lähetä ja näytä palaute kohteelle