Configuration et indexation d'une source Liferay

Une source définit un groupe de paramètres de configuration pour un portail Liferay spécifique.

Note : Dans un environnement avec plus d'un portail Liferay, vous devriez définir une source pour chaque portail Liferay que vous souhaitez indexer.

Pour configurer et indexer une source Liferay

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 (Name)

      Tapez un nom descriptif de votre choix pour la source du connecteur.

      Exemple : Portail Liferay

      Type de source

      Sélectionnez le connecteur utilisé par cette source. Dans ce cas, sélectionnez Liferay.

      Note : Si vous n'apercevez pas Liferay, votre environnement ne rencontre pas les exigences (voir Exigences du connecteur Liferay).

      Adresses

      Saisissez l'adresse racine du portail Liferay dans le format :

      http://[serverName]:[port]/

      où vous remplacez [serverName]:[port] par le nom d'hôte et le port de votre portail Liferay. Le port par défaut est 8080. Le port est facultatif s'il est égal à 80.

      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. L'option recommandée Every day donne à CES (Coveo Enterprise Search) la consigne d'actualiser la source chaque jour, à minuit.

      Note : L'actualisation incrémentale n'attrape pas les modifications aux éléments de sécurité et de fichiers joints. Seule une actualisation peut faire ceci.

      Note : Vous pouvez créer de nouveaux horaires d'actualisation de source ou modifier ceux qui existent (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 une source remplace un ancien système, vous devriez définir ce paramètre à Élevée afin que, dans l'interface de recherche, les résultats de cette source apparaissent plus tôt dans la liste, contrairement à ceux des sources de l'ancien système.

      Types de document (Document Types)

      Si vous avez défini un groupe personnalisé de types de documents pour cette source, sélectionnez-le (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 convient le mieux à cette source (voir Ajout et configuration d'un groupe de langues).

      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 et options spécifiques au connecteur (Specific Connector Parameters & Options) de la page Ajouter une source (Add Source) :

   

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

      Fichier de correspondances (Mapping File)

      Laissez ce champ vide afin d'utiliser le fichier de correspondances par défaut (voir À propos du fichier de correspondances du connecteur Liferay). Si vous créez un fichier de correspondances personnalisé, saisissez le chemin d'accès complet qui pointe vers votre fichier (voir Personnalisation du fichier de correspondances du connecteur Liferay).

      Exemple : C:\CES7\Config\MyLiferayMappingFile.xml

      Indexer les Blogs (Index Blogs)

      Si les articles de blogue, dont leurs commentaires, devraient être indexés ou non.

      Indexer les Calendriers (Index Calendars)

      Si les événements de calendrier, dont leurs commentaires, devraient être indexés ou non.

      Indexer les Librairies de Documents (Index Document Libraries)

      Si les fichiers de librairies de documents, dont leurs commentaires, devraient être indexés.

      Indexer les Forums de Discussions (Index Message Boards)

      Si les messages de forums de discussion, dont leurs fichiers joints, devraient être indexés.

      Indexer les Usagers (Index Users)

      Si les profils d'utilisateurs devraient être indexés ou non.

      Indexer le Contenu Web (Index Web Content)

      Si le contenu Web, précédemment connu sous le nom de journaux, devrait être indexé ou non.

      Indexer les Wikis (Index Wikis)

      Si les pages Wiki, dont leurs fichiers joints et leurs commentaires, devraient être indexées ou non.

      Authentication

      Sélectionnez l'identité d'utilisateur que vous avez précédemment créée pour le portail Liferay.

      Paramètres (Parameters)

      Cliquez sur Ajouter un paramètre (Add Parameter) si vous souhaitez afficher des paramètres de source avancés (voir Modification de paramètres de source cachés de Liferay).

      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 portail 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 dans lesquels des documents distincts peuvent avoir le même nom, 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. 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 Fournisseur de sécurité (Security Provider), sélectionnez le fournisseur de sécurité que vous avez créé pour cette source (voir Configuration d'un fournisseur de sécurité Liferay).

   2. Dans la liste déroulante Authentification (Authentication), sélectionnez l'identité d'utilisateur que vous avez créée pour le portail Liferay.

   3. Cliquez sur Enregistrer et activer (Save and Start) pour sauvegarder la configuration de la source et débuter l'indexation de cette source.

8. 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.