Funcions First, FirstN, Index, Last i LastN

S'aplica a: Aplicacions de llenç Fluxos d'escriptori Aplicacions Power Platform basades en models CLI

Torna el primer registre, l'últim o un d'específic, o un conjunt de registres primers o darrers, d'una taula.

Descripció

La funció First retorna el primer registre d'una taula.

La funció FirstN retorna el primer conjunt de registres d'una taula; el segon argument especifica el nombre de registres que es tornaran.

La funció Last retorna el darrer registre d'una taula.

La funció LastN retorna el darrer conjunt de registres d'una taula; el segon argument especifica el nombre de registres que es tornaran.

La funció Index torna un registre d'una taula segons la seva posició ordenada a la taula. La numeració de registres comença amb 1 de manera que First( table ) torna el mateix registre que Index( table, 1 ). Index torna un error si l'índex de registre sol·licitat és inferior a 1, superior al nombre de registres de la taula o la taula està buida.

First, Index i Last retornen un únic registre. FirstN i LastN retornen una taula, encara que només especifiqueu un únic registre.

Delegació

Quan s'utilitza amb una font de dades, aquestes funcions no es poden delegar. Només es recuperarà la primera part de la font de dades i, a continuació, s'aplicarà la funció. És possible que el resultat no representi la història completa. És possible que aparegui un advertiment en el moment de la creació per recordar-vos aquesta limitació i suggerir-vos que canvieu a alternatives delegables sempre que sigui possible. Per obtenir més informació, vegeu la informació general sobre la delegació.

Per exemple, quan s'utilitza amb una font de dades que contingui una taula gran amb 1 milió de registres, Last estarà subjecta al límit de no delegació i no retornarà l'últim registre de tota la font de dades. De la mateixa manera, utilitzar Index per sol·licitar un registre al mig d'1 milió de registres genera un error perquè l'índex està fora de catàleg basant-se en el límit que no és de delegació.

Sintaxi

First( Taula )
Last( Taula )

• Taula: obligatori. Taula on es treballarà.

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

• Taula: obligatori. Taula on es treballarà.
• NumberOfRecords: opcional. Nombre de registres per retornar. Si no especifiqueu aquest argument, la funció retorna un registre.

Index( Table, RecordIndex )

• Taula: obligatori. Taula on es treballarà.
• RecordIndex: obligatori. Índex del registre que s'ha de tornar. La numeració de registres comença amb 1.

Exemples

Per als exemples següents, farem servir la font de dadesGelat, que conté les dades d'aquesta taula:

Aquesta taula es pot col·locar en una col·lecció amb aquesta fórmula (col·loqueu la fórmula OnStart per al control de botons i premeu el botó):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )

Fórmula	Descripció	Resultat
First( IceCream )	Torna el primer registre d'IceCream.	{ Gust: "Xocolata", Quantitat: 100 }
Last( IceCream )	Torna el darrer registre d'IceCream.	{ Gust: "festuc", Quantitat: 200 }
Index( IceCream, 3 )	Torna el tercer registre d'IceCream.	{Gust: "Maduixa", Quantitat: 300}
FirstN( IceCream, 2 )	Retorna una taula amb els dos primers registres d'IceCream.
LastN( IceCream, 2 )	Retorna una taula amb els dos darrers registres d'IceCream.
Index( IceCream, 4 ).Quantity	Retorna el quart registre de la taula i extreu la columna Quantitat.	60
Index( IceCream, 10 )	Retorna un error, ja que el registre sol·licitat està fora dels límits de la taula.	Error