SortByColumns |
Tri par colonne |
| Power Fx |
Syntaxe
|
SortByColumns( Table, ColumnName1 [, SortOrder1, ColumnName2, SortOrder2, ... ] )
|
|
SortByColumns( Table, ColumnName, SortOrderTable )
|
Paramètres
| Nom |
Description |
| Table |
Ce paramètre représente la table que l'on souhaite trier. Cela peut être une collection ou une autre source de données contenant des enregistrements. |
| ColumnName1 |
Ce paramètre représente le nom de la première colonne sur laquelle la table sera triée. |
| SortOrder1 |
Ce paramètre est optionnel et représente l'ordre de tri pour la première colonne. Il peut être Ascending (croissant) ou Descending (décroissant). Si omis, l'ordre par défaut est Ascending. |
| ColumnName2 |
Ce paramètre représente le nom d'une autre colonne sur laquelle la table sera triée (si plusieurs colonnes sont spécifiées). |
| SortOrder2 |
Ce paramètre est optionnel et représente l'ordre de tri pour la deuxième colonne (si plusieurs colonnes sont spécifiées). |
| SortOrderTable |
Ce paramètre est une table qui contient des paires de colonnes et d'ordres de tri. Cela permet de spécifier l'ordre de tri pour plusieurs colonnes en une seule structure de données. |
Description
Cette fonction permet de retourner une table triée en fonction d'une ou plusieurs colonnes.
Remarques
- Tri multi-colonnes pour un classement précis : La fonction SortByColumns permet de trier une table selon plusieurs colonnes successives. Cela est
très utile lorsque deux ou plusieurs champs doivent influencer l'ordre d'affichage, par exemple trier d'abord par catégorie, puis par date.
- L'ordre de tri peut être défini pour chaque colonne : Chaque colonne spécifiée peut avoir son propre ordre de tri, soit Ascending, soit
Descending. Cela donne un contrôle très fin sur la présentation des données, comme trier par nom croissant, puis par date décroissante.
- Supporte les noms de colonnes sous forme de chaînes : Contrairement à la fonction Sort, SortByColumns utilise des
noms de colonnes exprimés en texte (strings). Cela permet d'écrire des expressions dynamiques où les noms de colonnes à trier peuvent provenir d'une variable ou
d'une logique conditionnelle.
- Compatible avec une table d'ordres de tri structurée : Avec le second format de syntaxe, on peut passer une table de tri (SortOrderTable) contenant
les colonnes et leurs ordres associés. Cela simplifie la gestion de tris complexes, surtout lorsque l'on veut les adapter dynamiquement dans une application.
- Très utile pour les galeries de données structurées : Dans Power Apps, les galeries affichent souvent des données tabulaires. SortByColumns permet
d'appliquer un tri logique reflétant les attentes de l'utilisateur, par exemple trier par score et, en cas d'égalité, par nom.
- Meilleure lisibilité que Sort pour les tris simples par colonne : Lorsque l'on veut juste trier par une ou plusieurs colonnes de manière claire et
directe, SortByColumns est souvent plus lisible que la version avec Sort et formule. Cela la rend plus accessible aux développeurs débutants.
- L'ordre par défaut est croissant si non spécifié : Si l'on omet un ordre de tri (SortOrder), SortByColumns applique automatiquement un tri
croissant (Ascending). Cela évite les erreurs si l'on souhaite juste ordonner une colonne dans l'ordre naturel sans se préoccuper des paramètres supplémentaires.
- Fonctionne uniquement avec des colonnes existantes et nommées : Les noms de colonnes doivent être exactement ceux présents dans la table d'origine, faute
de quoi la fonction renverra une erreur. De plus, contrairement à Sort, elle ne permet pas d'utiliser des formules complexes comme critère de tri.
Dernière mise à jour : Jeudi, le 1 Mai 2025