First, FirstN, Index, Last, e LastN funções

Aplica-se a: Aplicativos de tela Copilot Studio Fluxos de ambiente de trabalho Aplicações orientadas por modelos Funções do Power Platform CLI Dataverse Power Pages

Devolve o primeiro, o último ou um registo específico ou um conjunto de primeiros ou últimos registos a partir de uma tabela.

Descrição

A First função retorna o primeiro registro de uma tabela.

A FirstN função retorna o primeiro conjunto de registros de uma tabela, o segundo argumento especifica o número de registros a serem retornados.

A Last função retorna o último registro de uma tabela.

A LastN função retorna o último conjunto de registros de uma tabela, o segundo argumento especifica o número de registros a serem retornados.

A Index função retorna um registro de uma tabela com base em sua posição ordenada na tabela. A numeração dos registos começa em 1, pelo que First( table ) devolve o mesmo registo que Index( table, 1 ). Index Retorna um erro se o índice de registro solicitado for menor que 1, maior que o número de registros na tabela ou se a tabela estiver vazia.

First, Indexe Last devolver um único registo. FirstN e LastN retornar uma tabela, mesmo que você especifique apenas um único registro.

Delegação

Quando utiliza com uma origem de dados, estas funções não podem ser delegadas. Só será obtida a primeira parte da origem de dados e, em seguida, a função aplicada. O resultado pode não representar o cenário completo. Poderá aparecer um aviso à hora de criação para lembrá-lo desta limitação e para sugerir que mude para alternativas delegáveis sempre que possível. Para mais informações, consulte a descrição geral de delegação.

Por exemplo, quando usado com uma fonte de dados contendo uma tabela grande com 1 milhão de registros, Last está sujeito ao limite de não delegação e não retorna o último registro de toda a fonte de dados. Da mesma forma, usar Index para solicitar um registro no meio de 1 milhão de registros resulta em um erro porque o índice está fora do intervalo com base no limite de não delegação.

Sintaxe

First( Tabela )
Last( Tabela )

• Tabela - Obrigatório. Tabela a ser utilizada.

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

• Tabela - Obrigatório. Tabela a ser utilizada.
• NumberOfRecords - Opcional. Número de registos a devolver. Se não especificar este argumento, a função devolve um registo.

Index( Tabela, RecordIndex )

• Tabela - Obrigatório. Tabela a ser utilizada.
• RecordIndex - Obrigatório. O índice do primeiro registo a devolver. A numeração dos registos começa em 1.

Exemplos

Para os exemplos a seguir, usamos a fonte de dadosIceCream, que contém os dados desta tabela:

Esta tabela pode ser colocada numa coleção com esta fórmula (coloque a fórmula OnStart para um controlo Button e prima o botão):

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	Descrição	Resultado
First( Gelado )	Devolve o primeiro registo de IceCream.	{ Sabor: "Chocolate", Quantidade: 100 }
Last( Gelado )	Devolve o último registo de IceCream.	{ Sabor: "Pistache", Quantidade: 200 }
Index( Sorvete, 3 )	Devolve o terceiro registo de IceCream.	{ Sabor: "Morango", Quantidade: 300 }
FirstN( Sorvete, 2 )	Devolve uma tabela que contém os dois primeiros registos de IceCream.
LastN( Sorvete, 2 )	Devolve uma tabela que contém os dois últimos registos de IceCream.
Index( Sorvete, 4 ). Quantidade	Devolve o quarto registo da tabela e extrai a coluna Quantidade.	60
Index( Sorvete, 10 )	Devolve um erro, uma vez que o registo solicitado está para além dos limites da tabela.	Erro