Communauté

Doc produitsMenu

Configuration et indexation d'une source Google Drive for Work

Une source définit un ensemble de paramètres de configuration pour un compte Google Apps for Work spécifique.

Pour configurer et indexer une source Google Drive for Work

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

      Exemple : Google Drive for Work

      Type de source

      Sélectionnez le connecteur utilisé par cette source. Dans ce cas, sélectionnez Google Drive (Google Apps).

      Notes :

      Adresses

      Ce paramètre n'est pas utilisé, mais ne doit pas être vide. Tapez http://www.google.com.

      Champs (Fields)

      Sélectionnez le groupe de champs que vous avez créé pour votre source Google Drive (voir Vue d'ensemble du déploiement du connecteur Google Drive for Work).

      Horaire d'actualisation (Refresh Schedule)

      Intervalle de temps à laquelle l'index est automatiquement actualisé afin de garder le contenu de l'index à jour. Par défaut, l'option Chaque jour (Every day) force CES à actualiser la source chaque jour, à minuit. Étant donné que l'actualisation incrémentale s'occupe de garder la source à jour, vous pouvez sélectionnez une intervalle plus longue, comme Every Sunday (Chaque dimanche) (voir Quelle devrait être la fréquence des horaires d'actualisation de la 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).

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

    1. Dans la boîte Fichier de correspondances (Mapping File), vous pouvez entrer le chemin d'accès d'un fichier de correspondances qui devrait s'appliquer aux éléments dans la source.

      Laissez la boîte vide afin d'utiliser la correspondance par défaut qui devrait convenir dans la plupart des cas.

      Si la correspondance par défaut ne remplit pas vos besoins, contactez Coveo Support pour obtenir de l'aide. Votre fichier de correspondances XML doit respecter le schéma standard du fichier de correspondances Coveo (voir Schéma standard d'un fichier de correspondances).

      Exemple : D:\CES7\Config\GoogleAppsMappingFile.xml

    2. CES 7.0.7433+ (février 2015) Configurez ce paramètre :

      Domain Admin e-mail

      Saisissez le courriel du compte de l’administrateur du domaine qui est utilisé pour obtenir la liste des utilisateurs dans le domaine.

      Exemple : admin@domain.com

      Note : Le courriel que vous saisissez ici doit être le même que celui que vous avez saisi précédemment en configurant le fournisseur de sécurité (voir Configuration d'un fournisseur de sécurité Google Drive for Work).

    3. À l'aide des paramètres suivants, autorisez le robot Coveo à accéder au Google Drive de vos utilisateurs :

      Domaine(s) (Domain(s))

      Tapez le domaine Google Drive que vous souhaitez indexer. Si votre compte Google Apps contient plus d'un domaine, vous pouvez taper une liste de domaines, séparés par des points-virgules, à indexer.

      Exemples :

      • Un domaine : mydomain.com

      • Plusieurs domaines : myfirstdomain.com;my.second.domain.com

      Important : Le(s) domaine(s) spécifié(s) dans cette liste doit (doivent) correspondre à celui (ceux) spécifié(s) dans la liste [Domain-wide mode] Managed domains du fournisseur de sécurité (voir Configuration d'un fournisseur de sécurité Google Drive for Work).

      Service account e-mail

      Tapez l'adresse courriel du 'service accout' précédemment obtenue (voir Autorisation du connecteur Coveo à accéder à votre Google Drive). Il doit s’agir du même courriel que vous avez entrée en configurant le fournisseur de sécurité (voir Configuration d'un fournisseur de sécurité Google Drive for Work).

      Exemple : 12345678901@developer.gserviceaccount.com

      Service account PCKS12 file path

      Note : CES 7.0.7599+ (avril 2015) Ce paramètre n’est plus obligatoire et peut rester vide lorsque vous utilisez le paramètre caché ServiceAccountPkcs12FileData (voir Modification de paramètres de source cachés Google Drive for Work Source).

      Tapez le chemin d'accès dans le serveur maître Coveo où vous avez enregistré le fichier de clé privée PCKS12 précédemment obtenue du compte de service (voir Autorisation du connecteur Coveo à accéder à votre Google Drive). Il doit s’agir du même chemin d'accès que vous avez entré en configurant le fournisseur de sécurité (voir Configuration d'un fournisseur de sécurité Google Drive for Work).

      Exemple : D:\CES7\Config\1234ab8e315e67a89e02f16ea38bd44d609471ff-privatekey.p12

    4. Sélectionnez le type de contenu à indexer à l'aide des options suivantes :

      Récupérer les poubelles (Crawl trashed items)

      Sélectionnez afin d'indexer les éléments dans la poubelle de l'utilisateur. Non-sélectionné par défaut.

      Récupérer les propriétés personnalisées (Crawl custom properties)

      Sélectionnez pour indexer les propriétés personnalisées que les applications Google ou vos applications personnalisées ont ajoutées sur les éléments. Non-sélectionné par défaut.

      Note : Récupérer les propriétés personnalisées ajoute un appel API par document indexé. Sélectionner cette option peut augmenter de façon notable le nombre d'appels vers l'API de Google Drive et le temps de récupération.

    5. Cliquez sur Ajouter un paramètre (Add Parameter) si vous souhaitez afficher et modifier la valeur de paramètres de source avancés (voir Modification de paramètres de source cachés Google Drive for Work Source).

    6. Les cases à cocher Option n'ont généralement pas besoin d'être modifiés :

      Indexer les sous-dossiers (Index Subfolders)

      Ce paramètre n'est pas pris en compte pour ce connecteur.

      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)

      Veillez à ce que cette option soit sélectionnée, car les identifiants des documents de Google Drive sont sensibles à la casse.

      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. Lorsque vous choisissez d'indexer des permissions de Google Drive, dans la liste déroulante Fournisseur de sécurité (Security Provider), sélectionnez le fournisseur de sécurité Google Drive for Work que vous avez créé pour cette source (voir Configuration d'un fournisseur de sécurité Google Drive for Work).

    2. Dans la liste déroulante Authentification (Authentication) :

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

  9. Si vous choisissez de ne pas indexer de permissions Google Drive, vous pouvez définir des permissions au niveau de la source qui s'appliquent à tous les documents dans la source :

    1. Dans le panneau de navigation situé à gauche, cliquez sur Permissions.

    2. Dans la page Permissions, sélectionnez Précise les permissions de sécurité à indexer.

    3. Dans les boîtes Utilisateurs autorisés et Utilisateurs non autorisés, tapez les utilisateurs et les groupes qui ont la permission ou non, respectivement, de voir les résultats de recherche de cette source. Par défaut, permettre everyone \S-1-1-0\ (Active Directory Group).

    4. Cliquez sur Appliquer les modifications.

  10. Lorsque vous êtes prêt à débuter l'indexation de la source Google Drive, cliquez sur Régénérer.

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

Prochaines étapes?

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

Pensez à modifier certains paramètres de source masqués afin d'essayer de régler d'autres problèmes (voir Modification de paramètres de source cachés Google Drive for Work Source).