except

Syntaxe

Paramètres

Description

Ce filtre permet de retirer des éléments d'un tableau.

Remarques

• Permet de soustraire des éléments entre deux collections : Le filtre except effectue une différence d'ensemble entre deux collections. Il retourne les éléments de collection1 qui ne sont pas présents dans collection2, ce qui permet de filtrer dynamiquement des éléments non désirés dans une liste.
• Utile pour éviter les doublons ou éléments interdits : Ce filtre est très pratique lorsqu'on souhaite exclure certains éléments spécifiques d'une liste, par exemple des utilisateurs déjà sélectionnés, des produits déjà achetés, ou des rôles déjà attribués. Cela permet une gestion logique sans avoir à manipuler manuellement les collections.
• Fonctionne sur la base de l'égalité des éléments : La comparaison entre les deux collections se fait sur l'égalité exacte des objets, ce qui signifie que les objets doivent être identiques en valeur et en structure. Deux objets ayant la même apparence mais des références internes différentes ne seront pas exclus.
• Peut être combiné avec d'autres filtres comme sort ou where : Une fois la collection réduite par except, on peut la enchaîner avec d'autres filtres pour l'affiner davantage, comme un tri (sort) ou un filtrage conditionnel (where). Cela permet de construire des chaînes d'opérations puissantes sur des ensembles de données.
• Ne modifie pas les collections originales : Comme la plupart des filtres Liquid, except ne modifie pas collection1 ni collection2, mais retourne une nouvelle collection filtrée. Il s'utilise donc idéalement dans des affectations avec assign ou directement dans des boucles d'affichage.
• Nécessite que les deux paramètres soient des collections : Si l'un des deux paramètres fournis n'est pas une collection (par exemple une chaîne ou un nombre), le filtre peut ne rien retourner ou provoquer une erreur. Il est donc important de s'assurer que les deux arguments sont bien des tableaux ou des objets itérables.
• Utile pour la logique d'exclusion dans les portails Power Pages : Dans un portail Dynamics 365, on peut utiliser except pour éviter d'afficher des enregistrements déjà associés à un utilisateur, comme des inscriptions à des événements, des relations, ou des rôles personnalisés, ce qui rend les interfaces plus pertinentes et dynamiques.
• Limité aux comparaisons simples (pas de correspondance conditionnelle) : Le filtre except ne permet pas de filtrage conditionnel basé sur un champ spécifique à l'intérieur d'un objet complexe. Si vous avez une collection d'objets et que vous souhaitez exclure selon un champ particulier, il faudra passer par un where combiné ou un traitement intermédiaire.