Ajout et configuration des composants WebPart Éléments recommandés et Éléments populaires dans SharePoint Server
S’APPLIQUE À :
2013
2016
2019
Subscription Edition
SharePoint in Microsoft 365
Dans l'article précédent de cette série, Change the Content Search Web Part display template and use Windows PowerShell to start Usage analytics in SharePoint Server, vous avez appris à modifier le composant WebPart Recherche de contenu pour enregistrer l'événement Actions utilisateur Affichages , et à utiliser Microsoft PowerShell pour démarrer l'analyse de l'utilisation.
Notes
Les exemples de cette série sont basés sur un déploiement SharePoint Server local.
Ajout d’un composant WebPart Éléments recommandés à une page
Accédez à la page dans laquelle ajouter le composant WebPart Éléments recommandés. Dans notre scénario Contoso, nous voulons l'ajouter à notre page d'élément de catalogue. Voici la procédure à suivre :
Sélectionnez le menu Paramètres --> Modifier la page.
Dans la zone de composants WebPart à laquelle vous voulez ajouter le composant WebPart, sélectionnez Ajouter un composant WebPart.
Dans la liste Catégories, sélectionnez Contenu basé sur la recherche.
Dans la liste Composants WebPart, sélectionnez Éléments recommandés, puis Ajouter.
Dans notre scénario Contoso, le composant WebPart Éléments recommandés sera affiché sous le composant WebPart Recherche de contenu.

À propos de la propriété gérée recommendedfor
Dans un article de blog précédent, nous vous avons parlé de la propriété gérée UsageAnalyticsId utilisée par l’analyse de l’utilisation pour spécifier comment les recommandations entre les éléments individuels doivent être calculées (voir à propos de la propriété gérée UsageAnalyticsID). Le résultat de ce calcul est envoyé à la propriété gérée recommendedfor. Le composant WebPart Éléments recommandés utilise la propriété gérée recommendedfor pour demander des recommandations. Vous n'avez pas à vous inquiéter de cette propriété gérée lorsque vous configurez le composant WebPart Éléments recommandés. Pour comprendre le fonctionnement de la requête dans lewp, il est important de garder la propriété gérée recommandée à l’esprit.
Configuration du composant WebPart Éléments recommandés
Lors de la configuration du composant WebPart Éléments recommandés, vous devez configurer celui-ci sur une page de détails d'élément où les recommandations sont générées. Souvenez-vous de l'article précédent de cette série, nous avons invité des collègues de travail à une « Pourquoi simuler la génération d'événements Actions utilisateur Affichages ? ». À cette occasion, vos collègues ont cliqué sur des éléments spécifiques afin de générer des recommandations. Dans notre scénario Contoso, ajoutez le composant WebPart Éléments recommandés à une page de détails d'élément dans laquelle les recommandations sont générées par les clics de vos collègues.
Voici les étapes de la configuration du composant WebPart Éléments recommandés :
Sélectionnez le menu Paramètres --> Modifier la page.
Dans le composant WebPart Éléments recommandés, sélectionnez Menu du composant WebPart --> Modifier le composant WebPart.

Dans le volet des outils du composant WebPart, sélectionnez Changer la requête. Une boîte de dialogue s’ouvre.
Dans la boîte de dialogue Créer votre requête, sélectionnez ce qui suit :
Dans la section Obtenir les éléments recommandés pour, sélectionnez Un jeton de l’URL, puis la valeur de l’URL à partir de laquelle vous souhaitez obtenir des recommandations. Dans notre scénario Contoso, nous souhaitons obtenir des recommandations à partir de {URL.Token.2} (numéro).
Dans la section Restreindre par application, sélectionnez Spécifier une URL, puis entrez l'URL de votre catalogue.

