Partager via

Procédure : fédérer une recherche sur une liste SharePoint

  • Article

Notes

Cette rubrique décrit la fonctionnalité qui fait partie de la Infrastructure Update for Microsoft Office Servers. Pour télécharger la mise à jour, voir Description de la mise à jour d'infrastructure SharePoint Server 2007 : 15 juillet 2008.

Vous pouvez créer un emplacement pour l'Index de recherche locale de façon à afficher les résultats fédérés provenant de l'index de recherche locale du serveur de recherche. Vous pouvez utiliser cette fonctionnalité pour retourner des résultats de recherche fédérée provenant d'une liste SharePoint ciblée pour des recherches particulières d'une manière similaire à la fonctionnalité Meilleurs résultats.

Dans cette procédure pas à pas, vous allez apprendre à afficher les résultats de recherche fédérée provenant d'une liste SharePoint créée à partir d'une feuille de calcul Microsoft Office Excel 2007. Cette rubrique décrit les opérations suivantes :

  • Création de la liste SharePoint

  • Création et configuration d'une zone de recherche pour la liste

  • Création et mappage des propriétés managées avec les propriétés analysées de la liste

  • Création de l'emplacement fédéré

  • Personnalisation des informations d'affichage de l'emplacement

  • Configuration d'un déclencheur pour l'emplacement

Conditions préalables requises

Les conditions préalables requises pour cette procédure sont les suivantes :

  • Vous êtes administrateur d'une collection de sites pour le site SharePoint.

  • Vous êtes un administrateur de recherche pour le serveur de recherche.

  • Vous avez installé Microsoft Office Excel 2007.

  • Vous avez téléchargé le fichier Office Excel fourni en exemple pour cette rubrique : Sampleformslist.xlsx.

Étape 1 : créer une liste

Vous commencez par créer la liste et par la remplir avec des données. Pour gagner du temps, vous pouvez importer des données à partir d'une feuille de calcul Office Excel pour créer la liste.

Créer la liste à partir d'une feuille de calcul Office Excel

  1. Dans la Page d'accueil de votre site, cliquez sur le lien Actions du site, puis sur Créer.

  2. Sélectionnez Importer une feuille de calcul dans Listes personnalisées.

  3. Tapez CustomImportSample dans le champ Nom.

  4. Cliquez sur Parcourir, accédez à l'emplacement où vous avez enregistré Sampleformslist.xlsx, sélectionnez-le, puis cliquez sur Ouvrir.

  5. Cliquez sur Importer.

  6. Cliquez sur Plage de cellules dans la liste Type de plage.

  7. Dans le champ Sélectionner la plage, tapez $ A $ 1... $ D $11 .

  8. Cliquez sur Importer.

Lorsque vous créez la liste, démarrez une analyse incrémentielle de la source de contenu des sites locaux Office SharePoint Server pour mettre à jour l'index avec les données de la liste.

Lancer une analyse incrémentielle

  1. Dans la page Administration de la recherche, cliquez sur le lien Sources de contenu dans la section Analyse de la barre de navigation de gauche.

  2. Dans la page Gérer les sources de contenu, pointez sur la source de contenu Sites Office SharePoint Server locaux, cliquez sur la flèche qui s'affiche, puis sur Démarrer l'analyse incrémentielle.

    Important

    Vérifiez que la liste CustomImportSample figure dans la source de contenu des sites locaux Office SharePoint Server.

Étape 2 : créer une étendue de recherche

Vous devez créer la zone de recherche pour la liste CustomImportSample. Cette étape comprend les tâches suivantes :

  • Création de la zone de recherche et configuration des règles d'étendue

  • Compilation de la zone de recherche et vérification de la compilation

