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

  • Artigo

Aplica-se a: Aplicações de tela Fluxos de ambiente de trabalho Aplicações condicionadas por modelo Power Platform CLI

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 ). Index devolve um erro se o índice do registo solicitado for inferior a 1, maior do que o número de registos na tabela ou se a tabela estiver vazia.

First, Index e Last devolvem um único registo. FirstN e LastN devolvem uma tabela, mesmo que especifique apenas um único registo.

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

First( Table )
Last( Table )

  • Table – Obrigatório. Tabela a ser utilizada.

FirstN( Tabela [, NúmeroDeRegistos ] )
LastN( Tabela [, NúmeroDeRegistos ] )

  • Table – 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( Table, RecordIndex )

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