Étape 10 : Configurez la requête dans un composant WebPart recherche de contenu sur une page d'articles de catalogue dans SharePoint Server
S’APPLIQUE À :
2013
2016
2019
Subscription Edition
SharePoint in Microsoft 365
Notes
De nombreuses fonctionnalités décrites dans cette série sont également disponibles pour la plupart des sites SharePoint dans Microsoft 365.
Aperçu rapide
Étape 9 : Configuration de la requête dans un partie Web De recherche de contenu sur une page de catégorie dans SharePoint Server a expliqué comment ajouter un élément Web Part de recherche de contenu à une page et comment configurer la requête pour une page de catalogue. L’étape suivante consiste à faire de même pour la page d’élément de catalogue.
Voici les titres des sections de cet article :
Définition du mode d’affichage des éléments de catalogue sur notre site Contoso
Procédure d’ajout d’un composant WebPart Recherche de contenu à une page d’élément de catalogue
Démarrer l’étape 10
Définition du mode d’affichage des éléments de catalogue sur notre site Contoso
Les divers produits présentés dans le catalogue Contoso sont disponibles en différentes couleurs. Par exemple, en regardant dans notre liste de catalogues, vous verrez que la radio de voiture Northwind Traders 50W est disponible en cinq couleurs. Les versions de couleurs d’un produit sont regroupées sous un numéro de groupe commun.

Lors de l’affichage d’un produit sur notre site Contoso, les visiteurs doivent voir facilement que le produit est disponible dans d’autres couleurs. Par exemple, lorsque les visiteurs naviguent vers une version couleur argentée de la radio de voiture Northwind Traders 50W, ils doivent facilement voir quelles autres options de couleur sont disponibles pour cet élément. Ils doivent également pouvoir consulter rapidement les détails du produit dans une autre couleur, sans avoir à revenir à la page de catégorie.
Ainsi, sur notre page d’élément de catalogue, nous voulons afficher les éléments qui ont le même numéro de groupe. Pour ce faire, nous devons utiliser le composant WebPart Recherche de contenu.
Notes
La page de détails d’élément qui a été créée automatiquement lorsque nous avons connecté notre site de publication à notre catalogue, comme décrit à l’étape 5 : Connecter votre site de publication dans un catalogue dans SharePoint Server contenait plusieurs composants WebPart de réutilisation d’élément de catalogue (CIRWP). Dans certains scénarios, l’utilisation de composants WebPart Réutilisation d’un élément de catalogue pour afficher le contenu détaillé de l’élément peut se révéler appropriée. Toutefois, dans la mesure où le composant WebPart Réutilisation d’un élément de catalogue peut uniquement afficher un élément à la fois, nous ne pouvons pas utiliser ce composant WebPart pour notre scénario Contoso.
Pour plus d’informations sur la personnalisation de la page d’élément de catalogue créée automatiquement à l’aide de CIRWPs, voir How to: Customize page layouts for a catalog-based site in SharePoint 2013.
Procédure d’ajout d’un composant WebPart Recherche de contenu à une page d’élément de catalogue
Accédez à la page d’élément de catalogue. Dans notre scénario, cliquez sur l’élément « Autoradio Northwind Traders 50W » dans la catégorie « Audio ».

Étant donné que nous n’avons pas ajouté de composants WebPart à la page lors de sa création à l’étape 7 : Télécharger mises en page et création de pages dans un site de publication dans SharePoint Server,cette page n’affiche aucun contenu.
Notre page d’élément de catalogue ne comprend qu’une zone de composant WebPart. Pour ajouter un CSWP à notre page d’élément de catalogue, répétez les étapes de la procédure d’ajout d’un élément Web Part de recherche de contenu à une page et ajoutez-le à la zone 1.

