FirstN

Syntaxe

Paramètres

Description

Cette fonction permet de retourner les premiers N enregistrements d'une table.

Remarques

• Permet d'extraire facilement plusieurs lignes d'une table : La fonction FirstN est idéale pour récupérer les premiers enregistrements d'une table sans avoir besoin de la parcourir manuellement. Cela s'avère utile, par exemple, pour afficher les premiers résultats d'une recherche ou les éléments les plus récents après tri.
• Fonctionne sans le second paramètre pour simuler First : Si le paramètre NumberOfRecords est omis, FirstN retourne un seul enregistrement sous forme de table (équivalent à FirstN(Table, 1)). Cela la distingue de First, qui retourne un enregistrement unique, et peut être pratique si l'on souhaite conserver un format tabulaire.
• Retourne une table, et non une valeur ou un enregistrement : Contrairement à First, retournant un seul enregistrement, FirstN retourne toujours une table, même si elle ne contient qu'un seul élément. Cette distinction est importante à garder en tête lors de l'utilisation dans des galeries ou des formules de traitement de table.
• Souvent combinée avec Sort pour extraire les meilleurs ou derniers résultats : FirstN est fréquemment utilisée avec Sort ou SortByColumns pour obtenir les N éléments les plus élevés ou les plus récents selon un critère. Par exemple : FirstN(Sort(Produits, DateAjout, Descending), 5).
• Utile pour la pagination ou le chargement progressif : En affichage paginé ou dynamique, FirstN permet de gérer les lots d'enregistrements à afficher. En ajustant NumberOfRecords, on peut créer des interfaces plus légères ou des vues "par page" sans surcharger la mémoire ou l'écran.
• Peut retourner une table vide si la source est vide : Si la table passée en paramètre est vide ou si NumberOfRecords vaut 0, la fonction renvoie une table vide. Cela ne provoque pas d'erreur, ce qui est pratique pour sécuriser l'exécution de l'application, mais il est judicieux de tester avec IsEmpty ou CountRows.
• Fonction puissante pour construire des aperçus de données : Lorsqu'on souhaite montrer un résumé ou un aperçu des données (par exemple, les trois dernières avertissements ou les cinq commandes les plus récentes), FirstN est une solution simple, rapide et performante sans filtrage complexe.
• Adaptable à des cas dynamiques selon les besoins de l'utilisateur : En rendant NumberOfRecords variable (lié à un contrôle, un slider, ou un paramètre utilisateur), on peut laisser l'utilisateur choisir combien d'éléments il souhaite voir. Cela augmente l'interactivité et personnalise l'expérience d'utilisation de l'application.