Introduction
La webpart recherche de contenu est une webpart de Powell 365, communément appelée "Search" (Recherche).
Elle peut être trouvée sur différentes pages de l'intranet et présente de nombreuses formes et fonctionnalités. Par exemple, les quatre webparts illustrées dans l'exemple ci-dessous sont toutes des Content Searches (Recherches de contenu).
La webpart Search est un moyen pratique de personnaliser et de contrôler ce que vous souhaitez afficher dans votre intranet, avec autant de possibilités que d'éléments et d'affichages disponibles.
Avec cette webpart, vous pouvez afficher divers éléments tels que des événements, des actualités, des pages, des documents, des personnes ou des composants basés sur un type de contenu spécifique.
Quatre exemples d'utilisation de la webpart Search sur la page d'accueil orientée Utilisateurs et Communication
Paramètres
Mode d'édition de la Content Search
Nous expliquerons ci-dessous comment configurer chaque section:
Query Builder / Créateur de requête
La section de configuration du Query Builder est l'endroit où vous indiquerez le type d'éléments que vous souhaitez afficher dans votre webpart.
Recherche en mode édition de la webpart Search, section Query Builder
Requête de recherche
Dans le champ de requête de recherche, vous devez spécifier la requête qui récupérera les éléments que vous souhaitez afficher.
À partir de là, vous pouvez :
- Décider d'afficher des personnes : si la case à cocher "Rechercher les personnes" est sélectionnée, votre requête ne montrera que des personnes ; si elle n'est pas cochée, aucune personne ne sera affichée.
- Filtrer par extension de fichier : pour récupérer un type spécifique d'élément.
Pour cela, il vous suffit d'écrire "fileextension:" suivi de l'extension de l'élément que vous souhaitez afficher dans le champ. (Par exemple : FileExtension:aspx, FileExtension:docx, FileExtension:xlsx, FileExtension:pdf, …)
- Filtrer par type d'élément : pour afficher certains éléments ; cela peut être des listes, des personnes, des actualités, des sites...
Pour filtrer les éléments, vous devez écrire "content class:" suivi du code de classe de contenu des éléments que vous souhaitez filtrer. La requête peut être composée de plusieurs classes de contenu en utilisant le connecteur "OR". (Par exemple, pour filtrer les personnes : contentClass=urn:content-class:SPSPeople, pour filtrer les listes ou les bibliothèques de documents : (contentclass:STS_List OR contentclass:STS_List_DocumentLibrary), …)
- Filtrer par type de contenu : afficher uniquement les éléments basés sur leur type de contenu.
Pour filtrer sur un type de contenu spécifique, vous devez écrire "ContentTypeId:" suivi de l'ID du type de contenu que vous souhaitez afficher. Si vous souhaitez l'inclure, laissez la requête telle quelle.
Au contraire, si vous souhaitez l'exclure, il vous suffit d'ajouter un signe moins devant la requête. (Par exemple, pour inclure le type de contenu "Site Page" : ContentTypeId:0x0101009D1CB255DA76424F860D91F20E6C4118*, pour l'exclure : -ContentTypeId:0x0101009D1CB255DA76424F860D91F20E6C4118*)
- Filtrer par chemin spécifique : vous pouvez spécifier un chemin spécifique pour récupérer les éléments qui s'y trouvent.
Comme indiqué dans le premier exemple ci-dessus, vous devez préciser que vous allez utiliser un chemin en ajoutant "Path:" devant le chemin que vous choisirez, puis en spécifiant votre chemin. (Par exemple, pour filtrer sur ce site : Path:{Site.URL}, sur cette collection : Path:{SiteCollection.URL}, sur un chemin personnalisé : Path:"custom" …)
- Veuillez saisir un mot-clé qui sélectionnera tous les éléments qui le contiennent. (Par exemple, Powell, Décembre, rh, …)
Nombre d'éléments ignorés et nombre maximal de résultats
- Pour ignorer un certain nombre de résultats que vous obtiendrez à partir de votre requête, vous pouvez définir ce nombre dans le champ "Nombre d'éléments ignorés". (Par exemple, si vous décidez d'ignorer deux éléments, les deux premiers résultats seront contournés)
- Pour définir le nombre d'éléments que vous obtiendrez en tant que résultat de votre requête, vous devez indiquer le nombre maximal d'éléments que vous souhaitez dans le champ "Nombre maximal de résultats".
Cases à cocher de configuration des règles
Que vous cochiez ou non les cases à cocher suivantes, vous pouvez activer certains comportements pour les résultats de la requête. Vous pouvez décider de :
- Supprimer les doublons : définit une valeur booléenne qui spécifie si les éléments en double doivent être supprimés des résultats de recherche.
- Utiliser des règles de requête : consultez ici comment gérer les règles de requête sur votre portail https://docs.microsoft.com/fr-fr/sharepoint/manage-query-rules.
- Désactiver l'utilisation des chaînes de requête
- Activer le ciblage d'audience
Paramètres de tri
Vous pouvez décider de trier vos résultats de requête :
- Par propriétés personnalisées : vous aurez un tableau où vous pourrez gérer vos propriétés de tri en les ajoutant ou en les supprimant (bouton "Ajouter un tri" en bas du tableau et icône de corbeille à droite de chaque élément dans le tableau). Veuillez spécifier une propriété gérée qui est triable ; vous pouvez décider de trier chaque propriété par ordre croissant ou décroissant.
- Par pertinence.
- Ou par une propriété aléatoire, de sorte que vos résultats de requête seront "aléatoires".
Test
Et enfin, pour cette section (disponible uniquement sur votre portail final), vous pouvez simuler le rendu de votre requête et vérifier si les éléments qui seront affichés dans votre webpart sont cohérents et ceux que vous souhaitiez. Pour ce faire, il vous suffit de cliquer sur le bouton "Tester" pour afficher les résultats de la requête.
Display / Affichage
La section d'affichage est l'endroit où vous allez sélectionner comment afficher vos éléments dans votre webpart. Powell 365 propose de nombreux modèles pour vous permettre de personnaliser au mieux votre expérience.
Classe CSS du conteneur
Vous pouvez ajouter une classe CSS personnalisée pour le conteneur dans ce champ. Cela vous permet de personnaliser votre intranet selon vos souhaits.
Vous pouvez vous référer à notre guide de conception, où vous trouverez notre classe CSS personnalisée pour notre composant de conteneur à l'adresse suivante : https://jolly-forest-0d90fee03.azurestaticapps.net/docs/utilities/media-container.html.
Template
Les modèles disponibles dans la liste déroulante sont significatifs.
Ils sont organisés pour donner une idée à l'utilisateur de l'objectif du modèle, de la présentation pour laquelle il a été conçu et des cas d'utilisation pour lesquels chaque modèle convient le mieux. (Par exemple, Liste d'événements, Slider d'actualités, Tuiles de personnes, ...)
Notez que des options supplémentaires peuvent être activées ou configurées en fonction du widget sélectionné. Par exemple, le défilement automatique pour nos vues en mode diaporama, la lecture automatique pour notre vue avec des vidéos, ou encore le partage sur les réseaux sociaux...
Affichage des likes
Activez cette option pour afficher la fonctionnalité "likes" et le nombre de likes sur le contenu (disponible uniquement pour les modèles de vue compatibles).
Affichage des commentaires
Activez cette option pour afficher la fonctionnalité de commentaires (disponible uniquement pour les modèles de vue compatibles).
Affichage des vues
Activez cette option pour afficher le nombre de vues sur le contenu.
Gestion des éléments lus (fonctionnalités must-read)
Consultez la documentation sur les éléments must-read pour plus d'informations sur ces fonctionnalités.
Pour gérer ces fonctionnalités, un site de gamification doit être lié au site affichant la webpart Search.
Enregistrer les éléments lus : Mémorise le contenu lu par un utilisateur dans cette webpart de recherche (le contenu doit être ouvert).
Masquer les éléments lus : Si l'option "Enregistrer les éléments lus" est activée, cette fonctionnalité masquera tout le contenu lu par l'utilisateur dans les résultats de cette webpart de recherche.
Action de gamification : Définissez l'action de gamification qui sera déclenchée lorsque l'utilisateur lit le contenu de cette webpart de recherche.
Afficher le nombre de lecteurs : Affiche une liste de tous les utilisateurs qui ont lu un élément de contenu.
Autoriser l'utilisateur à définir du contenu favori
Permettez aux utilisateurs de définir du contenu en tant que favori directement depuis l'affichage de la webpart Search (uniquement pour les modèles de vue compatibles).
Afficher uniquement le contenu favori de l'utilisateur
Filtrez les résultats de la webpart Search pour afficher uniquement le contenu défini comme favori par un utilisateur.
Défilement automatique et lecture automatique
Veuillez noter que cette option n'est disponible que pour une vue spécifique du widget, avec un diaporama. Si vous souhaitez consulter nos affichages pour cette webpart et voir par vous-même lesquels ont un diaporama ou non, vous pouvez consulter notre page d'affichage de la webpart Content Search.
Si vous décidez d'activer le défilement automatique en le cochant, un champ de vitesse de lecture automatique apparaîtra, où vous devrez entrer la vitesse de la lecture automatique.
Configuration des appareils
Pour chaque appareil, vous pouvez personnaliser l'affichage de vos éléments et rendre l'affichage plus pertinent pour chaque appareil. Vous pouvez sélectionner combien d'éléments vous souhaitez par ligne et (si le modèle le permet) la hauteur sur chaque appareil.
Mapping
La section de mappage est dynamique en fonction de la vue ; vous pouvez lier une propriété raffinable affichée ou utilisée par la webpart.
Miscellaneous / Divers
La section "Divers" est l'endroit où vous allez définir les différents comportements de votre webpart.
Chaque section va être expliquée ci-dessous :
Option "Voir plus"
Vous pouvez activer l'option "Voir plus" pour définir un bouton "Voir plus". Vous pouvez personnaliser le libellé "Voir plus" et ajouter un libellé de votre choix. Ajoutez des langues alternatives si vous souhaitez traduire votre libellé. Vous pouvez également indiquer une URL dans le champ "URL du bouton Voir plus" si vous souhaitez rediriger les utilisateurs vers une page spécifique. Vous pouvez sélectionner un site ou en définir un personnalisé dans la liste déroulante en remplissant le champ.
Mode d'édition de la webpart Search, section Divers : option "Voir plus"
Activer le cache
Dans cette section, vous pouvez décider d'"activer le cache" et définir la durée du cache.
Mode d'édition de la webpart Search, section Divers : option "Activer le cache"
Désactiver l'intégration de Yammer
Ici, vous pouvez simplement décider si vous souhaitez intégrer Yammer ou non dans votre webpart.
En cas d'absence de résultats
Vous pouvez définir le comportement de la webpart si la requête ne renvoie "aucun résultat", soit en sélectionnant l'affichage d'un "widget vide", en le "masquant" ou en "affichant un message personnalisé" dans ce cas (qui peut être traduit dans différentes langues).
Mode d'édition de la webpart Search, section Divers : configuration en cas d'absence de résultats..
Activer les préférences utilisateur
Si vous décidez d'activer les préférences utilisateur, vous permettrez à tous les utilisateurs de définir certains filtres pour le contenu affiché dans la webpart. Dans le mode d'affichage de la webpart, un nouvel élément (voir le cadre rouge dans la capture d'écran ci-dessous) sera disponible pour leur permettre de définir leurs préférences.
Une fois qu'ils cliquent dessus, une fenêtre pop-up apparaîtra dans laquelle ils auront la possibilité de gérer leurs filtres.
Pour configurer cette option, vous devrez cocher la case "Activer les préférences utilisateur" et, une fois que vous l'avez fait, les champs de configuration apparaîtront en dessous. Pour créer un nouveau filtre, vous devrez cliquer sur le bouton "Ajouter un filtre", puis vous pourrez configurer toutes les propriétés de votre filtre. Tout d'abord, vous pourrez entrer le "Nom de la propriété mappée" et la supprimer ou en créer d'autres.
Si vous souhaitez gérer plus en détail la configuration de votre filtre, vous devrez cliquer sur le bouton d'outils en haut à droite de votre filtre, et d'autres options de configuration apparaîtront.
Mode d'édition de la webpart Search, section Mapping : ajouter des préférences utilisateur
Après avoir fait cela, vous pourrez configurer toutes les propriétés de votre filtre :
- Vous devez ajouter un "Nom de propriété mappée", qui est le nom de votre filtre,
- Vous pourrez définir le "Nombre maximal de filtres",
- Vous pourrez également définir le "Nombre de filtres à afficher",
- Vous pourrez également "Ajouter une langue" en sélectionnant votre langue dans le menu déroulant et en ajoutant sa valeur dans le champ correspondant,
- Vous pourrez choisir le "Nom d'affichage (par défaut)" de votre propriété ; c'est le nom qui sera affiché par défaut dans la liste des utilisateurs (si vous n'avez pas ajouté d'autres langues),
- Et vous pourrez "Définir des valeurs par défaut en entrant le nom d'une propriété de profil utilisateur".
Aperçu / Preview
Cette section vous permet d'obtenir un aperçu de votre webpart. Avant même de l'enregistrer, vous pouvez vérifier à quoi elle ressemblera à n'importe quel moment de votre configuration. Vous devez cliquer sur le bouton "Aperçu", et son contenu sera mis à jour avec votre configuration.
Mode d'édition de la webpart Search, section Aperçu
Rechercher du contenu provenant d'un autre tenant
Mode d'édition de la webpart Search, générateur de requêtes avec l'option "External" cochée
Depuis le panneau du Query Builder / créateur de requêtes, vous pouvez choisir d'afficher du contenu provenant d'un autre tenant.
Pour cette fonctionnalité, les prérequis sont les suivants :
- L'autorisation "user_impersonation" doit être approuvée pour l'application Graph API.
- Les utilisateurs doivent avoir accès au site racine du tenant et à la collection de sites sélectionnée.
La configuration est simple, vous devez définir :
- Le tenant à partir duquel vous souhaitez récupérer les données.
- L'URL de la collection de sites dans ce locataire précédent où les données sont stockées.
- La construction de la requête de recherche comme une requête de recherche normale (voir le chapitre dédié dans cette documentation).
Toutes les autres configurations sont les mêmes que pour l'obtention de contenu à partir du tenant actuel.