Comme lors de l’ajout d’un composant WebPart Recherche de contenu à notre page de catégorie, le composant WebPart affiche du contenu (Audio, Appareils photo et Ordinateurs), mais pas celui que nous voulons. Pour que le composant WebPart affiche le contenu du catalogue Contoso, nous devons configurer la requête dans le composant WebPart. Pour configurer la requête, nous allons utiliser ce qu’on appelle une variable de requête. Mais tout d’abord, examinons les variables de requête et la façon dont elles sont utilisées lorsque vous configurez une requête.
À propos des variables de requête
Une variable de requête est un espace réservé qui est remplacé par une valeur lors de l’exécution d’une requête. Examinons cette définition dans le contexte de notre scénario Contoso.
Vous n’en avez peut-être pas connaissance, mais à l’étape 9: Configurer la requête dans un partie Web De recherche de contenu sur une page de catégorie dans SharePoint Server , lorsque nous avons configuré la requête dans le CSWP sur la page de catalogue, nous avons utilisé une variable de requête. Lorsque nous avons sélectionné Restreindre selon les termes de navigation actuels et enfants, une variable de requête a été ajoutée à notre requête. Cette variable de requête était un espace réservé pour la valeur de navigation dans l’URL (audio, appareil photo, mp3, etc.). Chaque fois qu’un visiteur clique sur une catégorie, la variable de requête dans le composant WebPart est remplacée par la valeur de navigation dans l’URL. Par conséquent, le composant WebPart émet une requête pour les éléments de catalogue qui sont marqués avec « audio », « appareil photo », « mp3 », etc.
Pour en revenir à notre page d’élément de catalogue, nous voulons afficher les éléments dont le numéro de groupe est identique. Rappelez-vous à l’étape 3 : Comment activer une liste en tant que catalogue dans SharePoint Server comment nous avons ajouté le numéro de groupe comme l’une des colonnes de liste à utiliser comme champ URL d’élément de catalogue . Nous l’avons fait afin que la valeur du numéro de groupe soit utilisée dans l’URL.
La capture d’écran ci-dessous montre notre site Contoso final. Notez que le numéro de groupe, 5637145950, est utilisé comme avant-dernière valeur dans l’URL.

Si nous accédons à un autre produit, le numéro de groupe de ce produit ( 5637145875 , par exemple) est également utilisé comme avant-dernière valeur dans l’URL.

Ainsi, lors de la configuration de la requête pour le composant WebPart Recherche de contenu dans notre page d’élément de catalogue, vous devez utiliser une variable de requête qui correspondra à l’avant-dernière valeur dans l’URL.
Les variables de requête figurent entre accolades comme suit : {QueryVariable}. Ne vous inquiétez pas de ces accolades, ce n’est pas aussi compliqué ou aussi complexe qu’il pourrait ressembler.
Comme mentionné ci-dessus, lors de la configuration de la requête dans le composant WebPart Recherche de contenu dans la page de catalogue, nous avons utilisé une variable de requête. Mais nous n’avons pas eu à nous occuper d’accolades à la recherche. En effet, la jolie case d’option Restreindre selon les termes de navigation actuels et enfants s’en est chargée pour nous. Pour configurer la requête pour notre page d’élément de catalogue, nous devons ajouter une variable de requête avec des accolades. Heureusement, nous allons avoir des menus pull-down convivial pour nous aider. Attelons-nous à présent à la tâche de configuration de la requête.
Procédure de configuration d’une requête dans un composant WebPart Recherche de contenu dans une page d’élément de catalogue
Dans le partie Web Part, sélectionnez le menu du > modifier le site Web Part.
Dans le volet des outils du composant WebPart, sélectionnez Changer la requête. Cette action entraîne l’ouverture d’une boîte de dialogue.
Dans la boîte de dialogue, dans le menu Sélectionner une requête, sélectionnez l’origine des résultats de votre catalogue. Dans notre scénario, il s’agit de catalogue : Résultats Produits.

Sélectionnez Basculer en mode avancé.

