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

  • Artigo

Aplica-se a: Aplicativos Canvas Fluxos de desktop Aplicativos orientados a modelos Power Pages Power Platform CLI

Retorna o primeiro, o último ou um registro específico, ou um conjunto de primeiros ou últimos registros de uma tabela.

Descrição

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

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

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

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

A função Index 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 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.

Primeiro, Índice e Último retornam um único registro. FirstN e LastN retornam uma tabela, mesmo se você especificar 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 usado com um fonte de dados contendo uma tabela grande com 1 milhão de registros, Last estará sujeito ao limite de não delegação e não retornará o último registro de todo o fonte de dados. Da mesma forma, o uso de Index para solicitar um registro no meio de 1 milhão de registros resultará em um erro porque o índice está fora do intervalo com base no limite de não delegação.

Sintaxe

Primeira( Tabela )
Última( Tabela )

  • Tabela - Obrigatório. Tabela na qual operar.

FirstN( Tabela [, NúmeroDeRegistros ] )
ÚltimoN( Tabela [, NúmeroDeRegistros ] )

  • 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.

Índice( Tabela, 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, usaremos a fonte de dadosIceCream, que contém os dados nesta tabela:

Exemplo IceCream.

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
Primeiro (Sorvete) Retorna o primeiro registro de IceCream. { Flavor: "Chocolate", Quantity: 100 }
Último (Sorvete) Retorna o último registro de IceCream. { Flavor: "Pistachio", Quantity: 200 }
Índice( Sorvete, 3 ) Retorna o terceiro registro de IceCream. { Flavor: "Strawberry", Quantity: 300 }
PrimeiroN(Sorvete, 2) Retorna uma tabela com os dois primeiros registros de IceCream. Tabela com os registros para Chocolate e Vanilla
LastN( Sorvete, 2 ) Retorna uma tabela com os dois últimos registros de IceCream. Tabela com os registros para Mint Chocolate e Pistachio
Índice( Sorvete, 4 ).Quantidade Retorna o quarto registro da tabela e extrai a coluna Quantidade. 60
Índice( Sorvete, 10 ) Retorna um erro, pois o registro solicitado está além dos limites da tabela. Erro