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

  • Artigo

Aplica-se a: Aplicativos de tela Fluxos da área de trabalho Aplicativos baseados em modelo 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 retornará um erro se o índice de registro solicitado for menor do que 1, maior do que o número de registros na tabela ou se a tabela estiver vazia.

First, Index, and Last retornam um único registro. FirstN e LastN retornarão uma tabela, mesmo se você especificar 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

First( Table )
Last( Table )

  • Table - obrigatório. Tabela na qual operar.

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

  • Table - 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 )

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