Funzioni First, FirstN, Index, Last, e LastN

Si applica a: app canvas flussi desktop app basate su modello Power Platform CLI

Restituisce il primo, l'ultimo o uno specifico record, o un set di primi o ultimi record, da una tabella.

Descrizione

La funzione First restituisce il primo record di una tabella.

La funzione FirstN restituisce il primo set di record di una tabella. Il secondo argomento specifica il numero di record da restituire.

La funzione Last restituisce l'ultimo record di una tabella.

La funzione LastN restituisce l'ultimo set di record di una tabella. Il secondo argomento specifica il numero di record da restituire.

La funzione Index restituisce un record di una tabella in base alla sua posizione ordinata nella tabella. La numerazione dei record inizia con 1 so First( table ) restituisce lo stesso record di Index( table, 1 ). Index restituisce un errore se l'indice del record richiesto è inferiore a 1, maggiore del numero di record nella tabella o se la tabella è vuota.

First, Index, e Last restituiscono un singolo record. FirstN e LastN restituiscono una tabella, anche se si specifica un singolo record.

Delega

Quando viene utilizzata con un'origine dati, queste funzioni non possono essere delegate. Solo la prima parte dell'origine dati verrà recuperata e la funzione applicata. Il risultato potrebbe non rappresentare la storia completa. Un avviso potrebbe apparire al momento della creazione per ricordarti questo limite e per suggerire di passare ad alternative delegabili quando possibile. Per ulteriori informazioni, consultare panoramica delega.

Ad esempio, se utilizzato con un'origine dati contenente una tabella di grandi dimensioni con 1 milione di record, Last sarà soggetto al limite di non delega e non restituirà l'ultimo record dell'intera origine dati. Allo stesso modo, usando Index per richiedere un record nel mezzo di 1 milione di record comporterà un errore perché l'indice è fuori dall'intervallo basato sul limite di non delega.

Sintassi

First( Table )
Last( Table )

• Table: obbligatorio. Tabella su cui eseguire le operazioni.

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

• Table: obbligatorio. Tabella su cui eseguire le operazioni.
• NumberOfRecords: facoltativo. Numero di record da restituire. Se non si specifica questo argomento, la funzione restituisce un record.

Index( Table, RecordIndex )

• Table: obbligatorio. Tabella su cui eseguire le operazioni.
• RecordIndex: obbligatorio. Indice del record da restituire. La numerazione dei record inizia con 1.

Esempi

Per gli esempi riportati di seguito verrà usata l'origine datiIceCream, che contiene i dati della tabella seguente:

Questa tabella può essere inserita in una raccolta con questa formula (inserisci la formula OnStart per un controllo Button e premi il pulsante):

Collect( IceCream, Table( { Flavor: "Chocolate", Quantity: 100 },
                          { Flavor: "Vanilla", Quantity: 200 },
                          { Flavor: "Strawberry", Quantity: 300 },
                          { Flavor: "Mint Chocolate", Quantity: 60 },
                          { Flavor: "Pistachio", Quantity: 200 } ) )

Formula	Descrizione	Risultato
First( IceCream )	Restituisce il primo record di IceCream.	{ Flavor: "Chocolate", Quantity: 100 }
Last( IceCream )	Restituisce l'ultimo record di IceCream.	{ Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 )	Restituisce il terzo record di IceCream.	{ Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 )	Restituisce una tabella contenente i primi due record di IceCream.
LastN( IceCream, 2 )	Restituisce una tabella contenente gli ultimi due record di IceCream.
Index( IceCream, 4 ).Quantity	Restituisce il quarto record della tabella ed estrae la colonna Quantity.	60
Index( IceCream, 10 )	Restituisce un errore poiché il record richiesto è oltre i limiti della tabella.	Errore