4.1.6. Configuration et utilisation du connecteur Salesforce
Le connecteur Salesforce de Tale of Data permet aux utilisateurs de lire et d’écrire des données dans Salesforce, directement depuis leur environnement Tale of Data. Ce chapitre vous guidera à travers les étapes nécessaires pour configurer et utiliser ce connecteur.
4.1.6.1. Configuration d’une source de données Salesforce
1. Accès et Sécurité
Pour commencer, vous devez obtenir auprès de votre administrateur Salesforce les identifiants d’un compte permettant de se connecter à Salesforce depuis une application externe, en l’occurrence, Tale of Data.
Note
Indiquez à votre administrateur Salesforce que Tale of Data se connecte à Salesforce via l’API « partner SOAP ». Se connecter à Salesforce via une application tierce nécessite que l’administrateur crée une App Connectée Salesforce.
Votre administrateur Salesforce vous transmettra les éléments suivants :
Login : le nom d’utilisateur Salesforce
Mot de passe : le mot de passe Salesforce
Jeton de sécurité : le « Security Token »
2. Création d’une source de données Salesforce
Dans Tale of Data, allez dans le catalogue et cliquez sur le bouton Nouvelle source :
Suivez les instructions à l’écran pour vous connecter à votre instance Salesforce depuis votre environnement Tale of Data.
Sélectionnez :
API pour la catégorie de sources de données
Salesforce pour le type de source de données
Ensuite, cliquez sur le bouton Suivant puis saisissez :
Le nom de la source de données : il s’agit du nom d’affichage dans le catalogue Tale of Data. La saisie est libre : vous pouvez nommer votre source de données « Mon Salesforce », par exemple.
Les login, mot de passe et jeton de sécurité fournis par votre administrateur Salesforce
Pour terminer, cliquez sur le bouton Ajouter :
Un fois configurée, la source de données permettant l’accès à votre instance Salesforce apparaît dans le catalogue :
Les objets Salesforce sont répartis dans deux schémas :
standard_objects : en dépliant ce schéma, vous accédez aux principaux objets « standard » Salesforce (Comptes, Contacts,…etc.)
custom_objects : en dépliant ce schéma, vous accédez à tous les objets « custom » Salesforce (i.e. les objets qui ont été créés par votre administrateur Salesforce pour les besoins spécifiques de votre organisation).
Voici par exemple ce que vous obtiendrez en cliquant sur la table Contact:
Vous pouvez à présent :
Utiliser vos données Salesforce dans n’importe quel Flow Tale of Data (pour les corriger, les enrichir, les valider, les analyser…).
Faire un audit qualité de toutes vos données Salesforce dans le module Mass Data Discovery
Créer des tableaux de bord ou des Data Stories
4.1.6.2. Utilisation du Connecteur Salesforce
1. Création de Flows
Un fois votre source de données Salesforce configurée, les jeux de données Salesforce s’utilisent comme n’importe quel jeu de données Tale of Data.
Vous pouvez, sous réserve que les permissions de votre compte Salesforce le permettent :
Lire des données dans Salesforce
Corriger / Valider / Croiser / enrichir vos données Salesforce avec des données de différentes sources (fichiers, bases de données,…)
Ecrire dans Salesforce
2. Lecture de données Salesforce
Pour lire des données depuis Salesforce, vous devez créer un flow et ajouter un nœud source.
Dans le configurateur du nœud source :
Sélectionnez Salesforce dans la liste déroulante Type de source de données.
Sélectionnez votre instance Salesforce dans la liste déroulante Sources de données existantes.
Cliquez sur le bouton bleu …Sélectionner pour sélectionner le jeu de données à lire (Comptes, Contact, …etc.)
3. Écriture de données dans Salesforce
Pour écrire des données dans Salesforce, vous devez ajouter un nœud cible à votre flow.
Dans le configurateur du nœud cible :
Sélectionnez Salesforce dans la liste déroulante Type de source de données.
Sélectionnez votre instance Salesforce dans la liste déroulante Sources de données existantes.
Sélectionnez le mode d’écriture :
Insérer, pour ajouter de nouveaux enregistrements
Mettre à jour, pour modifier des enregistrements existants
Si vous cochez la case Arrêter à la 1ere erreur, l’écriture s’arrêtera le plus rapidement possible à la première erreur rencontrée (e.g. un champ requis manquant ou un doublon). Les enregistrements écrits avant l’erreur resteront présents dans Salesforce. En revanche, si cette case est décochée, le connecteur écrira dans Salesforce tous les enregistrements ne générant pas d’erreurs (« best effort »), puis déclenchera une erreur à la fin du flow pour signaler que tous les enregistrements n’ont pas pu être écrits. Le détail des échecs sera accessible dans la fenêtre d’exécution, et sera également envoyé par e-mail au propriétaire du flow.
Si vous cochez la case Contourner les règles de duplication le connecteur ne pas tiendra pas compte des règles de dédoublonnage paramétrées dans Salesforce Attention : lorsque vous activez cette option, vous devez vous assurer que votre flow ne génère pas de doublons (pour cela utilisez les fonctions de dédoublonnage avancées de l’éditeur de préparation de Tale of Data).
Objet Salesforce cible : la collection d’objets Salesforce dans laquelle vous souhaitez écrire des données. Dans la capture d’écran ci-dessus : Account (= Compte)
Champs cibles : cette table permet d’afficher les correspondances (et les erreurs de correspondance) entre les colonnes venant de votre flow Tale of Data et les champs attendus par Salesforce. Les règles de correspondances sont les suivantes :
La colonne Tale of Data doit avoir exactement le même nom (et la même casse de caractères) que le champ cible Salesforce correspondant
La colonne Tale of Data doit avoir un type compatible avec celui du champ Salesforce cible correspondant (e.g. vous ne pouvez pas écrire une valeur de type texte dans un champ Salesforce de type Date)
Exemple d’erreur de correspondance sur le nom du champ
Autre type d’erreur (signalées en rouge) dans la table des champs cibles :
Lorsque vous êtes en mode d’écriture Mettre à jour, votre flow doit impérativement produire sur sa sortie une colonne nommée Id (sensible à la casse, de type texte), contenant l’identifiant unique Salesforce des enregistrements à mettre à jour. Notez que seuls les champs produits par le flow seront mis à jour : si vous souhaitez, par exemple, ne mettre à jour qu’une seule colonne C, la sortie de votre flow devra contenir uniquement les colonnes Id et C. Les autres champs ne seront pas modifiés.
Lorsque vous êtes en mode d’écriture Insérer, votre flow ne doit pas produire sur sa sortie de colonne nommée Id. “Id“ est le nom réservé pour l’identifiant unique de tous les objets Salesforce. Seul Salesforce peut attribuer une valeur à ce champ :
Lorsqu’un champ Salesforce est requis et qu’il n’est pas fourni par votre flow, la configuration du nœud cible se met en erreur, empêchant l’exécution du flow :
Important : en mode Mettre à jour, Tale of Data vous permet, dans le même flow, de lire et d’écrire dans la même table Salesforce