Créer une étendue pour la liste

  1. Dans la Page d'accueil de votre site, cliquez sur le lien Actions du site, puis sur Paramètres du site.

  2. Dans Administration de la collection de sites, cliquez sur Zones de recherche.

  3. Dans la page Afficher les étendues, cliquez sur Nouvelle étendue.

  4. Dans le champ Titre, tapez SampleListScope , puis cliquez sur OK pour créer l'étendue.

  5. Dans la page Afficher les étendues, cliquez sur SampleListScope pour ouvrir la page Règles et Propriétés de l'étendue.

  6. Cliquez sur Nouvelle dans la section Règles.

  7. Dans le champ Type de règle d'étendue, cliquez sur Adresse Web (http://serveur/site).

  8. Dans le champ Adresse Web, cliquez sur Dossier, puis tapez http:// SiteURL / lists/customimportsample.

    Remplacez SiteURL par l'URL de votre site.

  9. Dans le champ Comportement, cliquez sur Obligatoire - Chaque élément de l'étendue doit correspondre à cette règle.

  10. Cliquez sur OK pour ajouter la règle.

  11. Cliquez sur Nouvelle dans la section Règles.

  12. Dans le champ Type de règle d'étendue, cliquez sur Requête de propriété (auteur = Olivier Renaud).

  13. Dans la section Requête de propriété, cliquez sur contentclass dans la liste Ajouter des restrictions de propriété.

  14. Copiez le texte suivant dans le champ de texte de Requête de propriété :

    STS_ListItem_GenericList

    Notes

    STS_ListItem_GenericList est la classe de contenu d'un élément de liste. Ajoutez cette restriction à l'étendue afin que celle-ci ne comprenne que des éléments de la liste, et non la liste elle-même. Si vous n'incluez pas cette restriction, la liste CustomImportSample est toujours retournée comme premier résultat.

  15. Dans le champ Comportement, cliquez sur Obligatoire - Chaque élément de l'étendue doit correspondre à cette règle.

  16. Cliquez sur OK pour ajouter la règle.

    L'étendue de la liste d'importation personnalisée fournie à titre d'exemple ne contient pas tous les éléments tant qu'elle n'est pas compilée sans problème.

Compiler les étendues et vérifier que la compilation a réussi

  1. Dans la page Administration de la recherche, dans la section État du système, cliquez sur Démarrer la mise à jour maintenant dans la ligne Étendues nécessitant une mise à jour.

  2. Dans la Page d'accueil de votre site, cliquez sur le lien Actions du site, puis sur Paramètres du site.

  3. Dans Administration de la collection de sites, cliquez sur Zones de recherche.

  4. Vérifiez que la valeur du champ Éléments pour la liste d'importation personnalisée est égale à 10.

Étape 3 : mapper les propriétés analysées

Mappez les propriétés analysées de la liste CustomImportSample avec les propriétés gérées. Procédez comme suit :

  • Mappage d'une propriété analysée avec une propriété gérée existante

  • Mappage d'une propriété analysée sur une nouvelle propriété gérée

  • Démarrage de l'analyse complète d'une source de contenu

Mapper une propriété analysée avec une propriété gérée existante

  1. Dans la page Administration de la recherche, sous Requêtes et résultats, cliquez sur Propriétés des métadonnées.

  2. Dans l'affichage Propriétés gérées, cliquez sur Description dans la colonne Nom de la propriété pour ouvrir la page Modifier la propriété gérée.

  3. Dans la section Mappages sur les propriétés analysées, cliquez sur Ajouter un mappage.

  4. Dans la liste Sélectionner une catégorie, cliquez sur SharePoint.

  5. Dans Nom de la propriété analysée, tapez formulaire, puis cliquez sur Rechercher.

    Cela retourne les propriétés analysées de la liste CustomImportSample.

  6. Sélectionnez la propriété ows_FormDescription(Text) et cliquez sur OK.

  7. Cliquez sur OK pour enregistrer les modifications de la propriété gérée Description.

Ajouter des propriétés gérées

  1. Dans la page Administration de la recherche, sous Requêtes et résultats, cliquez sur Propriétés des métadonnées.

  2. Dans la liste Propriétés géréesAfficher, cliquez sur Nouvelle propriété gérée.

  3. Pour la section Nom et type, entrez formid dans le champ du nom de la Propriété, puis sélectionnez Texte.

  4. Dans Mappages sur les propriétés analysées, cliquez sur Ajouter un mappage.

  5. Dans la liste Sélectionner une catégorie, cliquez sur SharePoint.

  6. Dans Nom de la propriété analysée, tapez Formulaire , puis cliquez sur Rechercher.

    Cela retourne les propriétés analysées de la liste CustomImportSample.

  7. Sélectionnez la propriété ows_FormID et cliquez sur OK.

  8. Cliquez sur OK pour créer la propriété gérée formid.

    Notes

    Ces modifications des propriétés ne s'appliquent pas tant que le service de recherche n'a pas effectué une autre analyse complète de la source de contenu.

Démarrer une analyse complète

  1. Dans la page Administration de la recherche, cliquez sur le lien Sources de contenu dans la section Analyse.

  2. Dans la page Gérer les sources de contenu, pointez sur la source de contenu Sites Office SharePoint Server locaux, cliquez sur la flèche qui s'affiche, puis sur Démarrer l'analyse complète.

Lorsque l'analyse complète est terminée, vérifiez que les propriétés gérées sont mappées correctement avec les propriétés analysées et remplies avec les données de la liste CustomImportSample.

