RenameColumns |
Renomme la colonne |
| Power Fx |
Syntaxe
|
RenameColumns( Table, OldColumnName1, NewColumnName1 [, OldColumnName2, NewColumnName2, ... ] )
|
Paramètres
| Nom |
Description |
| Table |
Ce paramètre représente la table dans laquelle les colonnes doivent être renommées. Il s'agit de la structure de données contenant les colonnes que l'on souhaite modifier. |
| OldColumnName1 |
Ce paramètre représente le nom actuel de la première colonne que l'on souhaite renommer. Il est utilisé pour spécifier la colonne à modifier. |
| NewColumnName1 |
Ce paramètre représente le nouveau nom que l'on souhaite attribuer à la colonne spécifiée par OldColumnName1. |
| OldColumnName2, NewColumnName2, ... |
Ces paramètres supplémentaires (optionnels) permettent de renommer plusieurs colonnes en une seule fonction, en indiquant successivement le nom actuel et le nouveau nom pour chaque colonne. |
Description
Cette fonction permet de renommer les colonnes d'une table.
Remarques
- Permet de rendre les noms de colonnes plus explicites : RenameColumns est très utile pour adapter les noms des colonnes d'une table à la
terminologie métier ou à une convention de nommage spécifique. Cela améliore la lisibilité des données et leur compréhension par les utilisateurs finaux ou les
développeurs.
- Fonction très pratique après une importation de données : Lorsqu'une table est créée automatiquement à partir d'une source externe (comme Excel ou
SharePoint), les noms des colonnes peuvent être techniques ou peu parlants. RenameColumns permet alors de restructurer les noms pour mieux correspondre aux attentes
fonctionnelles de l'application.
- Permet de renommer plusieurs colonnes dans un seul appel : Cette fonction accepte plusieurs paires ancien nom / nouveau nom, ce qui évite d'avoir à
chaîner plusieurs appels. Cela rend l'opération de renommage plus efficace, et le code plus compact et maintenable.
- Crée une nouvelle table avec les noms modifiés, sans modifier la source d'origine : RenameColumns retourne une copie de la table avec les colonnes
renommées. Elle n'altère pas la table d'origine, ce qui en fait une fonction non destructive, idéale pour un traitement temporaire ou une transformation à
l'affichage.
- Peut être combinée avec d'autres fonctions de transformation : Il est fréquent d'utiliser RenameColumns avec des fonctions comme AddColumns,
DropColumns ou ShowColumns pour ajuster finement la structure d'une table. Cela permet de construire des vues personnalisées adaptées à des besoins particuliers.
- Attention aux conflits de noms ou doublons accidentels : Si un nouveau nom de colonne correspond déjà à une autre colonne existante dans la table, cela
peut entraîner des erreurs ou un comportement inattendu. Il est donc recommandé de s'assurer que les nouveaux noms sont uniques dans le contexte de la table.
- Peut être utilisé pour améliorer la compatibilité entre tables différentes : Lorsque l'on veut fusionner ou comparer plusieurs tables aux structures
différentes, renommer certaines colonnes permet d'harmoniser les noms et d'éviter les incompatibilités lors d'opérations comme Union, Collect,
ou Patch.
- Ne fonctionne que sur des tables structurelles (pas sur des sources connectées directement) : Il faut garder à l'esprit que RenameColumns s'applique
à des objets de type table dans Power Fx, mais ne modifie pas les schémas réels dans les bases de données ou les listes SharePoint. Pour changer le nom d'une colonne
dans une source externe, il faut passer par l'interface ou l'outil source.
Dernière mise à jour : Jeudi, le 1 Mai 2025
