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

  • Artigo

Aplica-se a: Canvas apps Fluxos de área de trabalho CLI de aplicativos Power Pages Power Platform orientados por modelo

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 função First devolve o primeiro registo de uma tabela.

A função FirstN devolve o primeiro conjunto de registos de uma tabela; o segundo argumento especifica o número de registos a devolver.

A função Last devolve o último registo de uma tabela.

A função LastN devolve o último conjunto de registos de uma tabela; o segundo argumento especifica o número de registos a devolver.

A função Index devolve um registo de uma tabela baseada na posição solicitada na tabela. A numeração dos registos começa em 1, pelo que First( table ) devolve o mesmo registo que Index( table, 1 ). Índice 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.

Primeiro, Índice eÚltimo retornam um único registro. FirstN e LastN retornam 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 é utilizado com uma origem de dados com uma tabela grande com 1 milhão de registos, Last estará sujeito ao limite de não delegação e não devolverá o último registo de toda a origem de dados. Do mesmo modo, utilizar Index para solicitar um registo entre 1 milhão de registos irá resultar num erro, uma vez que o índice está fora do intervalo baseado no limite de não delegação.

Sintaxe

Primeiro( Tabela )
Último( Tabela )

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

FirstN( Tabela [, NúmerodeRegistros ] )
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.

Índice(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 seguintes, iremos utilizar a origem de dadosIceCream, que contém os dados nesta tabela:

Exemplo de IceCream.

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