Configuration et indexation d'une source Sitecore pour l'ancien connecteur

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 de l'ancien connecteur SharePoint.

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 la source.

      Exemple : SharePoint Intranet

      Type de source

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

      Note : CES 7.0.6767– (juin 2014) Le type de fournisseur de sécurité SharePoint Legacy est nommé SharePoint.

      CES 7.0.6830+ (juillet 2014) Le type SharePoint correspond maintenant au fournisseur de sécurité à utiliser avec le connecteur SharePoint de deuxième génération (voir Création d'un fournisseur de sécurité SharePoint).

      Adresses

      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.

      Exemples :

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

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

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

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

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

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

      Horaire d'actualisation (Refresh Schedule)

      Intervalle de temps à laquelle l'index est automatiquement actualisé afin de garder le contenu de l'index à jour. L'actualisation incrémentale s'occupe continuellement de l'indexation des modifications en cours du contenu SharePoint. Vous pouvez actualiser la source chaque semaine en sélectionnant l'option Every Sunday.

      Note : Vous pouvez créer de nouveaux horaires d'actualisation de source ou modifier ceux qui existent déjà (voir Création ou modification d'un horaire de source).

   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.

      Champs (Fields)

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

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 liste déroulante Références SharePoint (SharePoint References), sélectionnez le bon groupe de références SharePoint pour cette source.

      Note : Vous pouvez définir des références SharePoint personnalisées (voir Que sont les groupes de références SharePoint? et Ajout d'un groupe de références SharePoint).

   2. Dans la section Option:

      Indexer les sites personnels (Index personal sites)

      Lorsque sélectionné, cette option indexe tous les sites personnels de la batterie de serveurs SharePoint. Cette option est sélectionnée par défaut.

      Indexer les profils d'utilisateur (Index user profiles)

      Lorsque sélectionné, cette option indexe tous les profils d'utilisateur de la batterie de serveurs SharePoint. Cette option est sélectionnée par défaut.

      Notes : L’indexation de profils d’utilisateurs peut prendre beaucoup de temps selon leur nombre. De plus, indexer des profils d’utilisateurs plus d’une fois crée autant de doubles dans votre index. Il est donc recommandé de n’indexer vos profils d’utilisateurs qu’une fois pour toutes vos sources SharePoint :

      • Lorsque vous configurez votre première source SharePoint, laissez la case cochée. Pour toutes vos autres sources SharePoint, décochez-la.

      • Lorsque vous avez déjà une ou plusieurs autres sources SharePoint configurées, recherchez votre plus petite Web Application en taille et décochez Index user profiles pour toutes vos autres sources SharePoint.

      Indexer les sous sites (Index subsites)

      Lorsque sélectionné, cette option indexe les sous sites de façon récursive, à partir des URL saisies dans la boîte Adresses, et traversant des niveaux plus profonds, et ce, jusqu'à ce que chaque document ait été indexé. Cette option est sélectionnée par défaut.

      Exemple : Si l'URL http://intranet/pages/ est saisie dans la boîte Adresses et Indexer les sous sites est sélectionné, les sites web http://intranet/pages/news/ et http://intranet/pages/news/2012/ sont également 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.

      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.

   3. Dans la section Découverte des sites SharePoint (SharePoint Site Discovery), spécifiez quelles collections de sites SharePoint doivent être indexées en sélectionnant l'une des options suivantes :

      Indexer seulement les adresses de départ (Index only starting addresses)

      N'indexe que les sites (et les sous sites si l'option Indexer les sous sites (Index subsites) est sélectionnée) dont les adresses se retrouvent dans la boîte Adresses (Addresses).

      Indexer les adresses de départ et les sites du répertoire de sites du Portail (Index the starting addresses and all sites listed in the Portal Site Directory)

      Indexe les sites (et les sous sites si l'option Indexer les sous sites est sélectionnée) dont les URL se retrouvent dans la boîte Adresses ainsi que tous les sites, liés à ces adresses,

      Indexer l'application Web des adresses de départ (Index the Web application of the starting addresses)

      Indexe toutes les collections de sites des applications Web liées aux adresses de départ. Le choix par défaut.

      Indexer toutes les applications Web ayant le même nom d'hôte (Index all the Web applications having the same host name)

      Indexe toutes les collections de sites de toutes les applications Web liées aux adresses de départ, tant que l'application Web ait le même hôte que ses adresses de départ.

      Note : Le service Web Coveo SharePoint doit être installé dans la batterie de serveurs SharePoint; sinon, le connecteur ne peut retrouver toutes les applications Web (voir Installation du service Web Coveo, de la boîte de recherche et de l'interface de recherche dans SharePoint).

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

   

   1. Dans la liste déroulante Fournisseur de sécurité SharePoint (SharePoint Security Provider), vous devez sélectionner un fournisseur de sécurité de type SharePoint (voir Création d'un fournisseur de sécurité pour l'ancien connecteur SharePoint).

   2. Dans la liste déroulante Authentification (Authentication), sélectionnez l'identité d'utilisateur que vous avez créée pour la batterie de serveurs Microsoft SharePoint.

   3. CES 7.0.5031+ (mars 2013) Dans la section Type d'authentification (Authentication Type), sélectionnez le type d'authentification à utiliser afin d'accéder aux services Web SharePoint:

      Windows (Classique) (Windows (Classic))

      Sélectionnez pour les applications Web qui utilisent l'authentification standard (NTLM ou Kerberos) et non Claims.

      Formulaire (Claims) (Forms (Claims))

      Sélectionnez pour des applications Web activées par Claims qui utilisent l'authentification par formulaire.

      Windows (Claims)

      Sélectionnez pour les applications web activées par Claims et qui utilisent l'authentification Windows (NTLM ou Kerberos).

      AD FS (Claims) CES 7.0.5556+ (juin 2013)

      Sélectionnez pour les applications web activées par Claims qui utilisent ADFS comme fournisseur d'identité approuvé.

      Office 365 (Natif) (Native)

      Sélectionnez pendant l'analyse d'une application Web SharePoint Online à l'aide d'un compte d'utilisateur natif Office 365 (ex. : john@acme.onmicrosoft.com).

      Office 365 (Authentification unique) (Single sign-on)

      Sélectionnez pendant l'analyse d'une application Web SharePoint Online à l'aide d'un compte d'utilisateur à authentification unique Office 365 (ex. : john@acme.com).

   4. CES 7.0.5556+ (juin 2013) Les paramètres reliés ADFS suivants ne sont requis que si le type d'authentification est soit AD FS (Claims) ou Office 365 (Single sign-on):

      1. Dans la boîte Url du serveur AD FS de SharePoint, tapez l'URL du serveur ADFS qui est approuvée par SharePoint.

      2. Dans la boîte Identifiant du 'Trust' avec SharePoint (Trust Identifier for SharePoint), saisissez l'identificateur Relying Party Trust pour l'application web SharePoint (voir Découverte de l'identificateur d'approbation de la partie de confiance dans une application web SharePoint).

      Les paramètres suivants ne sont requis que si plusieurs serveurs ADFS sont utilisés afin d'authentifier des utilisateurs dans SharePoint.

      1. Dans la boîte Url du serveur AD FS Fournisseur d'Identités (URL of the SharePoint AD FS Server), entrez l'URL du serveur ADFS qui est utilisé comme Fournisseur d'identité pour le serveur ADFS approuvé par SharePoint.

      2. Dans la boîte Trust Identifier for the SharePoint AD FS Server, entrez l'identifiant d'approbation de la partie de confiance pour le serveur ADFS de SharePoint (voir Découverte de l'identificateur d'approbation de la partie de confiance dans un serveur AD FS de SharePoint).

   5. 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 pour l'ancien connecteur).

      OU

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

Note : Si votre application Web SharePoint utilise Claims, la première fois que l'interface de recherche SharePoint est atteinte, la page de première installation apparaît avec deux panneaux afin de vous laisser entrer vos informations Claims et permettre l'accès à l'interface de recherche (voir Première installation de Coveo .NET Front-End).