Peut-être pensez-vous : « OK, c'était simple, mais que cela signifie-t-il réellement ? » Cela peut être un peu difficile à comprendre. Voyons cela plus en détail.
Un jeton de l'URL signifie que nous souhaitons obtenir des recommandations pour une valeur utilisée dans l'URL.
{URL.Token.2} est une variable de requête correspondant à la deuxième valeur dans l’URL en partant de la droite. Par exemple, dans l’URL , la variable de requête http://www.contoso.com/computers/desktops/5637145799/5637146352 {URLToken.2} représente la valeur 5637145799. Souvenez-vous lorsque nous avons connecté notre site de publication au catalogue (voir Étape 5: Connecter votre site de publication à un catalogue dans SharePoint Server ), nous avons spécifié que la valeur du numéro de groupe doit être utilisée comme avant-dernière valeur dans l’URL de notre page d’élément de catalogue. Cela signifie que la variable de requête {URL.Token.2} représente la valeur Numéro de groupe. En outre, nous avons mappé Modifier le mappage de la propriété gérée UsageAnalyticsID afin que le calcul de l’analyse de l’utilisation soit basé sur le numéro de groupe.
Spécifier une URL signifie que nous voulons indiquer le site à partir duquel nous obtenons des recommandations, dans ce cas, notre site de création.
Mais à partir de ces paramètres, il n'est pas évident de savoir quelle propriété gérée est utilisée dans la requête. Ainsi, pour afficher plus d'informations à propos de la requête, sélectionnez TEST. La requête émise par le composant WebPart est affichée dans la section Texte de requête.

Si nous décomposons cela, nous obtenons les éléments suivants :
recommendedfor est la propriété gérée utilisée dans la requête.
Le signe deux-points ( : ) signifie « contient ».
5637145799 est la valeur de la variable de requête {URL.Token.2}, qui est une valeur Numéro de groupe.
path:"http://ib-perf-8/sites/catalog" correspond à l'URL de notre site de création.
(IsDocument:"True" OR contentclass:"STS_ListItem") restreint les résultats de la recherche aux documents ou aux éléments de liste.
Si nous rassemblons ces informations, voici la signification de la requête :
Dans l’URL du site de création, recherchez le document ou les éléments de liste dans lesquels la valeur de la propriété gérée recommendedfor contient la valeur actuellement utilisée comme deuxième valeur dans l’URL, de droite à gauche.
Nous savons maintenant ce que signifie la requête. Toutefois, la configuration n'est pas tout à fait terminée. Dans la section APERÇU DES RÉSULTATS DE LA RECHERCHE, nous remarquons que tous les éléments d’un groupe de produits sont affichés, par exemple tous les éléments SV Keyboard E10 (la valeur Numéro de groupe dans l’URL est identique pour tous).

Tous les éléments du groupe de produits sont affichés, car le calcul de l'analyse de l'utilisation est effectué au niveau du groupe. N’oubliez pas que, dans Modifier le modèle d’affichage de la recherche de contenu et utiliser Windows PowerShell pour démarrer l’analyse de l’utilisation dans SharePoint Server,nous avons mappé UsageAnalyticsId sur ows_ProductCatalogGroupNumber. Toutefois, nous voulons uniquement afficher un élément par groupe de produits. Heureusement, il est possible de le faire en regroupant les résultats de la recherche.
Pour regrouper les résultats de la recherche, procédez comme suit :
Sélectionnez AFFINEMENTS --> Afficher plus.

Dans le menu Regrouper par, sélectionnez Afficher toutes les propriétés.

Nous ne souhaitons afficher qu'un seul élément par groupe de produits. Par conséquent, nous sélectionnons ProductCatalogGroupNumberOWSTEXT (propriété gérée de Numéro de groupe ) et nous laissons la valeur de l'option Afficher ces résultats sur 1.

Dans APERÇU DES RÉSULTATS DE LA RECHERCHE, nous remarquons que, désormais, seul un élément par produit est affiché.

Sélectionnez OK pour enregistrer les modifications.
Dans le volet des outils du composant WebPart, saisissez le nombre d'éléments à afficher dans le composant WebPart dans le champ Nombre d'éléments à afficher.

Sélectionnez OK, puis enregistrez la page.
Même si l'aspect de la page n'est pas satisfaisant, des recommandations correctes sont maintenant affichées dans notre page d'élément de catalogue.

