entityview

Syntaxe

Paramètres

Description

Cette balise permet de récupérer une vue d'entité spécifique pouvant être utilisée pour des traitements personnalisés.

Remarques

• Permet de récupérer des jeux de données prédéfinis dans Dynamics 365 : La balise entityview facilite l'accès à une vue système ou personnalisée déjà configurée dans Dataverse. Cela permet de manipuler ou d'afficher des ensembles d'enregistrements selon des critères prédéfinis, sans avoir à écrire manuellement de requête FetchXML.
• Fonctionne comme une requête réutilisable pour les développeurs : Plutôt que de construire chaque requête dans le code Liquid ou d'utiliser {% fetchxml %}, cette balise permet de récupérer les résultats directement via une vue existante. Cela allège le développement et garantit que les mêmes critères métiers sont réutilisés.
• Utilisable pour des affichages personnalisés dans les pages du portail : Une fois la vue récupérée dans une variable Liquid, il est possible de parcourir les enregistrements avec une boucle {% for ... %} et de créer un affichage HTML totalement personnalisé (tableau, carte, liste,...). Cela donne une grande flexibilité dans le rendu.
• Nécessite une configuration préalable dans l'environnement Dynamics : La vue doit déjà être définie dans l'entité concernée dans le modèle de données. Le nom de la vue utilisé dans la balise doit correspondre exactement (respect de la casse), et la vue doit être activée pour l'utilisation dans le portail si nécessaire.
• Respecte les filtres et tris définis dans la vue Dynamics 365 : Les résultats retournés par la balise entityview incluent les filtres (conditions WHERE), les colonnes (champs sélectionnés) et l'ordre de tri tel que défini dans la vue. Cela garantit que les données présentées ou traitées sont alignées sur les exigences métiers.
• Peut être combinée avec des conditions supplémentaires dans Liquid : Même si la vue impose une sélection initiale, il est possible de filtrer davantage les résultats via des instructions Liquid comme {% if %}, {% unless %} ou en manipulant les objets avec des filtres tels que where, sort,..., selon les besoins du scénario.
• Utile dans les scénarios de reporting ou de filtrage dynamique : Cette balise est idéale pour afficher des listes de données filtrées selon des règles métier (exemple : commandes ouvertes, incidents résolus, rendez-vous à venir), tout en conservant la logique centralisée dans Dynamics. Elle assure ainsi une séparation claire entre logique et présentation.
• Offre un bon équilibre entre simplicité et puissance : Elle se positionne entre l'usage de fetchxml (plus complexe mais plus flexible) et celui de entitylist (plus simple mais moins personnalisable). entityview est parfaite pour les développeurs souhaitant du contrôle sur le rendu tout en s'appuyant sur des définitions existantes.