Configuration et indexation d'une source Salesforce

Une source définit un ensemble de paramètres de configuration pour une base de données Salesforce spécifique.

Note : Lorsque vous avez accès à plus d'une organisation Salesforce, vous devez définir une source pour chaque organisation Salesforce que vous souhaitez indexer.

Pour configurer et indexer une source Salesforce

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

      Un nom descriptif de votre choix pour la source du connecteur.

      Exemple : Lorsque la source ne contient que des objets Salesforce réguliers, vous pouvez taper : MyCompany Salesforce Organization (Standard Objects)

      Type de source

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

      Notes :

      • Si vous ne voyez pas Salesforce dans la liste Type de source, veillez à ce que votre environnement réponde aux exigences (voir Exigences du connecteur Salesforce).

      • CES 7.0.5785– (juillet 2013) L'élément Salesforce correspond au type de source maintenant identifié sous Salesforce (Legacy) (voir Ancien connecteur Salesforce).

      Adresses

      Tapez l'URL du site web de Salesforce : https://www.salesforce.com/

      Champs (Fields)

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

      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 Every day (Chaque jour) demande à CES (Coveo Enterprise Search) d'actualiser la source chaque jour, à minuit (voir Quelle devrait être la fréquence des horaires d'actualisation de la source?).

      L'actualisation incrémentale s'occupe de garder la source à jour afin que vous puissiez sélectionner une intervalle plus longue, telle que Every Sunday (Chaque dimanche). Pour une source CRM Content, puisque les éléments supprimés ne peuvent être détectés par des actualisations incrémentales, vous devriez sélectionner une intervalle plus courte.

      Astuce : Après que vous créiez ou modifiez la configuration de la source, et pour chaque actualisation incrémentale pour des éléments modifiés ou nouveaux, une source Coveo effectue le nombre suivant d'appels API à votre organisation Salesforce :

      • Un appel API par près de 1 000 objets

      • Un appel API par fichier joint

      • Un appel API par près de 1 000 utilisateurs

      • Un appel API par ensemble de groupes/rôles/profils/permissions

      Avec une utilisation normale, ces appels n'atteindront pas à eux seuls la limite quotidienne d'appels API établie par l'organisation Salesforce.

      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 : Lorsque cette source indexe un nouveau référentiel qui remplace un ancien, vous devriez définir ce paramètre à Élevée afin que dans l'interface de recherche, des résultats de cette source apparaissent plus tôt dans la liste, en comparaison avec ceux 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 est le plus approprié pour la source.

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 les paramètres suivants :

      Fichiers ObjectsToGet (ObjectsToGet File)

      Saisissez le(s) chemin(s) d'accès complet(s) absolu(s), pointant vers l'endroit où vous avez enregistré le fichier de configuration ObjectsToGet personnalisé que vous avez créé (voir Création d'un fichier de configuration ObjectsToGet de Salesforce). Lorsque vous avez plus d’un fichier de configuration ObjectsToGet, séparez les chemins d’accès complets avec un point-virgule (;).

      Note : CES 7.0.6830– (juillet 2014) Le paramètre ne pouvait contenir qu’un chemin d’accès.

      Exemple : D:\CES7\Config\SalesforceObjectsToGet.xml;D:\CES7\Config\SalesforceObjectsToGet2.xml

      Client ID

      Saisissez la clé de client de l'organisation Salesforce que vous souhaitez indexer (voir Obtention des valeurs Client_ID et Client_Secret de Salesforce).

      Client Secret

      Saisissez la clé de client de l'organisation Salesforce que vous souhaitez indexer (voir Obtention des valeurs Client_ID et Client_Secret de Salesforce).

      Fichier de correspondances (Mapping File)

      Laissez ce paramètre vide lorsque vous souhaitez lier automatiquement toutes les métadonnées disponibles de Salesforce à des champs CES à l’aide du même nom

      Si vous avez créé un fichier de correspondances, entrez le chemin d'accès complet absolu qui pointe vers l'endroit où vous avez enregistré le fichier de correspondances que vous avez créé (voir Création d'un fichier de correspondances Salesforce).

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

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

      Lorsque nécessaire, modifiez le nombre de téléchargements simultanés que le connecteur peut gérer. La valeur par défaut est 2.

      Sandbox

      Sélectionnez cette option seulement lorsque vous souhaitez que le connecteur se connecte à votre sandbox Salesforece (test.salesforce.com) plutôt que votre environnement de production Salesforece (login.salesforce.com).

      Utilise un RefreshToken (Use Refresh Token)

      Ne cochez pas Use Refresh Token, sauf si vous souhaitez utiliser le mode d'authentification de rafraîchissement du jeton. Cette méthode est habituellement utilisée si une application configure la source (comme dans la plateforme en nuage de Coveo).

   2. 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 Salesforce).

   3. Dans la section Option, l'état des boîtes à cocher n'a pas besoin, en général, d'être modifié.

      Indexer les sous-dossiers (Index Subfolders)

      Gardez cette case cochée (recommandé). Ainsi, tous les sous-dossiers de l'adresse de départ 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) :

      Note : Le fournisseur de sécurité sélectionné doit avoir les mêmes valeurs que cette source pour les paramètres Client ID, Client Secret, et Sandbox.

      1. Pour des objets et champs standards et des sources CRM Content, sélectionnez le fournisseur de sécurité que vous avez créé pour cette source (voir Configuration d'un fournisseur de sécurité Salesforce).

      2. Pour une source de la base de connaissances, sélectionnez (Aucun), car aucun fournisseur de sécurité n'est nécessaire pour ce type de source.

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

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

8. Lorsque la source est pour des articles de la base de connaissances, vous devez ajouter des permissions au niveau de la source (voir Modification des permissions de sécurité de la source).

9. Régénérez la source (voir Indexation manuelle de sources).

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.