À propos du modèle d’affichage utilisé par le composant WebPart Éléments recommandés
Tout comme avec le composant WebPart Recherche de contenu, vous utilisez des modèles d'affichage pour contrôler la façon dont le contenu doit être affiché dans un composant WebPart Éléments recommandés. L'article Étape 11 : Télécharger et appliquer les modèles d'affichage pour le composant WebPart recherche de contenu dans SharePoint Server explique comment télécharger et appliquer des modèles d'affichage dans le composant WebPart Recherche de contenu. Vous pouvez faire de même pour le composant WebPart Éléments recommandés. Le modèle d’affichage utilisé par lewp contient un code important qui enregistre les deux événements d’utilisation : Recommendation Displayed et Recommendation Clicked.
Dans l'article Une introduction aux éléments les plus appréciés dans SharePoint Server et des recommandations, nous avons évoqué les trois événements Actions utilisateur par défaut dans SharePoint Server. Les événements Actions utilisateur Recommandations affichées et Clics en tant que recommandation sont utilisés pour enregistrer des statistiques sur la façon dont les visiteurs ont interagi avec le contenu de votre site web. Lorsqu’un élément est affiché en tant que recommandation, un événement Actions utilisateur Recommandations affichées est enregistré. Lorsqu’un visiteur clique sur un élément affiché en tant que recommandation, un événement Actions utilisateur Clics en tant que recommandation est enregistré. Dans un prochain article, nous vous montrerons comment afficher ces statistiques.
In Change the Content Search Web Part display template and use Windows PowerShell to start Usage analytics in SharePoint Server, we changed the CSWP display template to log the Views usage event. L’enregistrement des événements Actions utilisateur Recommandations affichées et Clics en tant que recommandation est effectué dans le composant WebPart Éléments recommandés. Le modèle d’affichage par défaut utilisé dans ce dernier est Item_RecommendationsClickLogging. Celui-ci comprend deux fonctions : LogRecsViewToEventStore et LogRecsClickToEventStore. Ces deux fonctions enregistrent les événements Actions utilisateur Recommandations affichées et Clics en tant que recommandation.


Lors de la modification du modèle d’affichage de votre composant WebPart Éléments recommandés, vous devez copier le fichier Item_RecommendationsClickLogging, modifier la version copiée et l’appliquer à votre composant. De cette façon, vous n'avez pas à vous soucier de la façon d'ajouter du code de la même manière que pour le composant WebPart Recherche de contenu.
Après avoir appliqué le modèle d’affichage modifié au composant WebPart Éléments recommandés, les éléments recommandés sont bien présentés.

Ajout d’un composant WebPart Éléments populaires à une page
Vous pouvez afficher les éléments les plus populaires, c’est-à-dire les plus consultés de votre catalogue en ajoutant un composant WebPart Éléments populaires à votre page de catégorie. Il est important de comprendre que lorsque vous ajoutez un élément PIWP à votre page de catalogue, celui-ci affiche automatiquement les éléments les plus vus dans chaque catégorie. Par exemple, si un visiteur consulte la catégorie Appareils photo, le composant WebPart Éléments populaires affiche les articles les plus consultés dans la catégorie Appareils photo. Si un visiteur consulte la catégorie Caméscopes, le composant WebPart Éléments populaires affiche les articles les plus consultés dans la catégorie Caméscopes.
Pour ajouter un composant WebPart Éléments populaires, accédez à la page dans laquelle vous souhaitez l'ajouter. Dans notre scénario Contoso, nous allons ajouter un composant WebPart Éléments populaires à notre page de catégorie. Procédez comme suit :
Sélectionnez le menu Paramètres --> Modifier la page.
Dans la zone de composants WebPart à laquelle vous voulez ajouter le composant WebPart, sélectionnez Ajouter un composant WebPart.
Dans la liste Catégories, sélectionnez Contenu basé sur la recherche.
Dans la liste Composants WebPart, sélectionnez Éléments populaires, puis Ajouter.
Dans notre scénario Contoso, nous allons afficher le composant WebPart Éléments populaires au-dessus du composant WebPart Recherche de contenu.

Configuration du composant WebPart Éléments populaires
Sélectionnez le menu Paramètres --> Modifier la page.
Dans le composant WebPart Éléments populaires, sélectionnez Menu du composant WebPart --> Modifier le composant WebPart.

Dans le volet des outils du composant WebPart, sélectionnez Changer la requête. Une boîte de dialogue s’ouvre.
Dans la section Restreindre par application, sélectionnez Spécifier une URL, puis saisissez l’URL de votre site de création.
Dans la section Limiter par une balise, sélectionnez Restreindre selon les termes de navigation actuels et enfants.
Aucun résultat n'est affiché dans la section APERÇU DES RÉSULTATS DE LA RECHERCHE. Que se passe-t-il ?

Pour obtenir plus d'informations sur la requête émise par le composant WebPart Éléments populaires, sélectionnez TEST. Dans l'onglet TEST, le texte de requête est affiché.