Confirmer que les propriétés gérées sont correctement mappées

  1. Dans la page Administration de la recherche, sous Requêtes et résultats, cliquez sur Propriétés des métadonnées.

  2. Dans la page Mappages de propriétés de métadonnées, dans la liste Affichage des propriétés gérées, cliquez sur formid dans la colonne Nom de la propriété.

  3. Dans la section Contenu utilisant cette propriété, vérifiez que la valeur 10 est affichée pour Nombre d'éléments trouvés dans cette propriété.

Étape 4 : ajouter l'emplacement fédéré

Effectuez les tâches suivantes pour ajouter l'emplacement fédéré de la liste CustomImportSample :

  • Ajout de l'emplacement fédéré

  • Test de l'emplacement fédéré

Ajouter l'emplacement fédéré

  1. Dans la page Administration Recherche de contenu d'entreprise, cliquez sur Emplacements fédérés, puis sur Nouvel emplacement.

  2. Dans le champ Emplacement, entrez CustomListSampleResults.

  3. Dans le champ Nom complet, tapez Résultats de la liste personnalisée .

  4. Dans le champ Description tapez le texte qui décrit l'emplacement (ex. Résultats d'une liste SharePoint personnalisée).

  5. Pour le champ Type d'emplacement, cliquez sur Index de recherche sur ce serveur.

  6. Dans le champ Modèle de requête, tapez {searchTerms} Scope:SampleListScope .

  7. Dans le champ Modèle de lien "Autres résultats", tapez http:// SiteURL**/ Lists/customimportsample/AllItems.aspx.**

    Remplacez SiteURL par l'URL de votre site.

  8. Cliquez sur OK pour ajouter l'emplacement.

Testez comment les résultats sont retournés de l'emplacement fédéré que vous venez de créer pour vérifier qu'il est configuré correctement.

Tester l'emplacement fédéré

  1. Dans votre navigateur, accédez à l'URL de la page des résultats. Exemple : http://SiteURL/results.aspx. Remplacez SiteURL par l'URL de votre site

  2. Cliquez sur le lien Actions du site, puis sur Modifier la page.

  3. Dans la Zone de droite, cliquez sur Ajouter un composant WebPart.

  4. Dans Composants WebPart suggérés pour la zone à droite, cliquez sur Résultats fédéré, puis sur Ajouter.

  5. Cliquez sur la flèche modifier des nouveaux composants WebPart Federated Results pour afficher le menu Composant WebPart, puis sur Modifier le composant WebPart partagé. Le volet d'outil composant WebPart Federated Results s'affiche.

  6. Dans Propriétés de l'emplacement, cliquez sur Résultats de la liste personnalisée dans la liste Emplacement.

  7. Cliquez sur OK.

  8. Cliquez sur Quitter le mode Édition pour fermer la page de modification.

  9. Dans la zone de recherche, tapez un terme de recherche trouvé dans la liste d'éléments (form), puis cliquez sur Aller à.

    Vous devez voir les résultats de la liste CustomImportSample affichés dans le composant WebPart Federated Results ; l'affichage XSLT par défaut est utilisé pour afficher les résultats des éléments de la liste.

Dans la prochaine étape, vous allez modifier les informations d'affichage par défaut relatives à l'emplacement fédéré pour personnaliser l'affichage des résultats.

Étape 4 : personnaliser les informations d'affichage de l'emplacement fédéré

Pour afficher des propriétés supplémentaires dans les résultats fédérés, vous devez personnaliser les informations d'affichage de l'emplacement fédéré. Procédez comme suit :

  • Personnalisation de l'élément Properties de l'emplacement pour retourner la propriété gérée formid

  • Personnalisation de l'élément XSL de l'emplacement pour afficher la valeur de la propriété gérée formid

Personnaliser l'élément Propriétés de l'emplacement

  1. Dans la page Administration de la recherche, dans la section Requêtes et résultats, cliquez sur Emplacements fédérés.

  2. Dans la page Gérer les emplacements fédérés, cliquez sur Résultats de la liste personnalisée.

  3. Dans la page Modifier l'emplacement fédéré, dans la section Afficher les informations, désactivez la case Utiliser le format par défaut pour Métadonnées d'affichage des résultats de la recherche fédérée.

  4. Cliquez sur le bouton de sélection (...) du champ Propriétés pour ouvrir la fenêtre Entrée de texte de l'élément Properties de l'emplacement.

  5. Remplacez le code XML par défaut par le code ci-dessous.

    <Columns>
  <Column Name="title"/>        
  <Column Name="path"/>
  <Column Name="description"/>
  <Column Name="contentclass"/>
  <Column Name="formid"/>
