searchindex

Syntaxe

Paramètres

Description

Cette balise permet d'inclure l'index de recherche d'une entité pour les fonctionnalités de recherche dans le portail.

Remarques

• Permet d'exécuter une recherche pleine-textuelle sur le contenu indexé : La balise searchindex interroge l'index de recherche configuré dans Power Pages, souvent lié à Azure Search. Cela permet d'effectuer des recherches rapides et ciblées sur le contenu structuré, tel que les articles de base de connaissances ou les entités personnalisées.
• Idéale pour créer des interfaces de recherche personnalisées dans un portail : Grâce à cette balise, on peut facilement créer des interfaces utilisateur personnalisées avec des champs de recherche, des filtres, et des résultats paginés. Elle donne ainsi une alternative au composant de recherche standard, avec plus de liberté sur l'apparence et les comportements.
• Utilise un moteur d'indexation externe performant (Azure Search) : Derrière la balise searchindex se cache généralement une intégration avec Azure Cognitive Search. Cela permet de tirer parti de puissantes capacités de recherche textuelle, comme la tolérance aux fautes, les synonymes ou la pertinence, sans tout coder manuellement.
• Les résultats sont accessibles via l'objet searchindex : Une fois la requête exécutée, le moteur retourne un objet Liquid appelé aussi searchindex, qu'on peut parcourir dans une boucle {% for item in searchindex.results %} pour afficher les titres, extraits ou liens vers les enregistrements trouvés.
• La pagination est prise en charge nativement : Les paramètres page et page_size permettent d'implémenter une pagination simple. On peut par exemple afficher les 10 premiers résultats, puis construire un lien vers la page suivante en incrémentant la valeur de params.page, ce qui améliore l'expérience utilisateur.
• Le terme de recherche peut être dynamique ou statique : Le paramètre query peut contenir une chaîne fixe ('client') ou une variable Liquid (params.search). Cela permet d'utiliser un champ de recherche HTML où l'utilisateur entre des mots-clefs, ensuite transmis via l'URL ou le formulaire au moteur Liquid.
• Peut être couplée avec des filtres ou des critères personnalisés : Bien que la syntaxe de base soit simple, la balise peut être étendue à des cas d'usage avancés. On peut filtrer par type d'entité, langue, date ou autre métadonnée issue de l'index, à condition que ces champs soient bien indexés au préalable.
• Exige que l'indexation ait été correctement configurée dans Dataverse Search : Pour fonctionner, la balise dépend de l'activation de la recherche Dataverse, ainsi que de la définition d'un index de recherche dans les paramètres du portail. Si l'entité n'est pas indexée ou si l'index est désactivé, aucun résultat ne sera retourné.