Doc produitsMenu

Plateforme Coveo 7.0 >
Aide à l'administrateur > Connecteurs > Connecteur Microsoft SharePoint > Configuration et indexation d'une source Microsoft SharePoint

Configuration et indexation d'une source Microsoft SharePoint

Une source définit un groupe de paramètres de configuration pour l'extraction et l'indexation de contenu Microsoft SharePoint. Cette rubrique décrit la création d'une source à l'aide du connecteur SharePoint de deuxième génération.

Notes :

  • Dans un environnement avec plus d'une application web Microsoft SharePoint, il est conseillé de définir une source pour chaque application web Microsoft SharePoint que vous souhaitez indexer, et n'indexez les profils d'utilisateurs qu'une fois afin de ne pas créer de doubles dans votre index (voir Modification de paramètres de source cachés de Microsoft SharePoint).

  • CES 7.0.6830+ (juillet 2014) Le type de source SharePoint est pour le connecteur SharePoint de deuxième génération. Lorsque vous utilisez toujours le connecteur SharePoint original pour créer votre source SharePoint, soyez certain d'utiliser plutôt le type de source SharePoint Legacy (voir Configuration et indexation d'une source Sitecore pour l'ancien connecteur).

Pour configurer et indexer une source Microsoft SharePoint

  1. Dans le serveur Coveo, accédez à l'Outil d'administration (voir Ouverture de l'Outil d'administration).

  2. Sélectionnez Index > Sources et collections.

  3. Dans la section Collections :

    1. Sélectionnez une collection existante dans laquelle vous souhaitez ajouter la nouvelle source.

      OU

    2. Cliquez sur Ajouter pour créer une nouvelle collection (voir Ajout d'une collection).

  4. Dans la section Sources, cliquez sur Ajouter.

    La page Ajouter une source qui apparaît est organisée en trois sections.

  5. Dans la section Paramètres généraux (General Settings) de la page Ajouter une source (Add Source) :

    1. Tapez la bonne valeur pour les paramètres obligatoires suivants :

      Nom

      Tapez un nom descriptif de votre choix pour cette source.

      Exemple : Lorsque vous avez plus d'un site SharePoint à indexer, vous pouvez inclure dans les informations sur le nom afin de pouvoir les distinguer.

      SharePoint 2013 Intranet

      SharePoint 2010 Extranet

      Type de source

      Le connecteur qui est utilisé par cette source. Dans ce cas, sélectionnez SharePoint.

      Note : CES 7.0.6767– (juin 2014) Le type SharePoint correspond à ce qui est maintenant le type de source Legacy SharePoint (voir Configuration et indexation d'une source Sitecore pour l'ancien connecteur).

      Adresses (Addresses)

      Liste de sections spécifiques de la batterie de serveurs SharePoint que vous souhaitez indexer. Si vous devez indexer plus d'une section, saisissez une URL par ligne.

      Note : Avec CES 7.0.6942 (août 2014), les adresses de départ doivent se terminer par /.

      Exemples :

      Pour l'ensemble de la batterie de serveurs :
      https://farm/

      Pour une application Web spécifique :
      https://farm:8080/

      Pour une collection de sites spécifique :
      https://farm:8080/sites/Support/default.aspx

      Pour un site Web spécifique :
      https://farm:8080/sites/Support/subsite/default.aspx

      Pour une bibliothèque de documents spécifique :
      https://farm:8080/Document Library/

      Pour une liste spécifique :
      https://farm:8080/sites/Support/Lists/Contacts/AllItems.aspx

      Pour SharePoint Online :
      https://domain.sharepoint.com

      Note : Vous pouvez également utiliser le paramètre Crawl Scope de la source pour contrôler de façon plus précise le contenu à analyser (voir ci-dessous).

      Champs (Fields)

      Sélectionnez le groupe de champs que vous avez créé pour cette source (voir Vue d'ensemble du déploiement du connecteur Microsoft SharePoint).

      Horaire d'actualisation (Refresh Schedule)

      Intervalle de temps pendant laquelle la source est automatiquement actualisée afin de conserver le contenu de l'index à jour.

      Note : L'option Every Day par défaut est habituellement bonne, mais lorsque votre contenu SharePoint change fréquemment pendant une journée, vous devriez, après avoir créé votre source, planifier une actualisation incrémentale à une intervalle de temps nettement plus courte pour indexer continuellement les modifications en cours au contenu de SharePoint (voir Planification d'une actualisation incrémentale de source). Vous pouvez actualiser la source chaque semaine en sélectionnant l'option Every Sunday.

    2. Évaluez la valeur des paramètres suivants, qui, la plupart du temps, n'ont pas à être modifiés :

      Appréciation (Rating)

      Changez la valeur seulement si vous souhaitez changer globalement la cote associée à tous les éléments de cette source par rapport à la cote d'autres sources (voir Fonctionnement du classement des résultats de recherche).

      Exemple : Si cette source était pour un ancien Intranet, vous devriez définir ce paramètre à Basse afin que, dans l'interface de recherche, les résultats de cette source apparaissent plus tard dans la liste, contrairement à ceux d'autres sources.

      Types de document (Document Types)

      Si vous avez défini des groupes personnalisés de types de documents, veillez à sélectionner celui qui convient le mieux à cette source (voir Que sont les groupes de types de documents?).

      Langues actives (Active Languages)

      Si vous avez défini des groupes personnalisés de langues actives, veillez à sélectionner celui qui est le plus approprié pour la source.

  6. Dans la section Paramètres spécifiques au connecteur (Specific Connector Parameters & Options) de la page Ajouter une source, vérifiez si vous devez changer les valeurs par défaut des paramètres :

    1. Dans la boîte Number of Refresh Threads, lorsque votre serveur Coveo contient des noyaux d'unités centrales disponibles, vous pouvez augmenter le nombre pour améliorer facilement et de façon significative l'analyse. La valeur par défaut est 2.

    2. Dans la boîte Mapping File, laissez la valeur par défaut pour utiliser le fichier de correspondances par défaut (Coveo.CES.CustomCrawlers.SharePoint.MappingFile.xml).

      Lorsque vous déduisez qu’une partie du contenu personnalisé SharePoint n’est pas indexé ou correctement lié, vous devriez créer un fichier de correspondances personnalisé, puis saisissez le chemin d’accès complet vers le fichier (voir Création et utilisation d'un fichier de correspondances personnalisé SharePoint).

    3. CES 7.0.6830+ (juillet 2014) Dans la liste déroulante Crawl Scope, sélectionnez l'option pour le type de contenu que vous souhaitez analyser en relation avec la source Addresses que vous avez spécifié (voir ci-dessus).

      Sélectionnez WebApplication, la valeur par défaut et le plus haut type d'élément dans la hiérarchie de la batterie SharePoint pour tout analyser.

      Valeur Contenu à analyser
      WebApplication Toutes les collections de sites de l'application web spécifiée
      SiteCollection Tous les sites web de la collection de sites spécifiée
      WebAndSubWebs Seulement le site web spécifié et ses sous-sites
      List Seulement la liste ou la bibliothèque de documents spécifiée
    4. Dans la liste déroulante Authentication Type, référez-vous au tableau suivant pour sélectionner la valeur du type d'authentification qui correspond à votre environnement SharePoint et le type d'Identité d'utilisateur que vous avez assigné à cette source (voir Vue d'ensemble du déploiement du connecteur Microsoft SharePoint).

      Environnement SharePoint Type d'Identité d'utilisateur Option à sélectionner
      Classique Compte Windows
      (SharePoint 2010 par défaut)
      WindowsClassic
      Claims Compte Windows
      (SharePoint 2013 par défaut)
      WindowsUnderClaims
      Compte fédéré ADFS AdfsUnderClaims
      Online Compte Office 365 natif SpOnlineNative
      Compte Office 365 à authentification unique SpOnlineFederated
    5. Dans la section Paramètres (Parameters), cliquez sur Ajouter un paramètre (Add Parameter) si vous souhaitez afficher et configurer des paramètres de source avancés qui sont cachés (voir Modification de paramètres de source cachés de Microsoft SharePoint).

      Exemple : Dans le cas d'un environnement ADFS, lorsque la valeur du paramètre Authentication Type est soit AdfsUnderClaims ou SpOnlineFederated, vous devez ajouter des paramètres cachés liés à ADFS (voir Paramètres connexes ADFS).

      Notes : Vous pouvez configurer le fournisseur de sécurité pour qu'il fonctionne lorsque plusieurs serveurs ADFS sont utilisé afin d'authentifier des utilisateurs dans SharePoint. [more]

    6. Dans la section Option:

      Indexer les sous-dossiers (Index Subfolders)

      Gardez cette case cochée (recommandé). En procédant ainsi, tous les sous-dossiers de l'adresse de serveur spécifiée sont indexés.

      Indexer les métadonnées des documents (Index the document's metadata)

      Lorsque sélectionné, CES indexe toutes les métadonnées du document, mêmes celles qui ne sont pas associées à un champ. Les métadonnées orphelines sont ajoutées au body du document afin qu'elles puissent être recherchées à l'aide de requêtes en texte libre.

      Lorsque non-coché (par défaut), seules les valeurs de champs système et personnalisés dont l'attribut Requêtes textuelles est sélectionné pourront être recherchées sans l'aide d'une requête de champ (voir Ajout d'un champ à utiliser pour la recherche et Que sont les requêtes par champs et les requêtes en texte libre?).

      Exemple : Un document contient deux métadonnées :

      • LastEditedBy, renfermant la valeur Hector Smith

      • Department, renfermant la valeur RH

      Dans CES, le champ personnalisé CorpDepartment est lié à la métadonnée Department, et son attribut Free Text Queries est sélectionné.

      Si l'option Indexer les métadonnées des documents n'est pas cochée, rechercher RH retourne le document, car un champ indexe cette valeur. Rechercher hector ne retourne pas le document, car aucun champ n'indexe cette valeur.

      Si l'option Indexer les métadonnées des documents est sélectionnée, rechercher hector retourne également le document, car CES a indexé les métadonnées orphelines.

      Les adresses de document sont sensibles à la casse (Document's addresses are case-sensitive)

      Laissez la case décochée. Ce paramètre doit être coché seulement, dans de rares situations, pour les systèmes sensibles à la casse dans lesquels des documents distincts peuvent avoir le même nom de fichier, mais une casse différente.

      Générer une version HTML en cache des documents indexés (Generate a cached HTML version of indexed documents)

      Si vous cochez cette case (recommandé), en temps d'indexation, CES crée des versions HTML des documents indexés. Dans les interfaces de recherche, les utilisateurs peuvent alors évaluer plus rapidement le contenu en cliquant sur le lien Aperçu rapide plutôt qu'en ouvrant le document d’origine avec l'application originale. Pensez à décocher cette case seulement si vous ne souhaitez pas utiliser les liens Aperçu rapide.

      Ouvrir les résultats avec la version cache (Open results with cached version)

      Laissez cette case décochée (recommandé) afin que, dans les interfaces de recherche, le lien principal de résultats de recherche ouvre le document d'origine avec l'application originale. Vous devriez cocher cette case seulement si vous ne souhaitez pas que les utilisateurs puissent ouvrir le document original, mais qu'ils ne voient que la version HTML du document en tant qu'Aperçu rapide. Dans ce cas, vous devez également sélectionner Générer une version HTML en cache des documents indexés.

  7. Dans la section Sécurité (Security) de la page Ajouter une source :

    1. Dans la liste déroulante Authentification, sélectionnez l'identité d'utilisateur que vous avez créée pour la batterie Microsoft SharePoint (voir Vue d'ensemble du déploiement du connecteur Microsoft SharePoint).

    2. Dans la liste déroulante Fournisseur de sécurité, sélectionnez le fournisseur de sécurité SharePoint que vous avez créé pour cette source SharePoint.

    3. Cliquez sur Enregistrer (Save) afin d'enregistrer la configuration de la source, et considérez la révision des paramètres de source avancés avant de commencer l'indexation de la nouvelle source (voir Modification de paramètres de source cachés de Microsoft SharePoint).

      OU

    4. Cliquez sur Enregistrer et activer (Save and Start) pour enregistrer et activer l'indexation immédiatement.

Note : Lorsque votre application web de SharePoint utilise Claims, la première fois qu'une personne accède à l'interface de recherche SharePoint, la page de première installation apparaît afin de vous laisser saisir vos informations de Claims et permettre l'accès à l'interface de recherche (voir Si l'interface de recherche Coveo est installée sur un serveur comme SharePoint qui utilise Claims afin d'authentifier les utilisateurs, dans la section Paramètres d'authentification Claims (Claims-Based Authentication Settings) qui apparaît :).

Prochaines étapes?

Définissez un horaire d'actualisation incrémentale pour votre source (voir Planification d'une actualisation incrémentale de source).