Passer au contenu principal
Adaptive Insights
Knowledge and Support - Adaptive Insights

Configurer une source de données Salesforce

Vous pouvez utiliser Adaptive Integration pour importer des données à partir d’un compte Salesforce , bien que vous ne puissiez pas importer de données à partir de rapports ou de données créés via des intégrations d’applications dans le compte Sales­force .

Pour configurer une Salesforce source de données, procédez comme suit :

  1. Accédez au concepteur de données en allant sur Intégration > Concepteur de données.

  2. À partir du dossier Source de données dans la bibliothèque de composants sur le côté droit de l’écran, cliquez sur Créer une nouvelle source de données.
    La boîte de dialogue de création, s’affiche.

  3. Sélectionnez Salesforce en tant que type de source de données et saisissez le nom de la source de données

  4. Cliquez sur Créer.
    La zone centrale de l’écran affiche les paramètres de votre nouvelle source de données, comme indiqué ci-dessous.

5. Saisissez les informations de la source de données :

  • Nom d’utilisateur : saisissez le nom d’utilisateur pour le compte d'utilisateur Salesforce.
  • Mot de passe : saisissez le mot de passe associé au nom d’utilisateur et au jeton d’authentification Salesforce. Par exemple, si votre mot de pas­se est “redrover1492” et votre jeton d’authentification est “lv4l$Qyfj54gdvzu$9rXL­RqUu((G,” vous devrez saisir “redrover1492lv4l$Qyfj54gdvu$9rXLRqUu((G” dans ce champ.
  • Vous utilisez Sandbox : Cochez cette case pour utiliser le Sandbox Salesforce. Vous ne devez cocher cette case que si votre processus de mise en œuvre nécessite que vous testiez des données dans un sand­box dans le cadre du processus d’importation de données. Veillez à décocher cette case lorsque vous devez importer des données de votre instance de production Salesforce.
  • Fuseau horaire : Sélectionnez un fuseau horaire dans la liste déroulante.
  • Niveau de journal : sélectionnez un niveau de journal dans la liste déroulante pour spécifier les détails de la journalisation pour cette source de données. Vos options sont les suivantes :
    • Erreur : Consigne uniquement les erreurs.
    • Info : Consigne toutes les informations de base, telles que la date à laquelle la source de données a été mise à jour.
    • Verbeux : fournit des informations très détaillées sur toutes les phases et actions. (Ce niveau est principalement utilisé pour le débogage ou l’audit, car il peut produire plus d’informations de journal que nécessaire, pour une utilisation normale.)

6. Cliquez sur Enregistrer dans le menu Actions.

Vous pouvez tester les informations de connexion dans le nouvel agent en cliquant sur Tester la connexion dans le menu Actions . Le système essaie de se connecter à Salesforce en utilisant les informations contenues dans les champs de source de données. Si le système parvient à se connecter à votre compte Salesforce, cliquez sur OK. Si vous rencontrez des problèmes de connexion, contactez le support Adaptive.

Lorsque vous parvenez à vous connecter à Salesforce, vous êtes prêt à importer la structure de données. Cela vous montre les tables et les colonnes dans la base de données.

Pour importer la structure Salesforce procédez de la façon suivante :

  1. Cliquez sur Importer la structure dans le menu Actions . Les tables et les colonnes apparaissent dans le menu Composants de données.

  2. Cliquez sur Fermer pour fermer la boîte de dialogue d’importation de Salesforce.

  3. Cliquez sur Enregistrer dans le menu Actions.

Ajout de tables à une source de données Salesforce

Après avoir importé la structure Salesforce , vous êtes prêt à spécifier les informations que vous souhaitez importer. La section Tables à importer de l’écran vous permet de configurer les données importées à partir du compte Salesforce .

Pour spécifier les tables à importer à partir du compte Salesforce procédez comme suit :

  1. Développez l’entrée pour la source de données dans le menu Composants de données, comme indiqué ci-dessous. (Les composants de données avec une barre oblique à travers leur icône, ne sont pas inclus dans l’importation en cours.)

  1. Faites glisser et déposez les tables que vous souhaitez importer dans la section Tables à importer au centre de l’écran, comme illustré ci-dessous. Lorsque vous faites glisser chaque table vers la section Tables à importer, un onglet apparaît pour la table et les informations du compte de la feuille de calcul s’affichent dans la section Tables à importer, ce qui vous permet de voir le type d’informations ajoutées. (Plusieurs exemples de tables se trouvent ci-dessous.) L’onglet de chaque table comporte également un menu déroulant auquel vous pouvez accéder en cliquant sur la flèche à côté de son nom.


 

Gestion des colonnes

Si une table avec laquelle vous travaillez contient un grand nombre de colonnes, vous pouvez utiliser la commande Gérer les colonnes pour modifier rapidement les colonnes à importer. La boîte de dialogue Gérer les colonnes affiche les colonnes d’une table afin que vous puissiez sélectionner ou désélectionner les colonnes à importer.

Pour gérer les colonnes à importer, procédez comme suit :

  1. Cliquez sur la flèche de l’onglet à droite du nom de la table.
    Un menu flottant avec plusieurs options, s’affiche.

  2. Cliquez sur Gérer les colonnes dans le menu flottant.
    La boîte de dialogue Gérer les colonnes s’affiche.

3. Cochez la case à côté de la colonne que vous souhaitez importer. Lorsque vous sélectionnez une colonne, la colonne apparaît également dans la fenêtre d’aperçu après l’enregistrement du contenu de la fenêtre contextuelle. Si vous désélectionnez une colonne, la colonne est supprimée de la fenêtre d’aperçu.

Vous ne pouvez pas modifier le statut d’importation sur les champs générés par le système, tel que Su­pprimé. Vous pouvez également modifier le statut d’importation sur des col­onnes individuelles en sélectionnant les propriétés de colonne et en définissant la propriété ou en faisant glisser et en déposant les colonnes dans le concepteur.

Personnaliser les tables

Pour chaque table, vous pouvez personnaliser la façon dont les données sont importées.

Pour personnaliser les paramètres de la table, procédez comme suit :

  1. Cliquez sur la flèche de l’onglet à droite du nom de la table.
    Un menu flottant avec plusieurs options, s’affiche.

  2. Cliquez sur Paramètres de la table dans le menu flottant.
    La boîte de dialogue Paramètres de la table s’affiche, comme indiqué ci-dessous.

3. Entrez les paramètres de la table :

  • Filtre d’importation des données : Utilisez-le pour entrer une expression SQL qui filtre ou formate les informations importées. Le filtre SQL est appliqué avant l’extraction des données de la base de données, afin de réduire la quantité de données à importer, vous procurant ainsi un niveau de contrôle supplémentaire pour les données importées dans la zone de stockage. Cliquez sur le champ pour afficher la boîte de dialogue Modifier l’expression SQL, illustrée plus haut. (Le filtre que vous saisissez ici est appliqué aux données réelles dans la base de données plutôt qu’aux données de l’aperçu dans la zone de stockage.) Toutes les sources de données ne prennent pas en charge le même niveau de capacité de fil­trage SQL.
  1. Cliquez sur Appliquer pour appliquer les paramètres.
  2. Répétez les étapes 1 à 3 pour chaque table.
  3. Cliquez sur Enregistrer pour enregistrer les paramètres dans la source de données.

Définition des options de colonne

Lorsque vous utilisez la section Tables à importer, vous pouvez voir un aperçu des données telles qu’elles se trouvent dans la source de données ou dans la zone de stockage après l’importation. Sélectionnez Salesforce ou ou Table de stockage dans la liste déroulante pour prévisualiser les données.

  • Vous pouvez modifier les options de chaque colonne en passant la souris sur son en-tête, puis en cliqu­ant sur le menu déroulant à côté de son nom. Ces options sont les suivantes :
  • Trier par ordre croissant : triez la table entière en fonction de cette colonne, dans l’ordre croissant.
  • Trier par ordre décroissant : triez la table entière en fonction de cette colonne, dans l’ordre décroissant.
  • Paramètres de colonne : cette boîte de dialogue est utilisée pour modifier les propriétés de la colonne dans la table de stockage.
    • Nom : Le nom de la colonne, affiché dans l’en-tête.
    • Type de colonne : Le type de données utilisé dans la colonne.
    • Convertir le type de colonne : sélectionnez le nouveau type dans ce menu déroulant.
  • Exclure la colonne de l’importation : sélectionnez cette option pour supprimer cette colonne des données importées.
  • Supprimer la colonne personnalisée : sélectionnez ceci pour supprimer la colonne. (Disponible pour les col­onnes personnalisées uniquement)

Téléchargement de données à partir d’une table de stockage

Vous pouvez télécharger des données à partir d’une seule table de stockage.

Pour télécharger des données à partir d’une seule table de stockage, procédez comme suit :

  1. Cliquez sur la flèche vers le bas dans un titre de table de la section Tables à importer.

  2. Sélectionnez Télécharger les données.

  3. À l’invite “Cette opération enverra un courriel avec une URL pour télécharger les données,” cliquez sur Envoyer. Adaptive Integration envoie alors un courriel contenant une URL, à l’adresse de messagerie associée au concepteur de données.

  4. Ouvrez le courriel et cliquez sur l’URL. Les données sont téléchargées au format .CSV.

Utilisation des filtres avancés

Sous le menu déroulant Source, vous pouvez cliquer sur Filtres avancés pour afficher les options de fil­trage des données dans la zone d’aperçu Tables à importer. La fonction de filtres avancés fournit des outils pour afficher et parcourir un sous-ensemble de données dans une table de stockage. En modifiant ces propriétés de filtrage, vous pouvez modifier l’affichage des données affichées dans la fenêtre d’aperçu sans modifier les données dans la zone de stockage.

La zone d’aperçu est spécialement conçue pour prévisualiser une petite partie des données dans la zone de stockage. Vous pouvez explorer les données disponibles à partir du compte Feuille de calcul et vérifier que vous obtenez les données attendues en examinant la zone de stockage. (Les filtres définis dans la fonction de prévisualisation n’affectent pas les données réelles dans la zone de stockage.) Le filtre avancé vous permet d’expérimenter avec les données de l’aperçu afin de configurer un filtre d’importation de données.

Les options pour les filtres avancés sont :

  • Lignes distinctes : Cochez cette case pour masquer les lignes dupliquées.
  • Maximum de lignes : limitez le nombre de lignes affichées dans la zone d’aperçu en entrant un nombre dans la zone de texte.
  • Colonnes : sélectionnez ou désélectionnez les colonnes dans ce menu déroulant pour afficher ou masquer les colonnes affichées.

La suppression d’une colonne de cette liste ne supprime pas la colonne de la liste d’importation.

  • Filtre SQL : cliquez sur la grande zone de texte pour afficher la boîte de dialogue Modifier le filtre SQL, illustrée ci-dessous.

Entrez une expression SQL dans le champ. Ceci est un filtre pour restreindre les lignes en cours d’aperçu. Cliquez sur Appliquer pour vérifier automatiquement la syntaxe SQL du filtre. (S’il existe des erreurs, elles seront indiquées dans l’expression.) Pour obtenir une aide détaillée sur la syntaxe SQL, vous pouvez cliquer ici dans la section Notes. L’expression que vous avez entrée apparaît dans la section Filtre avancé dans la fenêtre de l’aperçu.

Cliquez sur Supprimer le filtre (à côté du menu déroulant Source) pour effacer tous les para­mètres de filtres avancés.

Dans le cadre du processus de personnalisation de table, vous pouvez également créer des tables de jointure et des colonnes personnalisées à l’aide des expressions SQL.

Effacement des données de la zone de stockage

Les informations restent dans la zone de stockage jusqu’à ce que vous les effaciez.

Pour effacer les données de la zone de transfert, procédez comme suit :

  1. Cliquez sur Effacer la zone de stockage dans le menu Actions.
    Les éléments de la zone de stockage de toutes les tables de la source de données, seront effacés.

 Limites

Les objets Salesforce nécessitant une sous-requête, tels que ActivityHistory,  ne sont pas pris en charge lors de l’importation. Si vous tentez d’accéder à des objets nécessitant des sous-requêtes, une erreur se produira probablement dans le formulaire Message : INVALID_TYPE_FOR_OPERATION : le type d’entité ActivityHistory ne prend pas en charge la requête.

Vous pouvez envisager d’exposer ces données via des objets personnalisés.

  • Cet article vous a été utile ?