Fonction Distinct

S’applique à : Applications Canvas  Flux Bureau  Applications pilotées par modèle Power Pages Power Platform CLI

Permet d’obtenir un récapitulatif des enregistrements d’une table, en supprimant les doublons.

Description

La fonction Distinct évalue une formule sur chaque enregistrement d’une table et retourne une table à une colonne des résultats avec les valeurs en double supprimées. Le nom de la colonne est Value.

Les champs de l’enregistrement en cours de traitement sont disponibles dans la formule. Utilisez l’opérateur ThisRecord ou référencez simplement les champs par leur nom comme vous le feriez pour toute autre valeur. L’opérateur As peut également être utilisé pour nommer l’enregistrement en cours de traitement, ce qui peut faciliter la compréhension de votre formule et rendre les enregistrements imbriqués accessibles. Pour plus d’informations, consultez les exemples ci-dessous et la section Utilisation de l’étendue de l’enregistrement.

Lorsqu’elle est utilisée avec une source de données, cette fonction ne peut pas être déléguée. Seule la première partie de la source de données sera extraite, puis la fonction sera appliquée. Il se peut que le résultat ne représente pas une vue d’ensemble complète. Un avertissement peut apparaître au moment de la création pour vous rappeler cette limitation et pour vous suggérer d’utiliser d’autres alternatives lorsque cela est possible. Pour plus d’informations, consultez la Vue d’ensemble de la délégation.

Syntaxe

Distinct( Tableau, Formule )

• Tableau - Obligatoire. Table à évaluer.
• Formule - Obligatoire. Formule à évaluer pour chaque enregistrement.

Exemple

1. Insérez un contrôle Button, puis définissez sa propriété OnSelect sur la formule suivante.

   ClearCollect( CityPopulations,
       { City: "London",    Country: "United Kingdom", Population: 8615000 },
       { City: "Berlin",    Country: "Germany",        Population: 3562000 },
       { City: "Madrid",    Country: "Spain",          Population: 3165000 },
       { City: "Hamburg",   Country: "Germany",        Population: 1760000 },
       { City: "Barcelona", Country: "Spain",          Population: 1602000 },
       { City: "Munich",    Country: "Germany",        Population: 1494000 }
   );
   

2. Cliquez sur le bouton tout en maintenant la touche Alt enfoncée.

   La formule est évaluée et la collection CityPopulations est créée et vous pouvez l’afficher en sélectionnant CityPopulations dans la barre de formule :

   

3. Insérez un contrôle Data table, puis définissez sa propriété Items selon cette formule :

   Distinct( CityPopulations, Country )
   

   Vous pouvez afficher le résultat de cette formule dans la barre de formule en sélectionnant la formule entière :

   

4. Utilisez le lien Modifier les champs dans le volet des propriétés de la table de données pour ajouter la colonne Valeur :

   

5. Insérez un contrôle Label et définissez sa propriété Text sur la formule :

   First( Sort( Distinct( CityPopulations, Country ), Value ) ).Value
   

   Cette formule trie les résultats de Distinct avec la fonction Sort, prend le premier enregistrement de la table résultante avec la fonction First et extrait le champ Résultat pour obtenir uniquement le nom du pays/de la région.