host

Syntaxe

Description

Ce filtre permet d'extraire le nom d'hôte d'une URL.

Remarques

• Extraction automatique de l'hôte courant : Le filtre host permet de récupérer automatiquement le nom d'hôte de l'URL en cours, c'est-à-dire la partie principale de l'adresse web (par exemple : www.exemple.com). C'est très utile pour identifier l'origine d'une requête ou adapter dynamiquement le contenu selon le domaine.
• Utile dans les portails multi-domaines : Dans les scénarios où un même portail Dynamics 365 est déployé sur plusieurs domaines personnalisés, host permet de distinguer sur quel domaine l'utilisateur navigue. Cela peut permettre d'afficher un logo ou un contenu spécifique selon le domaine utilisé.
• Peut servir à générer des liens dynamiques : On peut utiliser le filtre host pour construire dynamiquement des URLs complètes dans les balises Liquid, en concaténant par exemple "https://" avec host et un chemin spécifique (/profil, /contact,...). Cela évite les erreurs liées au changement d'environnement (dev, test, prod).
• Ne prend pas en compte les sous-répertoires ou le chemin : Le filtre ne retourne que le nom d'hôte, excluant le protocole (http, https), les sous-répertoires, ou les paramètres de l'URL. Il se concentre uniquement sur la base du domaine (comme portal.contoso.com) ce qui le rend simple mais limité dans les traitements d'URL plus avancés.
• Permet de faire du routage conditionnel léger : Avec host, il est possible d'écrire des conditions if en Liquid adaptant le comportement du portail selon l'origine du domaine. Par exemple, afficher un message différent si l'utilisateur accède via client1.exemple.com ou client2.exemple.com.
• Fonctionne indépendamment de l'utilisateur : Contrairement à des filtres comme user ou has_role, host ne dépend pas de l'état de connexion de l'utilisateur. Il se base uniquement sur la requête HTTP, ce qui le rend toujours disponible, même pour les visiteurs anonymes.
• Peut aider au suivi ou au journal d'accès personnalisé : Dans des scénarios avancés, host peut être utilisé pour journaliser les domaines d'accès dans des composants personnalisés, utile pour du diagnostic, des tests A/B ou de l'analyse multiclient, particulièrement quand plusieurs entreprises partagent un même portail.
• S'intègre bien avec d'autres filtres ou fonctions de formatage : On peut combiner host avec des fonctions comme downcase, contains, ou des tests d'égalité pour adapter dynamiquement les contenus, la langue, ou le branding. Par exemple :
1. {% if host contains 'canada' %} Bienvenue au Canada {% endif %}