First

Syntaxe

Paramètres

Description

Cette fonction permet de retourner le premier enregistrement d'une table.

Remarques

• Fonction simple mais très pratique pour accéder à un enregistrement : La fonction First permet d'extraire directement le premier enregistrement d'une table sans avoir besoin de trier ou filtrer les données. C'est une manière rapide d'obtenir une valeur de référence ou un exemple d'enregistrement.
• L'ordre des données est crucial pour son usage : Comme First retourne l'enregistrement en tête de la table, il est important de s'assurer que les données sont dans l'ordre souhaité. Il est donc fréquent de combiner First avec Sort pour garantir que l'enregistrement récupéré est bien celui attendu selon une logique métier.
• Permet d'éviter l'utilisation de boucles : Dans des scénarios simples, First permet d'accéder à une ligne sans avoir à parcourir toute la table. Cela simplifie la lecture du code et améliore la performance dans certains cas où seul le premier élément est nécessaire.
• Compatible avec les galeries pour récupérer l'élément sélectionné : First peut être utilisé avec Gallery.AllItems pour récupérer le premier élément visible dans une galerie. Cela peut être utile lorsqu'on souhaite initialiser un formulaire ou une variable avec l'élément actuellement affiché en haut de la liste.
• Retourne un enregistrement, pas une valeur primitive : Contrairement à FirstN qui retourne une table avec plusieurs lignes, First retourne un seul enregistrement. Pour accéder à une valeur spécifique de cet enregistrement, il faut utiliser la notation pointée, par exemple First(Table).Nom.
• Ne déclenche pas d'erreur si la table est vide : Si la table passée à First est vide, la fonction ne renvoie pas une erreur bloquante, mais plutôt un enregistrement vide. Cela permet d'éviter des plantages mais nécessite souvent une vérification avec IsEmpty ou CountRows avant d'utiliser le résultat.
• Utile pour initialiser des valeurs par défaut : First peut être utilisé au chargement d'un écran pour pré-remplir des champs avec les données du premier enregistrement d'une source. Cela facilite la création de formulaires préremplis ou la sélection initiale d'un élément dans une liste.
• Souvent combinée avec des filtres dynamiques : Dans des scénarios interactifs, on peut combiner Filter avec First pour obtenir le premier enregistrement correspondant à un critère donné. Par exemple : First(Filter(Produits, Catégorie = "Livres")). Cela permet une navigation rapide vers un élément spécifique.