Distinct

Syntaxe

Paramètres

Description

Cette fonction permet de retourner une table contenant des valeurs distinctes d'une colonne spécifiée.

Remarques

• La fonction Distinct permet d'extraire une liste sans doublons à partir d'une colonne ou d'une expression dans une table. Cela est particulièrement utile pour générer des filtres, des menus déroulants ou des résumés de données sans répétitions inutiles. Elle joue un rôle important dans la simplification de l'affichage des données.
• Le paramètre Table correspond à la source de données dans laquelle les valeurs seront examinées. Il peut s'agir d'une collection locale, d'une table issue d'une source externe (SharePoint, Dataverse,...), ou d'un résultat calculé. Il est crucial que la table soit bien structurée pour que l'extraction soit pertinente.
• Le second paramètre, Formula, détermine ce qui doit être rendu unique : une colonne simple comme NomClient, ou une expression plus complexe. Par exemple, Distinct(Produits, Nom & "-" & Catégorie) permet de récupérer des combinaisons uniques sur plusieurs champs. Cela offre une grande flexibilité dans la manipulation des données.
• Le résultat de Distinct est une table à une seule colonne nommée "Result", contenant les valeurs distinctes extraites. Si vous avez besoin de renommer cette colonne, vous pouvez ensuite utiliser une fonction comme RenameColumns. Cela est souvent nécessaire pour l'affichage ou l'intégration avec d'autres fonctions.
• Distinct est très utile lorsqu'on veut créer un menu déroulant dynamique qui n'affiche qu'une seule fois chaque option disponible. Par exemple, dans un champ de sélection de villes, cette fonction permet d'éviter que la même ville n'apparaisse plusieurs fois. Cela améliore la lisibilité et l'expérience utilisateur.
• L'utilisation de formules dans le second paramètre permet d'aller au-delà d'une simple extraction de colonnes. On peut par exemple écrire Distinct(Transactions, Text(Date, "mmm-yyyy")) pour obtenir la liste des mois uniques d'une série de dates. Cela permet de faire des regroupements visuels ou des rapports synthétiques.
• Il faut noter que Distinct ne retourne que des valeurs uniques, sans tenir compte de leur fréquence ou ordre initial. Il est donc parfois judicieux de le combiner avec des fonctions comme Sort si l'on souhaite un tri alphabétique ou chronologique. C'est essentiel lorsqu'on prépare une interface utilisateur soignée.
• Enfin, Distinct est une fonction non déléguée dans certains connecteurs, ce qui peut limiter son utilisation avec de grandes sources de données comme SharePoint. Cela signifie que seules les premières 500 ou 2000 lignes peuvent être traitées localement, selon les paramètres. Il faut donc être vigilant à l'impact sur les performances et la complétude des résultats.