Présentation du composant

Le composant Résultat de recherche fait partie de l'ensemble de composants de la recherche Jint ! La recherche Jint vous permet de construire une expérience de recherche personnalisée pour s'adapter à vos besoins.

La présentation des fonctionnalités et des cas d'usages globaux de la recherche Jint est présentée dans l'article Centre de recherche Jint

Fonctionnalité utilisateur

Le composant résultat de recherche permet d'afficher, de naviguer et d'agir sur les objets retournés lors de la recherche, et propose énormément de paramètres pour personnaliser votre expérience.

• Affichage des résultats

Le composant affiche les résultats de la recherche de l'utilisateur dans deux dispositions.

Disposition Tableau

La disposition tableau est compacte et permet d'afficher plus de résultats. Elle n'affiche toutefois aucun visuel et convient majoritairement pour des résultats de type document, image ou page.

Disposition Tuile

La disposition tuile est plus modulaire et permet de prendre en charge une grande diversité de résultats. Vous pouvez afficher un grand nombre d'informations sur les tuiles. Elle permet aussi d'afficher des miniatures des pages, articles pour identifier plus rapidement son contenu.

Disposition Carte

La disposition carte est la plus aérée. Avec le visuel carte, vos articles, images, vidéos et présentations sont mis en avant avec l'aperçu du résultat. L'aperçu permet d'identifier, en un coup d'oeil, l'image qui vous convient pour une présentation ou de retrouver visuellement le document dont vous avez besoin.

• Verticaux de recherche

Les verticaux sont des onglets permettant de filtrer les résultats sur un type de fichier, une source ou une propriété. L'utilisateur peut utiliser des verticaux de recherche pour naviguer et filtrer parmi les résultats pour arriver plus rapidement à son résultat.

• Actions utilisateur

L'utilisateur peut consulter chaque résultat, et dispose d'actions personnalisées pour chaque objet : partage, copie du lien, téléchargement, ouverture dans l'application Office de bureau

• Fonctionnalité contributeurs

En tant que contributeur, vous pouvez paramétrer l'expérience de recherche que vous proposez aux utilisateurs :

• le périmètre de recherche

• le rendu visuel

• les verticaux de recherche

Prérequis pour le composant

Le composant résultat de recherche nécessite des permissions déléguées étendues pour pouvoir fonctionner. Il utilise les permissions suivantes :

• Sites.Read.All

Pour approuver les demandes de permission, veuillez vous référer à l'article suivant : Approbation des permissions. Si le composant ne retourne aucun résultat, c'est probablement que les permissions n'ont pas été accordées à l'installation.

Ajouter le composant

1. Ouvrez le mode édition de la page SharePoint en cliquant sur modifier en haut à droite de la page,

2. À l'emplacement désiré, sélectionnez le bouton + pour ouvrir le catalogue de composant,

3. Recherchez ou déroulez le catalogue pour sélectionner le composant "barre de recherche" dans la catégorie "Documents, Listes et bibliothèques",

4. Le composant est rajouté à l'emplacement désiré.

Paramétrage du composant

Il existe 5 catégories de paramètres disponibles pour le composant :

1. Agencement

2. Connexion du composant

3. Configurer la recherche

4. Affichage des résultats

5. Option d'affichage

Agencement

Dans la section Agencement, vous pouvez choisir :

• La disposition de votre choix

Vous pouvez choisir entre les deux dispositions Cartes, Tuiles et Tableau présentées dans la section ci-dessus. Il s'agit de la disposition affichée par défaut au chargement de la page, que l'utilisateur peut modifier.
De plus, il est possible d'enlever la possibilité à l'utilisateur de changer les résultats, afin d'uniformiser l'expérience.

Connexion du composant

Le composant Résultat de recherche fonctionne avec les autres composants de recherche.

La connexion est automatiquement réalisée si un seul composant "Barre de recherche" et "Filtre de recherche" existe sur la page. Dans le cas contraire, il suffit de sélectionner le composant à l'aide de la liste déroulante.

L'ID de chaque composant est affiché afin de pouvoir l'identifier plus simplement. Cela est particulièrement utile si vous avez plusieurs composants identiques sur la même page.

Configurer la recherche

La configuration de recherche permet de définir le périmètre de votre recherche.

• Source des résultats

La recherche Jint est aujourd'hui réalisée dans SharePoint et One Drive. Il est possible de préciser le périmètre au sein de SharePoint et d'inclure ou non les résultats provenant de One Drive.

Vous avez le choix entre :

• Tous les sites : les résultats affichés proviennent de l'ensemble des sites auxquels il a accès.

• Une liste de sites : les résultats affichés proviennent des sites sélectionnés auxquels l'utilisateur a accès. Attention, cela ne permet pas d'afficher des données provenant d'un site auquel l'utilisateur n'a pas accès.

• Ce site : affiche uniquement les résultats disponibles sur le site courant.

• Filtrer sur les types de résultats

Nous vous proposons des filtres afin de remonter seulement certains types de contenus dans la recherche. Cela dépend du type de résultats choisi.

Par défaut, tous les contenus remontent si aucun filtre de type de résultat n'est sélectionné.

Nous vous proposons une multitude de catégories pré-paramétrées et facilement utilisables. Le filtre image, par exemple, regroupe un très large panel des formats d'images utilisés.

Il est possible de rajouter les extensions personnalisées pour cibler les fichiers/documents que vous voulez cibler dans la recherche.

Les types de résultats Pages, Actualités, Sites, Événements, Bibliothèques et Dossiers correspondent aux objets SharePoint.

