First, , FirstN, Index, Lastet LastN fonctions

S’applique à : Les applications Canvas Copilot Studio Desktop circulent des applications basées sur des modèles power Platform CLI Dataverse functions Power Pages

Renvoie le premier, le dernier ou un enregistrement spécifique, ou un ensemble de premiers ou derniers enregistrements, d’une table.

Description

La First fonction retourne le premier enregistrement d’une table.

La FirstN fonction retourne le premier jeu d’enregistrements d’une table ; le deuxième argument spécifie le nombre d’enregistrements à retourner.

La Last fonction retourne le dernier enregistrement d’une table.

La LastN fonction retourne le dernier jeu d’enregistrements d’une table ; le deuxième argument spécifie le nombre d’enregistrements à retourner.

La Index fonction retourne un enregistrement d’une table en fonction de sa position ordonnée dans la table. La numérotation des enregistrements commence par 1 donc First( table ) renvoyant le même enregistrement que Index( table, 1 ). Index retourne une erreur si l’index d’enregistrement demandé est inférieur à 1, supérieur au nombre d’enregistrements de la table ou si la table est vide.

First, Indexet Last retourne un enregistrement unique. FirstN et LastN retourne une table, même si vous spécifiez un seul enregistrement.

Délégation

Lorsqu’elles sont utilisées avec une source de données, ces fonctions ne peuvent pas être déléguées. Seule la première partie de la source de données sera extraite, puis la fonction sera appliquée. Il se peut que le résultat ne représente pas une vue d’ensemble complète. Un avertissement peut apparaître au moment de la création pour vous rappeler cette limitation et pour vous suggérer d’utiliser d’autres alternatives lorsque cela est possible. Pour plus d’informations, consultez la Vue d’ensemble de la délégation.

Par exemple, lorsqu’elle est utilisée avec une source de données contenant une table volumineuse avec 1 million d’enregistrements, Last est soumise à la limite de non-délégation et ne retourne pas le dernier enregistrement de la source de données entière. De même, l’utilisation Index d’un enregistrement au milieu de 1 million d’enregistrements entraîne une erreur, car l’index est hors limites en fonction de la limite de non-délégation.

Syntaxe

First( Tableau )
Last( Tableau )

• Tableau - Obligatoire. Table à utiliser.

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

• Tableau - Obligatoire. Table à utiliser.
• NumberOfRecords - Facultatif. Nombre d’enregistrements à renvoyer. Si vous ne spécifiez pas cet argument, la fonction renvoie un enregistrement.

Index( Table, RecordIndex )

• Tableau - Obligatoire. Table à utiliser.
• RecordIndex - Obligatoire. Index de l’enregistrement à renvoyer. La numérotation des enregistrements commence par 1.

Exemples

Pour les exemples suivants, nous utilisons la source de donnéesIceCream, qui contient les données de ce tableau :

Cette table peut être placée dans une collection avec cette formule (mettre dans la formule OnStart pour un contrôle Button et appuyer sur le bouton) :

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

Formule	Description	Result
First( IceCream )	Renvoie le premier enregistrement de IceCream.	{ Flavor : « Chocolate », Quantity : 100 }
Last( IceCream )	Renvoie le dernier enregistrement de IceCream.	{ Flavor : « Pistachio », Quantity : 200 }
Index( IceCream, 3 )	Renvoie le troisième enregistrement de IceCream.	{ Flavor : « Fraise », Quantity : 300 }
FirstN( IceCream, 2 )	Renvoie une table contenant les deux premiers enregistrements de IceCream.
LastN( IceCream, 2 )	Renvoie une table contenant les deux derniers enregistrements de IceCream.
Index( IceCream, 4 ). Quantité	Renvoie le quatrième enregistrement de la table et extrait la colonne Quantité.	60
Index( IceCream, 10 )	Renvoie une erreur, car l’enregistrement demandé est au-delà des limites de la table.	Erreur