Communauté

Doc produitsMenu

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

Configuration et indexation d'une source Lithium

Une source définit un groupe de paramètres de configuration pour une communauté Lithium spécifique. Si vous souhaitez indexer plus d'une communauté Lithium, configurez une source pour chaque site communauté.

Pour configurer et indexer une source avec le connecteur Lithium

  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.

  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 du connecteur.

      Exemple : Lithium Community

      Type de source

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

      Adresses

      Tapez l'URL de la communauté Lithium à indexer. Ne tapez qu'une adresse de communauté Lithium. Créez d'autres sources pour d'autres communautés. Le connecteur prend en charge les sites sécurisés (

      Exemples : Les adresses de communautés Lithium peuvent être :

      • http://companymname.lithium.com/

      • https://community.companyname.com/

      Vous pouvez également spécifier d'analyser seulement un sous-groupe d'une communauté Lithium en copiant et collant l'adresse d'une catégorie, d'un tableau ou d'un fil de Lithium. L'URL est de cette forme :

      http://community.company.com/[..]/lithiumobjectlabel/objectid

      où les valeurs possibles de lithiumobjectlabel sont données dans la colonne Label dans le tableau suivant.

      Libellé Objet Lithium
      ct-p Catégorie
      tkbc-p Catégorie de base de connaissances
      bd-p Forum
      tkb-p Base de connaissances
      con-p Questionnaire
      idb-p Tableau d'idées
      qa-p Tableau de questions et réponses
      bg-p Blog
      gp-p Groupe
      m-p

      CES 7.0.7599+ (avril 2015) Forum de discussion

      td-p Fil de forum
      ta-p Article de la base de connaissances
      cns-p Soumission de questionnaire
      idi-p Idée
      qaq-p Question des questions et réponses
      ba-p Article de blog
      gpm-p Article de groupe

      Exemple : Dans la communauté Lenovo de Lithium, l'adresse suivante est celle du forum CES2014 :

      http://forums.lenovo.com/t5/Lenovo-CES-2014/bd-p/CES2014

      Champs (Fields)

      Si vous avez créé un groupe de champs Lithium personnalisé, sélectionnez-le (voir Vue d'ensemble du déploiement du connecteur Lithium). Sinon, laissez le Default Scheme.

      Horaire d'actualisation (Refresh Schedule)

      Sélectionnez l'intervalle de temps à laquelle une actualisation complète de la source est automatiquement effectuée afin de garder le contenu de l'index à jour (voir Actualisation complète).

      Le connecteur Lithium ne prend pas en charge l'actualisation incrémentale. Par conséquent, l’horaire d’actualisation complète est le seul processus qui maintient votre source à jour.

    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 une ancienne communauté Lithium, 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 de langues personnalisés, veillez à sélectionner celui qui convient le mieux à cette source (voir Ajout et configuration d'un groupe de langues).

  6. Dans la section Paramètres et options spécifiques au connecteur (Specific Connector Parameters & Options) de la page Ajouter une source (Add Source) :

    1. Vérifiez si vous devez changer les valeurs par défaut des paramètres suivants :

      Nombre de fils d'exécution (Number of Refresh Threads)

      Détermine le nombre de téléchargements simultanés que le connecteur prend en charge pour cette source. La valeur par défaut est 2.

      Fichier de correspondances (Mapping File)

      Le chemin d'accès vers le fichier de correspondances. Laissez la valeur par défaut pour utiliser le fichier de correspondances par défaut qui vient avec le connecteur (Coveo.CES.CustomCrawlers.Lithium.MappingFile.xml). Si vous créez un fichier de correspondances personnalisé, saisissez le chemin d'accès complet vers votre fichier de correspondances personnalisé. Contactez Assistance Coveo pour obtenir de l'aide si vous avez besoin de personnaliser le fichier de correspondances.

    2. Dans la section Paramètres (Parameters), cliquez sur Ajouter un paramètre (Add Parameter) afin de pouvoir changer la valeur par défaut des paramètres cachés (voir Modification de paramètres de source cachés de Lithium).

      Note : Lorsque vous souhaitez indexer le contenu d'une communauté Lithium qui est sécurisé avec l'authentification par formulaires, ajoutez les paramètres cachés qui sont affichés dans le tableau suivant (voir Modification de paramètres de source cachés de Lithium).

      Paramètre caché Valeur
      AuthenticationFormId si n'est pas par défaut (form)
      LoginPageUrl L'URL de la page de connexion
      LoginFieldName si n'est pas par défaut ()login
      PasswordFieldName si n'est pas par défaut (password)
      UseFormAuthenticationToFetchAttachments true

    3. Dans la section Option, évaluez la valeur par défaut des options à cocher suivantes :

      Indexer les sous-dossiers (Index Subfolders)

      Cochez afin d'indexer tous les sous-dossiers situés sous l'adresse spécifiée de serveur Lithium. Sélectionné par défaut.

      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. Vous devriez décocher ces cases seulement si vous ne souhaitez pas utiliser les liens Aperçu rapide ou si vous souhaitez enregistrer des ressources pendant la génération de la source.

      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 (Authentication) :

      • Lorsque vous souhaitez indexer du contenu sécurisé de Lithium, sélectionnez l'identité d'utilisateur que vous avez créée pour indexation par la communauté Lithium.

        OU

      • Lorsque vous indexez une communauté publique de Lithium, sélectionnez (aucun).

    2. Cliquez sur Enregistrer (Save) pour enregistrer la configuration de la source.

  8. Étant donné que le connecteur Lithium ne prend pas en charge l'indexation de permissions d'éléments Lithium, vous devez plutôt définir les permissions de façon globale dans la source :

    Note : Vous obtenez le message d'erreur suivant dans la Console CES lorsque vous tentez d'indexer les permissions d'une source de communauté Lithium.

    Error with ID 'LITHIUM_INVALID_CONFIGURATION': Permissions indexing is not provided by the Lithium connector

    1. Dans le panneau de navigation à gauche, sélectionnez Permissions.

    2. Dans la page Permissions :

      1. Sélectionnez l'option Précise les permissions de sécurité à indexer.

      2. Facultativement, dans la liste Utilisateurs autorisés, ajoutez ou retirez des utilisateurs ou des groupes afin de spécifier précisément qui a accès au contenu de cette source. Par défaut, le groupe everyone d'Active Directory spécifie que tout utilisateur d'AD peut voir l'ensemble du contenu de cette source.

      3. Facultativement, dans la liste Utilisateurs refusés, ajoutez ou retirez des utilisateurs ou des groupes afin de spécifier qui n'a pas accès au contenu de cette source.

      4. Cliquez sur Appliquer les modifications.

  9. Dans la barre d'outils, cliquez sur Start/Rebuild pour débuter l'indexation de votre source.

  10. Confirmez que le processus de génération de la source est exécuté sans erreur :

    • Dans le panneau de navigation situé à gauche, cliquez sur État, puis confirmez que l'indexation se fait sans erreur.

      OU

    • Ouvrez la console CES afin de surveiller les activités de génération de la source (voir Utilisation de la Console CES.