metafilters

Syntaxe

Paramètres

Description

Ce filtre permet d'appliquer des métas-filtres sur une collection pour en extraire des informations ou transformer les données.

Remarques

• Permet une enchaînement flexible de filtres personnalisés : Le filtre metafilters autorise l'application de plusieurs filtres en une seule expression, via une chaîne structurée. Cela rend le traitement des données plus compact et modulaire, surtout lorsque les transformations sont complexes ou nombreuses.
• Utilise une syntaxe semi-structurée à respecter avec précision : La chaîne transmise au filtre doit suivre le format "filtre1,param1;filtre2,param2". Une mauvaise ponctuation, une faute dans le nom du filtre ou un paramètre manquant peut provoquer une erreur ou un résultat vide, ce qui exige une certaine rigueur syntaxique.
• Adapté aux filtres personnalisés définis dans le portail : metafilters ne fait pas appel uniquement aux filtres standards de Liquid, mais surtout aux filtres personnalisés disponibles dans les portails Dynamics 365/Power Pages. Cela le rend très puissant pour affiner les collections selon des règles spécifiques au site.
• Optimise la lisibilité du code dans les scénarios complexes : Plutôt que d'enchaîner plusieurs appels de filtres séparés avec des pipes (|), le filtre metafilters permet d'exprimer toute une séquence dans un seul bloc, ce qui améliore la clarté et la concision du code Liquid, surtout en environnement collaboratif.
• Peut être combiné avec d'autres filtres pour des effets puissants : Il est possible d'utiliser metafilters à l'intérieur de boucles ou en combinaison avec des filtres comme where, sort, ou group_by. Cela permet des scénarios avancés de filtrage et de transformation des collections de données, très utiles en environnement d'entreprise.
• Repose sur une convention de nommage stricte des filtres personnalisés : Les filtres mentionnés dans la chaîne doivent correspondre à des noms exacts reconnus par la plateforme. Il faut souvent consulter la documentation du portail ou les développeurs du projet pour savoir quels filtres sont réellement disponibles dans un contexte donné.
• Utilisable pour affiner des listes d'entités Dynamics selon des critères métier : Dans les Power Pages, metafilters est idéal pour affiner des jeux de résultats provenant d'une requête FetchXML ou d'un objet entitylist.records. Cela permet de filtrer dynamiquement selon le rôle, l'état d'un champ, la langue, ou tout autre critère de logique métier.
• Demande des tests rigoureux à cause de son caractère opaque : Contrairement aux filtres standards, le comportement de metafilters peut parfois être moins transparent, surtout s'il repose sur des filtres non documentés. Il est donc recommandé de tester chaque combinaison avec soin pour s'assurer de l'effet produit.