Salesforce

Parcourir les documents qui sont stockés dans Salesforce.

IBM Cloud Pak for Data IBM Software Hub

Ces informations ne s'appliquent qu'aux déploiements installés. Pour plus d'informations sur la connexion à Salesforce à partir d'un déploiement géré, voir Salesforce.

Quels sont les documents explorés ?

  • Les Knowledge Articles ne sont explorés que si leur version est publiée et que leur langue est en-us.
  • Seuls les documents pris en charge par Discovery sont explorés ; tous les autres sont ignorés. Pour plus d'informations, voir Types de fichiers pris en charge.
  • Lorsqu'une source est réexplorée, les nouveaux documents sont ajoutés, les documents mis à jour sont modifiés dans leur version actuelle et les documents supprimés sont effacés de l'index de la collection pendant l'actualisation.
  • Tous les Discovery connecteurs de sources de données sont en lecture seule. Quelles que soient les autorisations accordées au compte d'exploration, Discovery n'écrit, ne met à jour ou ne supprime jamais de contenu dans la source de données d'origine.

Discovery peut explorer les objets suivants :

  • Tous les objets par défaut et personnalisés auxquels vous avez accès
  • Comptes
  • contacts ;
  • Cas
  • Contrats
  • Articles de connaissance
  • Pièces jointes

Configuration requise pour les sources de données

En plus des conditions requises pour la source de données pour tous les déploiements installés, votre Salesforce source de données doit répondre aux conditions suivantes :

  • L'instance à laquelle vous souhaitez vous connecter doit faire partie d'un plan Entreprise ou d'un plan supérieur.
  • Vous devez obtenir toutes les licences de service requises pour la source de données à laquelle vous souhaitez vous connecter. Pour plus d'informations sur les licences, contactez l'administrateur système de la source de données.

Pour plus d'informations sur Salesforce, voir la Salesforce documentation pour les développeurs.

Etape de prérequis

Pour explorer les documents dans Salesforce, Discovery utilise un fichier WSDL (Web Service Description Language). Le fichier WSDL définit un service Web pour générer une API qui gère l'accès.

Si vous prévoyez d'extraire des documents d'une instance Sandbox et d'une instance Production de Salesforce, vous devez établir une connexion à chaque service web séparément. Vous devez télécharger les fichiers JAR de chaque service web et créer des collections distinctes.

Pour plus d'informations sur le téléchargement des fichiers JAR WSDL, consultez les liens suivants :

  1. Téléchargez les fichiers JAR suivants :

    • force-partner.jar (du partenaire WSDL )
    • force-metadata.jar (de métadonnées WSDL)
    • force-wsc.jar (de Force.com Web Service Connector (WSC))
    • commons-beanutils.jar (Apache Commons BeanUtils)

  2. Compressez les fichiers JAR dans un fichier compressé. Vous téléchargerez le fichier compressé vers Discovery dans la procédure suivante.

Connexion à une source de données Salesforce

À partir de votre projet d' Discovery, suivez les étapes suivantes :

  1. Dans le volet de navigation, choisissez Gestion des collections.

  2. Cliquez sur Nouvelle collection.

  3. Cliquez sur Salesforce, puis sur Suivant.

  4. Nommez la collection.

  5. Si la langue des documents dans Salesforce n'est pas l'anglais, sélectionnez la langue appropriée.

    Pour obtenir la liste des langues prises en charge, voir Langues prises en charge.

  6. En option: Modifier le calendrier de synchronisation.

    Pour plus d'informations, voir Options de planification du ramassage.

  7. Dans la section Spécifiez ce que vous voulez explorer, entrez des valeurs dans les champs suivants :

    Nom d'utilisateur
    Le nom d'utilisateur pour appeler l'API d' Salesforce.
    Mot de passe
    Mot de passe de l'utilisateur indiqué.
    Jeton de sécurité
    Le jeton de sécurité de l'utilisateur pour appeler l'API Salesforce.
    Fichier d'archive zip Jar
    Téléchargez un fichier compressé contenant les fichiers JAR que vous avez téléchargés précédemment. Vous pouvez également sélectionner un fichier compressé que vous avez téléchargé précédemment pour le réutiliser.

  8. Optionnel: Développez la section Paramètres proxy pour ajouter les informations requises si vous utilisez un serveur proxy pour accéder au serveur de la source de données.

    • Activer les paramètres du proxy: mettez le commutateur sur On, puis ajoutez les informations suivantes :

      Nom d'utilisateur
      Le nom d'utilisateur du serveur proxy à utiliser pour s'authentifier, si le serveur proxy requiert une authentification. Si vous ne connaissez pas votre nom d'utilisateur, vous pouvez l'obtenir auprès de l'administrateur de votre serveur proxy.
      Mot de passe
      Le mot de passe du serveur proxy à utiliser pour s'authentifier, si le serveur proxy requiert une authentification. Si vous ne connaissez pas votre mot de passe, vous pouvez l'obtenir auprès de l'administrateur de votre serveur proxy.
      Nom d'hôte ou adresse IP du serveur proxy
      Le nom d'hôte ou l'adresse IP du serveur proxy.
      Numéro de port du serveur proxy
      Le port réseau auquel vous souhaitez vous connecter sur le serveur proxy.

  9. Dans la section Object Types*, indiquez les types d'objets à extraire.

    Par défaut, tous les types d'objets sont explorés.

    • Pour les noms d'objet personnalisé, ajoutez __c pour respecter la convention d'API Salesforce pour les noms d'objet personnalisé. Par exemple, pour crawler MyCustomObject, spécifier MyCustomObject__c.
    • Ne spécifiez pas un objet commentaire, tel que FeedComment, CaseComment, IdeaComment, sans spécifier également l'objet racine correspondant, tel que FeedItem, Case, et Idea.
    • Si vous spécifiez un objet de balise, vous devez également spécifier son parent. Par exemple, ne pas spécifier l'objet AccountTag sans spécifier également l'objet Account.

  10. Si vous souhaitez que le robot extraie le texte des images du site, développez Plus de paramètres de traitement, et réglez Appliquer la reconnaissance optique de caractères (OCR) sur On.

    Lorsque l'OCR est activé et que vos documents contiennent des images, le traitement prend plus de temps. Pour plus d'informations, voir Reconnaissance optique des caractères.

  11. Cliquez sur Terminer.

La collection est créée rapidement. Le traitement des données prend plus de temps au fur et à mesure qu'elles sont ajoutées à la collection.

Si vous souhaitez vérifier l'état d'avancement du projet, rendez-vous sur la page Activité. Dans le volet de navigation, cliquez sur Gestion des collections, puis sur pour ouvrir la collection.