First, FirstN, Index, e LastLastN funções

Aplica-se a: Aplicativos de tela Copilot Studio Desktop flui aplicativos baseados em modelo CLI CLI Dataverse funções Power Pages

Retorna o primeiro, o último ou um registro específico, ou um conjunto de primeiros ou últimos registros 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 do registro começa com 1, então First( table ) retorna o mesmo registro do que Index( table, 1 ). Index retornará 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 retornar um único registro. FirstN e LastN retorne uma tabela, mesmo que você especifique apenas um único registro.

Delegação

Quando usadas com uma fonte de dados, estas funções não poderão ser delegadas. Somente a primeira parte da fonte de dados será recuperada e então a função será aplicada. O resultado pode não representar a história completa. Um aviso pode ser exibido no momento da criação para lembrá-lo dessa limitação e para sugerir a troca para alternativas delegáveis sempre que possível. Para obter mais informações, consulte visão geral de delegação.

Por exemplo, quando usada com uma fonte de dados que contém uma tabela grande com 1 milhão de registros, Last está sujeita 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 na qual operar.

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

• Tabela - Obrigatório. Tabela na qual operar.
• NumberOfRecords - Opcional. Número de registros a serem retornados. Se você não especificar esse argumento, a função retornará um registro.

Index( Table, RecordIndex )

• Tabela - Obrigatório. Tabela na qual operar.
• RecordIndex - Obrigatório. O índice do registro a ser retornado. A numeração dos registros começa com 1.

Exemplos

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

Esta tabela pode ser colocada em uma coleção com esta fórmula (coloque a fórmula OnStart para um controle Button e pressione 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( IceCream )	Retorna o primeiro registro de IceCream.	{ Sabor: "Chocolate", Quantidade: 100 }
Last( IceCream )	Retorna o último registro de IceCream.	{ Sabor: "Pistache", Quantidade: 200 }
Index( IceCream, 3 )	Retorna o terceiro registro de IceCream.	{ Sabor: "Morango", Quantidade: 300 }
FirstN( IceCream, 2 )	Retorna uma tabela com os dois primeiros registros de IceCream.
LastN( IceCream, 2 )	Retorna uma tabela com os dois últimos registros de IceCream.
Index( IceCream, 4 ). Quantidade	Retorna o quarto registro da tabela e extrai a coluna Quantidade.	60
Index( IceCream, 10 )	Retorna um erro, pois o registro solicitado está além dos limites da tabela.	Erro