AddColumns |
Ajout de colonnes |
| Power Fx |
Syntaxe
|
AddColumns( Table, ColumnName1, Formula1 [, ColumnName2, Formula2, ... ] )
|
Paramètres
| Nom |
Description |
| Table |
Ce paramètre représente la table de départ à laquelle on souhaite ajouter une ou plusieurs colonnes. |
| ColumnName1 |
Ce paramètre représente le nom de la première colonne à ajouter. Ce paramètre permet de définir l'identifiant de la nouvelle colonne dans la table. |
| Formula1 |
Ce paramètre représente la formule utilisée pour calculer les valeurs de la colonne nommée ColumnName1. Ce paramètre permet de générer dynamiquement les valeurs en fonction des données de chaque ligne. |
| ColumnName2, ... |
Ces paramètres représentent les noms supplémentaires de colonnes à ajouter, s'ils existent. Chaque nom suit la même logique que ColumnName1. |
| Formula2, ... |
Ces paramètres représentent les formules associées à chaque colonne supplémentaire. Chaque formule est évaluée pour chaque ligne de la table. |
Description
Cette fonction permet d'ajouter une colonne à une table, avec une formule définissant les valeurs.
Remarques
- La fonction AddColumns permet d'ajouter dynamiquement une ou plusieurs colonnes à une table existante sans modifier la source d'origine. Chaque nouvelle colonne
est générée à partir d'une formule, ce qui permet un enrichissement contextuel des données. C'est une fonction essentielle pour la préparation ou la transformation de jeux
de données dans Power Fx.
- La syntaxe suit une structure simple : AddColumns(Table, ColumnName, Formula), et peut être étendue avec plusieurs colonnes. Chaque colonne est définie par un nom et
une formule, passés en paires successives. Cela permet de calculer plusieurs valeurs dérivées en une seule opération fluide.
- Le paramètre Table représente la table d'entrée à laquelle les colonnes seront ajoutées. Il peut s'agir d'une source de données directe (comme une collection ou une
requête) ou d'une table calculée. Cette flexibilité permet d'utiliser AddColumns aussi bien pour des vues temporaires que des interfaces utilisateur.
- Chaque ColumnName est une chaîne de caractères qui détermine le nom de la nouvelle colonne. Ce nom doit être unique dans le contexte de la table résultante pour éviter
les conflits. Il sert d'identifiant dans les galeries, les visualisations ou les calculs ultérieurs.
- Le paramètre Formula est évalué pour chaque ligne de la table, en tenant compte des données disponibles dans cette ligne. Il peut faire référence à d'autres colonnes,
utiliser des fonctions intégrées ou contenir des expressions conditionnelles. Cela permet de créer des colonnes intelligentes et contextuelles, adaptées aux besoins
métier.
- AddColumns ne modifie pas la table d'origine mais retourne une nouvelle table étendue, contenant les colonnes ajoutées. C'est un principe fondamental de Power Fx, basé
sur l'immuabilité des données : les opérations sont non destructives. Cela facilite la traçabilité et la sécurité dans les transformations.
- On peut chaîner AddColumns avec d'autres fonctions comme Filter, Sort ou GroupBy pour créer des requêtes complexes. Par exemple, on peut filtrer une table, puis y
ajouter des calculs, et enfin la trier selon une nouvelle colonne. Cela permet de concevoir des traitements puissants tout en restant lisibles et maintenables.
- L'utilisation de plusieurs paires ColumnName/Formula permet de créer plusieurs colonnes simultanément, ce qui améliore la performance. Cela évite d'avoir à utiliser
plusieurs appels AddColumns imbriqués. C'est une pratique recommandée pour optimiser les performances et la clarté des formules.
Dernière mise à jour : Jeudi, le 1 Mai 2025