Voici la signification du texte de requête :
path:"http://ib-perf-8/sites/catalog" correspond à l'URL de notre site de création.
owstaxIdMetadataAllTagsInfo correspond à la propriété gérée utilisée dans la requête.
Le signe deux-points ( : ) signifie « contient ».
91eb9f0d-3e5a-41a8-8487-78dfe234ca7c est le GUID de la catégorie actuelle. Dans cet exemple, la catégorie actuelle est Appareils photo.
(IsDocument:"True" OR contentclass:"STS_ListItem") restreint les résultats de la recherche aux documents ou aux éléments de liste.
Si nous rassemblons ces informations, la signification de la requête est la suivante :
Dans l’URL du site de création, recherchez le document ou les listes d’éléments dans lesquels la valeur de la propriété gérée owstaxIdMetadataAllTagsInfo contient le GUID de la catégorie de navigation actuelle ou des enfants de celle-ci.
Le texte de requête contient un élément d’information important : le composant WebPart Éléments populaires utilise la propriété gérée owstaxIdMetadataAllTagsInfo dans sa requête. Vous ne pouvez pas modifier la requête dans le composant WebPart Éléments populaires de façon à utiliser une autre propriété gérée. Cela signifie que pour que la requête dans le piWP fonctionne correctement, la propriété gérée owstaxIdMetadataAllTagsInfo doit inclure la valeur de la propriété gérée que nous utilisons pour piloter la navigation gérée (pour plus d’informations, voir Stage 8: Assign a category page and a catalog item page to a term in SharePoint Server. Dans notre scénario Contoso, la propriété gérée qui dirige la navigation gérée est owstaxIdProductCatalogItemCategory. Ce que nous devons faire, c’est maquer la propriété analyse de owstaxIdProductCatalogItemCategory sur la propriété gérée owstaxIdMetadataAllTagsInfo.
L'article Change the Content Search Web Part display template and use Windows PowerShell to start Usage analytics in SharePoint Server explique comment mapper une propriété analysée sur une propriété gérée.
Important
Vous devez effectuer le mappage sur le site de création.
Dans notre scénario Contoso, la propriété owstaxIdMetadataAllTagsInfo correctement mappée se présente de la façon suivante :

Après avoir modifié le mappage de la propriété, vous devez démarrer une analyse complète, comme expliqué à l’étape 4: Configurer la recherche et activer l’analyse du contenu de votre catalogue dans SharePoint Server .
L'ordre de tri des résultats de la recherche, qui est un élément très important, n'est pas visible dans le texte de requête. Le composant WebPart Éléments populaires trie les résultats de la recherche dans un ordre décroissant sur la propriété gérée ViewsRecent. Par défaut, la propriété gérée ViewsRecent contient le nombre de vues d’un élément au cours des 14 derniers jours. Plus loin dans cette série, nous expliquerons comment modifier ce nombre, par exemple, pour les sept derniers jours. Par conséquent, la requête émise par le composant WebPart Éléments populaires effectuera les opérations suivantes :
Dans l’URL du site de création, recherchez le document ou les listes d’éléments dans lesquels la valeur de la propriété gérée owstaxIdMetadataAllTagsInfo contient le GUID de la catégorie de navigation actuelle ou des enfants de celle-ci. Triez les résultats de la recherche par ordre décroissant de vues au cours des 14 derniers jours.
Lorsque l'analyse complète est terminée, les résultats de la recherche sont affichés dans le composant WebPart.

Sélectionnez OK pour enregistrer les modifications, puis enregistrez la page.

Pour que les éléments populaires soient bien présentés, vous pouvez appliquer un modèle d'affichage, de la même manière que pour le composant WebPart Recherche de contenu. Pour plus d'informations, voir Étape 11 : Télécharger et appliquer les modèles d'affichage pour le composant WebPart recherche de contenu dans SharePoint Server.
Pour vérifier que le composant WebPart Éléments populaires fonctionne correctement, accédez à la section Appareils photo. Dans cette page, les éléments les plus consultés dans la catégorie Appareils photo sont affichés.

Lorsque nous accédons à la catégorie Caméscopes, les éléments les plus consultés de la catégorie Caméscopes sont affichés.

Notre composant WebPart Éléments populaires fonctionne correctement. C’est parfait.
Vous savez désormais comment configurer le composant WebPart Éléments recommandés et le composant WebPart Éléments populaires. Lorsque vous effectuez ces tâches, vous devez être connecté à votre propre compte.

Dans le prochain article de cette série, nous vous expliquerons le fonctionnement de ces éléments dans le cas où le site n'est consulté que par des utilisateurs anonymes, c'est-à-dire des utilisateurs qui ne sont pas connectés.