</Columns>

    Le code XML modifié supprime les éléments Colonne trouvés affichés en surbrillance et ajoute un élément Colonne pour la propriété formid.

  6. Cliquez sur OK pour fermer la fenêtre d'entrée de texte.

Personnaliser l'élément Xsl de l'emplacement

  1. Cliquez sur le bouton de sélection (...) du champ XSL pour ouvrir la fenêtre Entrée de texte de l'élément Xsl de l'emplacement.

    Vous pouvez modifier la transformation XSLT directement dans cette fenêtre ; toutefois, il est peut-être plus facile de copier le code dans un fichier. Vous pouvez ensuite modifier ce fichier à l'aide d'une application telle que Visual Studio 2005. Lorsque vous avez terminé la modification du fichier, vous pouvez copier le code modifié dans la fenêtre Entrée de texte et enregistrer les modifications apportées à l'emplacement fédéré.

  2. Définissez un nouveau modèle, GetTitleWithFormID : ajoutez le code suivant avant la balise de clôture stylesheet</xsl:stylesheet> :

    <xsl:template name="GetTitleWithFormID">
  <xsl:value-of select="title"/>:  
    <xsl:value-of select="formid"/>
</xsl:template>

  3. Recherchez l'élément xsl:call-template qui s'applique au modèle GetTitle. Vous le trouvez en recherchant le code suivant.

    <xsl:call-template name="GetTitle">

  4. Remplacez GetTitle par GetTitleWithFormID, comme suit.

    <xsl:call-template name=" GetTitleWithFormID ">

  5. Cliquez sur OK pour fermer la fenêtre Entrée de texte.

  6. Cliquez sur OK pour enregistrer les modifications de l'emplacement fédéré Résultats de la liste personnalisée.

    Testez à nouveau l'affichage des résultats de l'emplacement pour vérifier que vos modifications fonctionnent.

  7. Accédez au site de votre serveur de recherche. Dans la zone de recherche, tapez un terme de recherche trouvé dans la liste d'éléments (ex. formulaire), puis cliquez sur Rechercher.

    Les résultats de la liste CustomImportSample doivent être affichés dans le composant WebPart Federated Results. L'affichage personnalisé XSLT est utilisé pour afficher les résultats des éléments de la liste, la valeur formid étant ajoutée au titre dans le format suivant : title: formid.

Étape 5 : spécifier un déclencheur pour l'emplacement fédéré

L'emplacement des résultats de la liste personnalisée est actuellement configuré pour passer toutes les requêtes à l'emplacement fédéré. Pour limiter le nombre de requêtes envoyées à l'emplacement fédéré, vous pouvez spécifier un déclencheur. Un déclencheur est une condition de requête qui détermine à quel moment passer une requête. Les déclencheurs d'un emplacement garantissent que seules les requêtes qui correspondent au modèle spécifié pour les déclencheurs sont envoyées vers l'emplacement fédéré.

Spécifier un déclencheur pour l'emplacement fédéré

  1. Dans la page Administration de la recherche, dans la section Requêtes et résultats, cliquez sur Emplacements fédérés.

  2. Dans la page Gérer les emplacements fédérés, cliquez sur Résultats de la liste personnalisée.

  3. Dans la section Déclencheur de la page Modifier l'emplacement fédéré, cliquez sur Préfixe : la requête doit commencer par un préfixe spécifié.

  4. Dans le champ Ajouter un préfixe, tapez formulaire, puis cliquez sur OK pour enregistrer vos modifications.

    Testez à nouveau l'affichage des résultats de l'emplacement pour vérifier que vos modifications fonctionnent.

  5. Accédez au site de votre serveur de recherche. Dans la zone de recherche, tapez le terme de recherche formulaire que vous avez testé à l'étape précédente, puis cliquez sur Rechercher.

    Cette fois, aucun résultat de recherche n'est affiché dans le composant WebPart Federated Results étant donné que, lorsque vous spécifiez un déclencheur de préfixe pour un emplacement, le préfixe n'est pas passé dans la requête.

  6. Testez un autre terme de recherche, mais utilisez maintenant le préfixe. Dans la zone de recherche, tapez formulaire bénéfices, puis cliquez sur Rechercher.

    Tous les éléments de la liste contenant le terme bénéfices sont renvoyés.

  7. Testez le même terme de recherche, mais sans utiliser le préfixe. Dans la zone de recherche, tapez bénéfices, puis cliquez sur Rechercher.

    Aucun résultat n'est affiché dans le composant WebPart Federated Results.

Voir aussi

Autres ressources

Vue d'ensemble de la recherche fédérée
XSLT des composants WebPart Federated Results