En mode avancé, dans le champ de texte Requête, vous verrez du texte. Il s’agit du texte de requête qui représente l’origine des résultats catalogue : Résultats Produits. (Nous avons vu le même texte de requête à l’étape 9, lorsque nous avons vu comment afficher les détailsde la configuration de la requête.)

Dans la liste Filtre de propriétés, sélectionnez Afficher toutes les propriétés gérées.

Dans la liste Filtre de propriétés, sélectionnez ProductCatalogGroupNumberOWSTEXT, Contient et Valeur d’un jeton de l’URL.

ProductCatalogGroupNumberOWSTEXT est le nom de la propriété gérée du numéro de groupe de colonne de site. (Plus tôt dans cette série, nous avons examiné la convention d’attribution de noms pour cette colonne dans la convention d’attribution de noms pour les colonnes de site par défaut dans la liste Produits.) La sélection de Contient et valeur d’un jeton à partir de l’URL crée la variable de requête que nous voulons utiliser.
Sélectionnez Ajouter un filtre de propriété.

Notez que ProductCatalogGroupNumberOWSTEXT:{URLToken.1} est ajouté au champ Texte de requête. Ainsi, sans même devoir posséder de connaissances sur la syntaxe de requête ou devoir saisir une accolade, nous avons ajouté une variable de requête.
À présent, vous pensez peut-être : « D’accord, c’était facile, mais qu’est-ce que ProductCatalogGroupNumberOWSTEXT:{URLToken.1} signifie vraiment ? Nous allons le décomposer :
ProductCatalogGroupNumberOWSTEXT est la propriété gérée qui représente la colonne Numéro de groupe dans notre catalogue.
Le signe deux-points ( : ) signifie « contient ».
{URLToken.1} représente une valeur de l’URL de la page en cours. Le nombre entier, dans ce cas 1, représente la valeur dans l’URL, en allant de droite à gauche. Par exemple, dans l’URL, la variable de requête http://www.contoso.com/cameras/camcorders/563714875/6637146586 {URLToken.1} représente la valeur 6637146586.
Si nous rassemblons les éléments de la requête et que nous l’observons, nous obtenons ceci :
Dans le catalogue d’origine des résultats - Résultats des produits, recherchez les éléments où la valeur de la propriété gérée ProductCatalogGroupNumberOWSTEXT contient la valeur actuellement utilisée comme première valeur dans l’URL, en comptant de droite à gauche.
Dans la dernière étape de la procédure de l’étape 3: Comment activer une liste en tant que catalogue dans SharePoint Server , nous avons défini que l’URL de l’élément doit contenir à la fois le numéro de groupe et le numéro d’élément en tant que champs d’élément de catalogue et d’URL. Par conséquent, la première valeur dans l’URL, de droite à gauche, est Numéro d’élément. Nous voulons rechercher des éléments qui ont le même numéro de groupe. Nous devons donc apporter une petite modification à la variable de requête.
Dans le champ Texte de requête, modifiez le numéro dans la variable de requête en le définissant sur 2.

Désormais, la requête dans le composant WebPart recherchera des éléments pour lesquels la valeur de la propriété gérée ProductCatalogGroupNumberOWSTEXT contient la valeur actuellement utilisée comme deuxième valeur dans l’URL, de droite à gauche.
Pour tester que cette requête renvoie les résultats corrects, sélectionnez Requête test.

Cinq éléments sont affichés sous la section Résultats pertinents. Ces éléments permettent de confirmer l’exactitude de la requête, car nous savons que le produit Autoradio Northwind Traders 50W est disponible en cinq couleurs.
Sélectionnez OK et enregistrez la page.

Même si trois produits sont affichés au lieu d’un, et que nous n’avons toujours pas l’apparence Contoso, il s’agit de la progression. La requête dans le composant WebPart est désormais configurée. Dans l’article suivant, nous allons vous montrer comment ajouter des modèles d’affichage qui donnent à nos éléments l’apparence Contoso.
Article suivant de cette série
Voir aussi
Concepts
Configurer l’composants WebPart de recherche dans SharePoint Server