ColumnNames

Syntaxe

Paramètres

Description

Cette fonction permet de retourner les noms des colonnes d'une table.

Remarques

• La fonction ColumnNames est utile pour obtenir dynamiquement la liste des noms de colonnes d'un enregistrement ou d'une table. Elle permet de connaître la structure exacte des données, ce qui est particulièrement pratique lorsqu'on travaille avec des sources inconnues ou variables. Cela facilite aussi le débogage et la génération automatique d'interfaces utilisateur.
• Le paramètre UntypedRecord désigne une structure de données sans typage strict, comme une table retournée par une requête ou une API. Ce paramètre donne à la fonction une grande flexibilité, puisqu'il n'est pas nécessaire de connaître à l'avance la structure de la source. Cela est idéal dans les scénarios de manipulation de données génériques ou dynamiques.
• ColumnNames retourne une table contenant des chaînes de caractères représentant les noms des colonnes. Ces noms peuvent ensuite être utilisés pour des traitements dynamiques comme la génération de colonnes dans une galerie. Par exemple, cela permet de créer un affichage automatique basé sur la structure des données.
• Lorsqu'on utilise ColumnNames avec des données provenant de Dataverse ou d'une autre source connectée, on peut découvrir les champs disponibles sans aller consulter la documentation ou l'interface graphique. Cela donne plus d'autonomie au développeur, notamment dans les applications à structure variable. C'est une façon pratique de faire de l'exploration de données.
• La fonction ColumnNames est fréquemment combinée avec des boucles ForAll ou des expressions conditionnelles. Par exemple, on peut itérer sur chaque nom de colonne pour créer un formulaire ou une logique de validation. Cela ouvre la porte à des applications très personnalisables.
• Elle s'avère très utile dans les cas où l'utilisateur doit pouvoir modifier la structure des données, comme ajouter ou supprimer des champs. En utilisant ColumnNames, l'application peut automatiquement s'adapter à ces changements sans modification du code. Cela renforce la robustesse et la souplesse de l'application.
• Attention : cette fonction retourne uniquement les noms, pas les types de données associés à chaque colonne. Pour récupérer aussi les types, il faut utiliser d'autres fonctions ou approches. C'est un point important à connaître lorsqu'on prépare un traitement conditionnel selon le type.
• En résumé, ColumnNames est une fonction précieuse dans la construction d'interfaces dynamiques, l'analyse de structure et la documentation automatique. Elle permet de rendre les applications Power Fx plus intelligentes et moins dépendantes d'une structure rigide. Elle fait partie des outils essentiels pour la conception de composantes génériques ou réutilisables.