Funciones First, FirstN, Index Last y LastN

Se aplica a: Aplicaciones de lienzo Flujos de escritorio Aplicaciones basadas en modelos Power Platform CLI

Devuelve el primero, último o un específico registro, o un conjunto de primeros o últimos registros, de una tabla.

Descripción

La función First devuelve el primer registro de una tabla.

La función FirstN devuelve el primer conjunto de registros de una tabla; el segundo argumento especifica el número de registros que se van a devolver.

La función Last devuelve el último registro de una tabla.

La función LastN devuelve el último conjunto de registros de una tabla; el segundo argumento especifica el número de registros que se van a devolver.

La función Index función devuelve un registro de una tabla en función de su posición ordenada en la tabla. La numeración de registros comienza con 1, por lo que First( table ) devolverá el mismo registro que Index( table, 1 ). Indez devuelve un error si el índice de registro solicitado es inferior a 1, superior al número de registros de la tabla o si la tabla está vacía.

First, Index y Last devuelven un único registro. FirstN y LastN devuelven una tabla, incluso si se especifica solo un único registro.

Delegación

Cuando se usan con un origen de datos, estas funciones no se pueden delegar. Solo se recuperará la primera parte del origen de datos, y después se aplicará la función. Es posible que el resultado no represente la historia completa. Puede que aparezca una advertencia en el momento de la creación para recordarle esta limitación y sugerirle un cambio a alternativas delegables siempre que sea posible. Para obtener más información, consulte la información general sobre delegación

Por ejemplo, cuando se usa con un origen de datos que contiene una tabla grande con 1 millón de registros, Last estará sujeto al límite de no delegación y no devolverá el último registro de todo el origen de datos. Así mismo, usando Index solicitar un registro en medio de 1 millón de registros generará un error porque el índice está fuera del rango según el límite de no delegación.

Sintaxis

First( Table )
Last( Table )

• Table - obligatorio. La tabla sobre la cual se opera.

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

• Table - obligatorio. La tabla sobre la cual se opera.
• NumberOfRecords: opcional. Número de registros que se va a devolver. Si no especifica este argumento, la función devolverá un registro.

Index( Table, RecordIndex )

• Table - obligatorio. La tabla sobre la cual se opera.
• RecordIndex: obligatorio. El índice del registro que se devolverá. La numeración de registros comienza con 1.

Ejemplos

En los ejemplos siguientes, usaremos el origen de datosIceCream, que contiene los datos de esta tabla:

Esta tabla se puede colocar en una colección con esta fórmula (coloque la fórmula OnStart para un control Button y presione el botón):

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ón	Resultado
First( IceCream )	Devuelve el primer registro de IceCream.	{ Flavor: "Chocolate", Quantity: 100 }
Last( IceCream )	Devuelve el último registro de IceCream.	{ Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 )	Devuelve el tercer registro de IceCream.	{ Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 )	Devuelve una tabla que contiene los dos primeros registros de IceCream.
LastN( IceCream, 2 )	Devuelve una tabla que contiene los dos últimos registros de IceCream.
Index( IceCream, 4 ).Quantity	Devuelve el cuarto registro de la tabla y extrae la columna Cantidad.	60
Index( IceCream, 10 )	Devuelve un error ya que el registro solicitado está fuera de los límites de la tabla.	Error