GroupBy |
Groupé par |
| Power Fx |
Syntaxe
|
GroupBy( Table, ColumnName1 [, ColumnName2, ... ], GroupColumnName )
|
Paramètres
| Nom |
Description |
| Table |
Ce paramètre représente la table contenant les enregistrements à regrouper. |
| ColumnName1 |
Ce paramètre représente le premier nom de la colonne selon laquelle les enregistrements seront regroupés. |
| ColumnName2, ... |
Ce paramètre représente des noms supplémentaires de colonnes selon lesquelles les enregistrements seront regroupés. |
| GroupColumnName |
Ce paramètre représente le nom de la colonne qui contiendra les groupes d'enregistrements après le regroupement. |
Description
Cette fonction permet de regrouper les enregistrements d'une table en fonction d'une colonne spécifiée.
Remarques
- Permet de structurer les données de manière hiérarchique : La fonction GroupBy crée une nouvelle table dans laquelle les enregistrements sont regroupés
par une ou plusieurs colonnes communes. Cela permet de structurer les données sous forme de groupes logiques, ce qui est particulièrement utile pour les affichages
par catégorie ou les traitements agrégés.
- Génère une colonne contenant des sous-tables : Chaque ligne du résultat de GroupBy contient une colonne spéciale (nommée via GroupColumnName)
qui elle-même contient les enregistrements correspondant au groupe. Cela transforme une table "plate" en une structure imbriquée.
- Utile pour des opérations de résumé avec AddColumns et CountRows : Une fois les données regroupées, on peut les enrichir avec des colonnes calculées
résumant le contenu du groupe. Par exemple, on peut utiliser AddColumns et CountRows pour compter le nombre d'enregistrements par groupe.
- Peut regrouper selon plusieurs colonnes à la fois : GroupBy accepte plusieurs noms de colonnes pour définir les critères de regroupement. Cela permet
de créer des groupes très précis, par exemple : regrouper les commandes par client et par année.
- Doit être associé à Ungroup pour restaurer la table initiale : Si on souhaite revenir à la structure initiale d'une table après un regroupement, la
fonction Ungroup est indispensable. Elle permet d'éclater les groupes et de réobtenir la liste d'enregistrements d'origine.
- Ne modifie pas les données sources : Comme toutes les fonctions de transformation de données dans Power Fx, GroupBy retourne une nouvelle
table sans modifier les données originales. Il peut donc être utilisé librement sans risque d'altération de la source.
- La colonne GroupColumnName est librement nommable : Le nom que vous choisissez pour la colonne contenant les groupes (GroupColumnName) n'a pas besoin de
correspondre à une colonne existante. Ce nom est défini par l'utilisateur et devient le champ d'accès aux sous-tables.
- Fonction très utile pour les interfaces dynamiques : Dans une galerie, par exemple, GroupBy permet d'afficher des titres de groupe (comme des catégories ou
des dates) accompagnés de sous-éléments dans des galeries imbriquées. Cela améliore la lisibilité et l'organisation visuelle des données affichées à l'utilisateur.
Dernière mise à jour : Jeudi, le 1 Mai 2025