• Filtrer sur les termes

Vous pouvez filtrer votre recherche en fonction des termes que vous affectez à votre contenu SharePoint

Consultez la documentation SharePoint : Présentation des métadonnées gérées

Pour cela, vous définissez une ou plusieurs sélections de termes.

Le contenu remonté sera celui contenant au moins un terme de chaque sélection. La recherche s'effectue de la manière suivante :

(possède un des termes de la sélection 1) ET (possède un des termes de la sélection 2) ET ....

Pour ajouter une sélection de termes, il faut cliquer sur le bouton "Ajouter un terme".  n nouveau panneau s'affiche alors pour sélectionner les termes souhaités :

Une fois les termes sélectionnés, il vous suffit de cliquer sur le bouton "Enregistrer" pour valider votre sélection. Il est possible d'ajouter d'autres sélections, de modifier une sélection ou d'en supprimer une :

Dans l'exemple ci-dessus, le filtre réalisé sur les articles fera remonter les articles auxquels nous avons associé l'un des termes "Evenement", "Release", "RH" de l'ensemble de termes "Theme", ET l'un des termes "Executive Management" et "Marketing" de l'ensemble de termes "Department"

• Filtrer sur les propriétés SharePoint

Le filtre sur les propriétés vous permet de définir les critères des propriétés SharePoint afin de limiter le périmètre de recherche disponible.

Vous définissez un filtre avec les éléments suivants :

• La propriété SharePoint sur laquelle le filtre doit être réalisé
• Le type de donnée du filtre : Date, nombre, booléen, texte
• Le type de filtre
• La ou les valeurs que vous souhaitez renseigner sur ces filtres

• Requête personnalisée

Enfin, vous pouvez définir vous-même la requête KQL utilisée pour filtrer la recherche.

 

Attention, la requête KQL est ajoutée à l'ensemble des filtres définis dans cette section. Aucune validation de la requête KQL n'est faite a priori.

Consultez la documentation Microsoft sur les requêtes KQL

La requête personnalisée vous permet d'aller plus loin que ce que nous vous proposons en no-code via nos options de paramétrages en appelant directement les API de Microsoft Search.

Affichage des résultats

• Verticaux de recherche

Les verticaux sont des onglets permettant de filtrer les résultats sur un type de fichier, une source ou une propriété. L'utilisateur peut utiliser des verticaux de recherche pour naviguer et filtrer parmi les résultats pour arriver plus rapidement à son résultat. Il peut ainsi choisir de visualiser uniquement les documents, les pages, les images etc.

Vous pouvez personnaliser les verticaux de recherche que vous proposez à vos utilisateurs via ce menu, afin que les options soient personnalisées et adaptées au contexte.

Nous vous proposons 13 verticaux déjà préconfigurés que vous pouvez activer/désactiver en un seul clic. Il vous est par la suite possible de définir vos propres verticaux personnalisés afin de créer des filtres métiers complexes et contextualisés en faisant appel aux termes, aux propriétés du document et aux filtres de date relative.

Exemple de verticaux personnalisés :

• Procédure RH : Liste des documents identifiés avec les métadonnées "Procédure" et "RH" et le statut du document "Validée"
• Document récemment mis à jour : Documents dont la modification date d'il y a moins d'un mois

Option d'affichage

• Affichage des propriétés

Le bouton "Configurer les propriétés" permet d'ouvrir le panel de personnalisation des propriétés affichées.
Les propriétés configurées sont propres à chaque disposition, cela vous permet de personnaliser pleinement les informations que chaque disposition doit afficher.
Exemple : Vous pouvez afficher les tags de vos éléments, uniquement pour la disposition "Cartes".

A l'ouverture du panel, les propriétés paramétrées pour la disposition sélectionnée actuellement s'affichent. Vous pouvez réordonner librement les propriétés en faisant un glisser-déposer à partir de l'icône située sur la gauche des éléments.
Pour la disposition "Cartes" spécifiquement, un menu déroulant s'affiche et permet de modifier le ratio de l'image de chaque élément.

Le bouton "+"  en haut à droite du tableau permet d'ajouter une propriété à afficher. Vous avez la possibilité de choisir parmi une sélection de propriétés pré-paramétrées, ou de l'ajouter vous-même.

Le formulaire d'ajout d'une propriété est composé des champs suivants :

 Nom : Le nom d'affichage de votre propriété. Il s'agit du nom qui sera affiché dans votre composant, ainsi que dans le paramétrage.

Propriété gérée : Le nom de la propriété gérée dans le schéma de recherche SharePoint. Des suggestions de propriétés s'affichent lorsque vous commencez à écrire dans ce champ.
À noter pour les suggestions, seules les propriétés alimentées au moins une fois sont visibles. 
Par exemple, si vous avez une propriété "Couleur", mais qu'aucun élément n'a de valeur pour cette propriété, vous ne verrez pas la propriété "Couleur" dans les suggestions.

Type : Définit sous quel format la donnée va être affichée dans votre composant. Les formats ne sont pas tous compatibles avec toutes les propriétés (ex: le type "Personne" n'est compatible qu'avec les propriétés gérées retournant un utilisateur).

• Comportement en mode mobile

L'option "Masquer sur mobile" permet de cacher ou non le composant en mode mobile.

• Arrondis

Vous avez la possibilité de choisir la forme des bordures des éléments de votre composant. Cette option concerne les bordures des cartes de la vue du même nom, mais également les bborduresdes boutons d'action.

• Ombre

Vous avez la possibilité de définir l'ombre du composant