Die Funktionen „First“, „FirstN“, „Index“, „Last“ und „LastN“

Gilt für: Canvas-Apps Desktop-Flows Modellgesteuerte Apps Power Platform CLI

Gibt den ersten, letzten oder einen bestimmten Datensatz oder eine Reihe von ersten oder letzten Datensätzen aus einer Tabelle zurück.

Beschreibung

Die First-Funktion gibt den ersten Datensatz einer Tabelle zurück.

Die FirstN-Funktion gibt die erste Gruppe von Datensätzen einer Tabelle zurück; das zweite Argument gibt die Anzahl der zurückzugebenden Datensätze an.

Die Last-Funktion gibt den letzten Datensatz einer Tabelle zurück.

Die LastN-Funktion gibt die letzte Gruppe von Datensätzen einer Tabelle zurück; das zweite Argument gibt die Anzahl der zurückzugebenden Datensätze an.

Die Index-Funktion gibt einen Datensatz einer Tabelle basierend auf ihrer geordneten Position in der Tabelle zurück. Die Datensatznummerierung beginnt mit 1, sodass First( table ) den gleichen Datensatz wie Index( table, 1 ) zurückgibt. Index gibt einen Fehler zurück, wenn der angeforderte Datensatzindex kleiner als 1, größer als die Anzahl der Datensätze in der Tabelle oder die Tabelle leer ist.

First, Index und Last geben einen einzelnen Datensatz zurück. FirstN und LastN geben eine Tabelle zurück, selbst wenn Sie nur einen einzelnen Datensatz angeben.

Stellvertretung

Diese Funktionen können bei Verwendung einer Datenquelle nicht delegiert werden. Nur der erste Teil der Datenquelle wird abgerufen, bevor die Funktion angewendet wird. Das Ergebnis stellt möglicherweise nicht alles dar. Bei Erstellungszeit erinnert möglicherweise eine Warnung an diese Einschränkung und schlägt den Wechsel zu delegierbaren Alternativen vor, sofern diese bestehen. Weitere Informationen finden Sie unter Überblick über Delegation.

Bei Verwendung mit einer Datenquelle, die eine große Tabelle mit 1 Million Datensätze enthält, gilt für Last zum Beispiel der Nichtdelegierungsgrenzwert und gibt nicht den letzten Datensatz der gesamten Datenquelle zurück. Die Verwendung von Index zur Anforderung eines Datensatzes in der Mitte von 1 Million Datensätzen führt ebenfalls zu einem Fehler, da der Index basierend auf dem Nichtdelegierungsgrenzwert außerhalb des zulässigen Bereichs liegt.

Syntax

First( Table )
Last( Table )

• Table – Erforderlich. Die zu verarbeitende Tabelle.

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

• Table – Erforderlich. Die zu verarbeitende Tabelle.
• NumberOfRecords - Optional. Die Anzahl der zurückzugebenden Datensätze. Wenn Sie dieses Argument nicht angeben, gibt die Funktion einen Datensatz zurück.

Index( Table, RecordIndex )

• Table – Erforderlich. Die zu verarbeitende Tabelle.
• RecordIndex – Erforderlich. Der Index des Datensatzes, der zurückgegeben werden soll. Die Datensatznummerierung beginnt mit 1.

Beispiele

Für das folgende Beispiel verwenden wir die IceCreamDatenquelle, die die Daten in dieser Tabelle enthält:

Diese Tabelle kann mit dieser Formel in einer Sammlung platziert werden (geben Sie die OnStart-Formel für ein „Button“-Steuerelement ein und drücken Sie die Schaltfläche):

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

Formel	Beschreibung	Ergebnis
First( IceCream )	Gibt den ersten Datensatz von IceCream zurück.	{ Flavor: "Chocolate", Quantity: 100 }
Last( IceCream )	Gibt den letzten Datensatz von IceCream zurück.	{ Flavor: "Pistachio", Quantity: 200 }
Index( IceCream, 3 )	Gibt den dritten Datensatz von IceCream zurück.	{ Flavor: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 )	Gibt eine Tabelle zurück, die die ersten beiden Datensätze von IceCream enthält.
LastN( IceCream, 2 )	Gibt eine Tabelle zurück, die die letzten beiden Datensätze von IceCream enthält.
Index( IceCream, 4 ).Quantity	Gibt den vierten Datensatz der Tabelle zurück und extrahiert die Spalte „Menge“.	60
Index( IceCream, 10 )	Gibt einen Fehler zurück, da der angeforderte Datensatz außerhalb der Tabellengrenzen liegt.	Fehler