Doc produitsMenu

Configuration de portées de recherche SharePoint

Coveo .NET Front-End 12.0.960+ (septembre 2014)

SharePoint 2013 et 2010 permettent aux administrateurs de SharePoint de définir des portées de recherche afin de permettre aux utilisateurs de choisir de limiter leurs recherches à certains critères, tels que les lieux ou le contenu marqué avec des valeurs de propriété particulières (voir l'article de Microsoft Define scopes for searches).

Un administrateur de site SharePoint peut définir des portées de SharePoint, même avec un accès limité aux serveurs d’interface SharePoint. Les portées de SharePoint sont enregistrées directement dans la base de données SharePoint au niveau de la collection de sites. En plus des portées elles-mêmes, une configuration de portée par défaut peut être créée au niveau de la collection de sites. Les portées SharePoint sont envoyées à l’index CES en temps de requête, en tant qu’expressions de requête. Étant donné que les portées de SharePoint n’existent que dans SharePoint, elles ne peuvent être utilisées qu’à partir de l’intérieur des pages SharePoint. Une page de recherche Coveo qui n’est pas intégrée à SharePoint ne peut les utiliser.

Note : Le soutien pour les portées de SharePoint est différent de celui des portées de recherche Coveo qui sont définies dans le serveur maître de Coveo (voir Outil d'administration - Menu Portées de recherche) et utilisées dans les interfaces utilisateur de Coveo .NET Front-End (voir Configuration de la portée d'une interface de recherche). Un administrateur qui gère les portées de recherche de Coveo doit avoir accès à l’Outil d’administration de Coveo et à l’Éditeur d’interface Coveo .NET Front-End.

D’un point de vue fonctionnel, les portées de SharePoint se comportent comme les portées de Coveo. Dans SharePoint, elles apparaissent dans la liste déroulante de portées à côté de la boîte de recherche Coveo et dans la facette Rechercher dans dans la page de résultats. Lorsqu’un utilisateur sélectionne une portée SharePoint, les documents y sont filtrés ou non selon la configuration de la portée SharePoint.

Pour configurer des portées de recherche SharePoint

  1. Veillez à ce que la version 12.0.960+ de Coveo .NET Front-End (septembre 2014) soit installée dans votre serveur SharePoint (voir Installation du service Web Coveo, de la boîte de recherche et de l'interface de recherche dans SharePoint)

  2. Accédez à SharePoint avec un compte d’administrateur de site.

  3. Dans toute page de SharePoint renfermant une boîte de recherche Coveo, cliquez sur l’icône de roue à côté de la boîte de recherche, puis sélectionnez une des options suivantes :

    • Current site collection's scopes pour définir ou modifier les portées de collections de sites par défaut utilisées par défaut par chaque site.

    • Current site's scopes ([SiteName]) pour définir une configuration de portée applicable uniquement au site actuel ([SiteName]), écrasant la valeur par défaut héritée.

    Notes :

    • D’autre part, dans une interface de recherche Coveo .NET Front-End intégrée dans SharePoint, à partir du menu Do more, vous pouvez sélectionner les mêmes options.

    • L'icône de roue et l'option Current site collection's scopes du menu Do more ne sont pas disponibles aux utilisateurs qui ne sont pas des administrateurs.

  4. Dans la boîte de dialogue Search Scopes (Site Collection Default) ou Search Scopes (Current Site), vous pouvez effectuer diverses actions.

    • Pour utiliser des portées par défaut pour un site spécifique, sélectionnez l’option Use default scopes (site collection)

    • Pour spécifier les portées disponibles pour les utilisateurs finaux, dans la colonne Name, cochez la (les) portée(s) pour la (les) rendre disponible(s).

    • Pour spécifier la portée par défaut, dans la colonne Default, sélectionnez la bonne portée.

    • Pour rendre les portées sélectionnées visibles aux utilisateurs finaux :

      • Sélectionnez l’option Show scope selector drop-down next to search box pour que les portées soient disponibles dans SharePoint à partir d’une liste à côté du champ de recherche.

        Note : Par défaut, les portées standards suivantes ne sont pas incluses dans la liste déroulante de portées : All SharePoint, Current SharePoint site, Current SharePoint top level site, All Results, et toutes les portées de recherche définies dans l’Outil d’administration (voir Que sont les portées de recherche?).

        Pour inclure ces portées dans la liste de portées, vous devez modifier le fichier SearchBox.ascx du skin SharePoint :

        1. Avec un compte détenant des droits d’administrateur, accédez au serveur SharePoint.

        2. Ouvrez le fichier SearchBox.ascx avec un éditeur de texte.

          Selon votre version de SharePoint, le fichier se trouve dans C:\Program Files\Coveo .NET Front-End 12\Web\Coveo\Skins\SharePoint 2010 ou dans C:\Program Files\Coveo .NET Front-End 12\Web\Coveo\Skins\SharePoint 2013.

        3. Supprimez la méthode suivante du fichier :

              protected override void OnInit(EventArgs p_Args)
              {
                  ISearchBox sb = Parent.Parent as ISearchBox;
                  if (sb != null) {
                      sb.ShowStandardScopes = false;
                  }
                  base.OnInit(p_Args);
              }
        4. Enregistrez le fichier.

      • Sélectionnez l’option Show scope selector facet in search interface pour que les portées soient disponible dans la facette Rechercher dans d’une interface de recherche Coveo .NET Front-End intégrée dans SharePoint.

    • Pour créer une nouvelle portée ou modifier une portée existante :

      Cliquez sur Create Scope pour créer une nouvelle portée ou cliquez sur l'icône Edit Scope pour en modifier une qui existe déjà dans la boîte de dialogue Search Scope Modification, configurez la portée:

      1. Dans la boîte Name, tapez un nom significatif pour la portée. Les utilisateurs finaux verront ce nom dans les listes de portées SharePoint disponibles.

      2. Dans la boîte Description, vous pouvez taper une description de la portée. Ces informations ne sont visibles qu’aux administrateurs.

      3. Cliquez sur Add Rule lorsque vous souhaitez ajouter une nouvelle règle à la portée.

      4. Dans la liste Rules, pour chaque règle :

        1. Dans la première colonne, sélectionnez un des types de règles disponibles.

          • Web Address

            Une règle d’adresse web est utilisée pour restreindre la portée pour ne rechercher qu’à partir d’une partie spécifique du serveur SharePoint.

            Exemple : Vous entrez https://intranet.mycompany.com/HumanResources/ pour créer une portée restreinte au contenu des ressources humaines.

          • Field

            Une règle de champ est utilisée pour restreindre la portée pour ne recherche que d’une partie spécifique du serveur SharePoint. Dans une règle de champ, vous ne pouvez utiliser que des champs dont l’option Include for field queries est sélectionnée dans l’Outil d’administration (voir Ajout ou modification de champs personnalisés). Pendant que vous tapez le nom de champ, une fenêtre contextuelle d’auto-complètement suggère les noms de champ disponibles qui correspondent aux caractères tapés.

            Exemple : Une portée avec la règle de champ suivante ne retournerait que des fichiers PDF.

            @sysfiletype = pdf

          • Free Text

            La valeur de la règle de texte libre est ajoutée telle quelle à la requête envoyée à l’index. Seuls les documents renfermant les mots clés saisis sont retournés. Si plus d’un mot est spécifié, seuls les documents qui contiennent tous les mots sont retournés.

            La règle de texte libre peut être particulièrement utile pour saisir des requêtes plus complexes à l’aide de divers éléments de syntaxe de requête (voir Référence de la syntaxe de la requête de Coveo).

            Exemple : Une portée avec la requête suivante, utilisant des champs et un opérateur booléen, ne retournerait que des fichiers PDF du site Engineering.

            @sysspsitename="Engineering" AND @sysfiletype="pdf"

        2. Dans la colonne du milieu de la liste, saisissez ou sélectionnez des valeurs appropriées au type de règle.

        3. Dans l’avant-dernière colonne, sélectionnez l’action qui détermine comment chaque règle se combine à d’autres pour former la portée finale :

          • Require (AND)

            Utilisez cette action pour réduire les résultats de recherche aux documents qui correspondent aux critères de règle.

          • Include (OR)

            Utilisez cette action pour agrandir les résultats de recherche en ajoutant des documents correspondant aux critères de règle.

          • Exclude (NOT)

            Utilisez cette action pour agrandir les résultats de recherche en retirant des documents correspondant aux critères de règle.

        4. Cliquez sur l’icône Delete Rule pour supprimer une règle de la portée.

      5. Cliquez sur Save pour enregistrer votre configuration de portée.

    • Pour supprimer une portée existante, cliquez sur l’icône Delete Scope de la portée.

    • Cliquez sur Apply pour que les modifications à la portée de recherche soient effectives.