Fonctions First, FirstN, Index, Last et LastN

  • Article

S’applique à : Applications canevas Flux de bureau Applications pilotées par modèle CLI Power Platform

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

Description

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

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

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

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

La fonction Index renvoie 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 renvoie une erreur si l’index d’enregistrement demandé est inférieur à 1, supérieur au nombre d’enregistrements dans la table ou si la table est vide.

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

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’il est utilisé avec une source de données contenant une grande table avec 1 million d’enregistrements, Last sera soumis à la limite de non-délégation et ne renverra pas le dernier enregistrement de l’intégralité de la source de données. De même, utiliser Index pour demander un enregistrement au milieu de 1 million d’enregistrements entraînera une erreur, car l’index est hors plage en fonction de la limite de non-délégation.

Syntaxe

First( Table )
Last( Table )

  • Table : obligatoire. Table à utiliser.

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

  • Table : 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 )

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

Exemples

Dans les exemples suivants, nous allons utiliser la source de donnéesIceCream qui contient les données de cette table :

Exemple de glace.

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: "Strawberry", Quantity: 300 }
FirstN( IceCream, 2 ) Renvoie une table contenant les deux premiers enregistrements de IceCream. Table contenant les enregistrements pour Chocolat et Vanille
LastN( IceCream, 2 ) Renvoie une table contenant les deux derniers enregistrements de IceCream. Table contenant les enregistrements pour Chocolat-Menthe et Pistache
Index( IceCream, 4 ).Quantity 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