00% 30% 70% 1 Logo Logo

Magazine

PnP Modern Search v4, le moderne qui retourne à ses classiques

octobre 1, 2024

Microsoft 365

Vous souvenez-vous de la recherche SharePoint ?

Depuis que SharePoint existe, nous avons toujours rencontré la nécessité d’aller récupérer des informations dans cette grande marée de données indexées que nous pouvons fournir SharePoint.

Souvenez-vous de nos très chères  Content Search Web Parts  et autres  Refiner Web Parts  que nous aimions personnaliser à coup de script HTML, CSS et JavaScript afin de représenter nos résultats de recherche, exactement comme nous l’avions imaginés ! Et bien Microsoft, préférant promouvoir sa recherche M365 globale, n’a jamais donné de ticket à ces  Web Parts  pour accéder au monde moderne.

Avec l’apparition de l’expérience moderne et des  Web Parts  conçus à l’aide de SharePoint Framework (SPFx), nos classiques et dépassées  Web Parts  ont dès lors été remplacés par la  Highlighted Content Web Part  qui, par défaut de nous permettre d ‘exprimer notre créativité, permet un déploiement et une diffusion rapide de nos informations.

La perte d’intérêt de la part de Microsoft vis-à-vis du moteur de recherche de SharePoint dans sa version moderne a engendrée l’arrivée de la nouvelle API de recherche globale, puissante mais rigide et non personnalisable. Les années ont passé sans qu’aucune alternative ne soit proposée et qu’aucun de nos scénarios complexes ne puisse plus réellement être formulé tel que nous les voudrions.

Et si notre salut devait passer par la forte communauté de Microsoft ?

Et la PnP Modern Search dans tout ça ?

PnP Modern Search v4 est une solution utilisée par la communauté open source qui permet aux utilisateurs M365 de déployer une solution low-code procurant une expérience de recherche personnalisée. Elle peut aussi bien être basée sur le moteur de recherche de SharePoint que sur Graph et est disponible en quelques minutes et quelques clics !

La première version a été créée par l’équipe PnP en 2019 et a profité de plusieurs améliorations jusqu’à arriver en décembre 2020 à la version 4 permettant de se connecter à la fois au moteur de recherche de SharePoint et à l’API Microsoft Search .

Un des points majeurs de la PnP Modern Search v4 est que celle-ci possède une installation simple et directe avec une documentation riche et complète sur son déployé et son utilisation. Son déployé, contenant un package SPFx standard, rendra disponible instantanément (sur SharePoint, Teams, etc.…) les différents Web Parts qui la composent et pourront répondre à différents scénarios tels que :

  • Regrouper des données, provenant de différentes sources du locataire, qui ont été taguées d’une manière bien précise ;
  • Afficher des éléments d’une liste SP sous différentes formes (Cards, People cards, liste basique…) ;
  • Proposer une boîte de recherche, un affichage conditionnel des résultats ou bien encore permettre l’affinement de ces mêmes résultats.

Les 4 principaux composants WebPart

1. Qu’est-ce que le composant WebPart Résultat de recherche ?

Il s’agit de la Web Part principale, du centre névralgique de la solution qui permet de connecter les différentes Web Part entre elles.

Son objectif premier est de récupérer des informations provenant d’une source de données et les restituer sous la forme d’un affichage spécifique.

  • Les données d’entrées peuvent soit provenir d’une requête statique soit d’une requête dynamique. Dans le cas de la requête statique, il est possible d’afficher un résultat identique à chaque visite de la page tandis que dans le cas de la requête dynamique, il est possible de récupérer les différentes interactions de l’utilisateur avec le système, et notamment à travers la Search Box Web Part.
  • Les données de sorties peuvent être restituées soit à l’aide de 5/6 modèles préconfigurés qu’il est possible d’adapter légèrement soit en créant son propre modèle personnalisé à l’aide des « Handlebars ». Si ce n’est pas suffisant, il est toujours possible de créer une extension mais dans ce cas des compétences en développement web seront nécessaires.

2. Qu’est-ce que la Search Box Web Part ?

Il s’agit de la barre de recherche qui est la principale source d’interaction avec le moteur de recherche. Elle est connectée à la Web Part de résultat et permet de transmettre les mots-clés que nous recherchons.

Elle possède également une fonctionnalité bien utile qui lui permet de transmettre une requête à travers l’URL. Cela permet d’imaginer des cas d’utilisation avancés où la barre de recherche ne se trouve pas forcément sur la même page SP que la Web Part de résultat.

3. Qu’est-ce que la Search Filters Web Part ?

Ce WebPart permet de filtrer les informations remontées par le WebPart de résultat. Elle est configurable et propose de multiples formats de filtre. Ceci lui permet en finalité d’affiner les résultats de la recherche et de trouver exactement ce que vous recherchez.

4. Qu’est-ce que le composant WebPart Recherche verticale ?

Le composant WebPart vertical de recherche permet d’afficher conditionnellement différents composants WebPart des résultats de recherche. Elle permet de construire un centre de recherche complet basé sur une multitude de résultats de recherche, chacun s’affichant lorsqu’il est demandé. Elle définit précisément un cadre au centre de recherche et une portée spécifique à chaque résultat.

Et sinon, comment je démarre avec ça ?

  1. Téléchargez la dernière version de la solution ;
  2. Toutes les informations peuvent être trouvées dans la documentation du référentiel ;
  3. Si vous rencontrez le moindre problème, vous pouvez utiliser le canal GitHub du référentiel ;
  4. Une fois déployée dans le catalogue d’applications de votre locataire, vous aurez accès, sur n’importe quel site de votre locataire, aux 4 Web Parts à partir de la boîte à outil des Web Parts SharePoint ;
  5. Et si vous êtes plus curieux, nous vous proposons plus d’informations dans la suite de ce dossier (à venir) .

Pour conclure, si l’objectif est de diffuser et promouvoir de l’information sur votre site SharePoint de manière personnalisée, la PnP Modern Search v4 est la solution combinant une déploiement simple et rapide, une prise en main intuitive, une personnalisation accessible et efficace ainsi qu’une extensibilité, autant que faire se peut, avec quelques notions de technologies web modernes.

Auteur : Laurent Freyss – Consultant Microsoft 365

Texture

Construisons ensemble l'avenir de votre organisation