Ungroup |
Dégrouper |
| Power Fx |
Syntaxe
|
Ungroup( Table, GroupColumnName )
|
Paramètres
| Nom |
Description |
| Table |
Ce paramètre spécifie la table contenant les groupes d'enregistrements à dissocier. |
| GroupColumnName |
Ce paramètre spécifie le nom de la colonne utilisée pour regrouper les enregistrements dans la table. |
Description
Cette fonction permet de dissocier les enregistrements d'une table groupée.
Remarques
- La fonction Ungroup permet de rétablir la structure d'origine d'une table après un regroupement préalable : Elle est utilisée pour "dégrouper"
une colonne contenant des sous-tables, en réintégrant les enregistrements dans la table principale comme lignes individuelles.
- Ce processus est souvent complémentaire à la fonction GroupBy, utilisée pour regrouper des enregistrements par catégories ou valeurs communes : Ainsi,
Ungroup sert à inverser cette opération lorsqu'on souhaite retrouver une vue plate des données pour traitement ou affichage.
- Le paramètre GroupColumnName doit pointer vers une colonne contenant des tables imbriquées : Il est important que cette colonne ait été construite
via GroupBy ou contienne des sous-tables valides, faute de quoi Ungroup ne pourra pas fonctionner correctement.
- La fonction Ungroup est utile lorsqu'on travaille avec des jeux de données hiérarchiques ou des collections contenant des niveaux imbriqués : Elle
permet de revenir à une représentation linéaire pour effectuer des opérations simples telles que des tris, filtres, ou recherches.
- Ungroup est souvent utilisée dans les formulaires ou galeries de Power Apps pour transformer une structure groupée en liste plate, plus facile à parcourir :
Cela simplifie l'intégration des données dans les contrôles visuels qui ne supportent pas les structures imbriquées.
- Cette fonction est pratique pour manipuler des données collectées de sources multiples où une structure groupée a été appliquée par défaut : Elle permet
alors de désassembler les regroupements automatiques et d'accéder directement à chaque enregistrement.
- Lors de l'utilisation de Ungroup, les autres colonnes de la table initiale sont conservées et recopiées dans chaque ligne extraite : Cela garantit que
l'information contextuelle n'est pas perdue pendant l'opération de dégroupement.
- Ungroup améliore la lisibilité et la manipulation des données en simplifiant la structure complexe d'une table groupée : Elle est donc essentielle
dans les scénarios de traitement de données où la normalisation ou la transformation de structure est requise.
Dernière mise à jour : Jeudi, le 1 Mai 2025