Connecteur source Salesforce

Le connecteur source Salesforce permet à DataSync de récupérer des données depuis Salesforce et de les charger dans l'entrepôt de données. La configuration se fait en deux étapes : créer une application cliente externe dans Salesforce pour autoriser l'accès, puis créer la connexion source dans DataSync en utilisant les identifiants de cette application. Les deux configurations se renvoient l’une à l’autre. Il est donc recommandé de garder Salesforce et DataSync ouverts côte à côte pendant la configuration.

Une fois la connexion source créée, configurez la connexion de destination pour finaliser l'installation.

Étape 1 : Configurer une application cliente externe dans Salesforce

Créer une application cliente externe

1. Connectez-vous à Salesforce.
2. Cliquez sur l'icône engrenage en haut à droite, puis sélectionnez Configuration.
3. Sous Outils de la plate-forme, développez Applications, puis sélectionnez Gestionnaire d'applications.
4. Cliquez sur Nouvelle application cliente externe en haut à droite.
5. Complétez tous les champs obligatoires sous Informations de base.
6. Sous API (Activer les paramètres OAuth), cochez Activer OAuth.
7. Dans URL de rappel, collez l'URL affichée dans les propriétés de la connexion dans DataSync.
8. Dans Domaines OAuth disponibles, sélectionnez les portées nécessaires et déplacez-les vers Domaines OAuth sélectionnés à l'aide de la flèche. Les portées varient selon la configuration Salesforce et les données à récupérer.
9. Décochez Demander l'extension Clé de preuve pour l'échange de code (PKCE).
10. Cliquez sur Créer.

Récupérer les identifiants de l'application

1. Sous Outils de la plate-forme, développez Applications.
2. Développez Applications clientes externes et sélectionnez Utilisation de OAuth.
3. Sélectionnez l'application.
4. Ouvrez l'onglet Paramètres, puis développez Paramètres OAuth.
5. Cliquez sur Clé et secret consommateur.
6. Copiez la Clé consommateur (correspond à l'ID client dans DataSync) et le Secret consommateur (correspond au Secret client). Ces deux valeurs sont nécessaires à l'étape suivante.

Étape 2 : Créer la connexion source dans DataSync

1. Connectez-vous à DataSync.
2. Depuis l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions de la source, cliquez sur Nouveau.
4. Sélectionnez Salesforce.
5. Renseignez toutes les propriétés de la connexion requises.
6. (Facultatif) Dans le panneau Autres propriétés de la connexion, cliquez sur Ajouter une propriété et renseignez les paramètres nécessaires.
7. Configurez les paramètres avancés selon l'environnement, notamment le Type de suivi.
8. Attendez 2 à 10 minutes avant d'enregistrer pour que Salesforce finalise l'enregistrement de la nouvelle application.
9. Cliquez sur Enregistrer.

important

Salesforce a besoin de 2 à 10 minutes pour enregistrer complètement une nouvelle application. Si la connexion est créée trop tôt, une erreur invalid_client_id s'affiche. Dans ce cas, modifiez la connexion, cliquez sur Authentifier et Enregistrer, puis sur Autoriser pour finaliser.

Paramètres

Propriétés de la connexion

Paramètre	Description
Description	Nom unique pour la connexion. Exemple : Salesforce.
URL de rappel	URL de redirection générée automatiquement par DataSync. À coller dans l'application cliente externe dans Salesforce. Exemple : 3MVG9k02hQhyUgQDmCknDvKr8oP35RkPV6Uc4j7vP9KQH8bM2NwL1JpYz853vQrc2bN1aD6yR5tK9pE4mW0fG.
ID client	Clé consommateur de l'application cliente externe dans Salesforce. Exemple : 3MVG9k02hQhyUgQDmCknDvKr8oP35RkPV6Uc4j7vP9KQH8bM2NwL1JpYz853vQrc2bN1aD6yR5tK9pE4mW0fG.
Secret client	Secret consommateur de l'application cliente externe dans Salesforce. Exemple : 7B6F9C8F2E1A5BZC9D0E3F4A7B6C7D8E9F0G1B2C3D4E5FEA7B8C9D0E1F293B4C.
Verbosité	Niveau de détail écrit dans le journal. Chaque niveau inclut les informations du niveau précédent. 1 — Requêtes, nombres de lignes, début/fin d'exécution et erreurs. 2 — Niveau 1 plus requêtes de cache et en-têtes HTTP. 3 — Niveau 2 plus corps de requête et de réponse. 4 — Niveau 3 plus communication au niveau du transport. 5 — Niveau 4 plus toutes les commandes d'interface.
Activer le pooling	Active le pooling de connexions pour améliorer les performances.
Délai d'inactivité du pool	Durée d'inactivité maximale en secondes avant qu'une connexion soit retournée au pool.
Taille maximale du pool	Nombre maximum de connexions autorisées dans le pool.
Temps d'attente du pool	Temps d'attente maximal en secondes pour obtenir une connexion avant qu'une erreur soit générée.

Autres propriétés de la connexion

Ce panneau permet de saisir des propriétés de chaîne de connexion absentes du panneau principal. Pour chaque propriété, choisissez Visible ou Crypté. Utilisez Crypté pour les valeurs sensibles comme les mots de passe : la valeur est masquée dans l'interface et stockée de façon chiffrée.

Paramètre	Description
Propriété	Propriété de chaîne de connexion qui définit l'action ou le comportement. Exemple : ReadOnly.
Valeur	Valeur associée à la propriété. Exemple : True.
Type	Visibilité de la propriété : Visible ou Crypté.

Paramètres avancés

Ces paramètres contrôlent le suivi des modifications, la configuration horaire et le traitement des données lors de l'extraction. À ajuster selon l'environnement pour garantir des résultats précis.

Paramètre	Description
Type de suivi	Méthode de suivi des modifications : Aucun ou Date.
Région	Région du connecteur, si applicable.
Fuseau horaire	Fuseau horaire du serveur d'application Salesforce.
Décalage horaire	Décalage en secondes pour compenser les problèmes de synchronisation lors de la sélection des données. Valeur minimale : 0. Valeur maximale : 3600 secondes.
Taille des lots	Nombre de lignes traitées par lot lors de l'extraction. Des lots plus grands peuvent améliorer les performances mais augmentent la consommation mémoire. Valeur par défaut : 2000. Maximum recommandé : 10000. Dans la plupart des cas, la valeur par défaut convient.

Exemple de configuration

Une connexion source Salesforce complète dans DataSync, avec toutes les propriétés et tous les paramètres renseignés.

Mettre à jour l'URL de rappel d'une application existante

Si l'application est déjà configurée et que seule l'URL de rappel doit être modifiée :

1. Connectez-vous à Salesforce.
2. Cliquez sur l'icône engrenage en haut à droite, puis sélectionnez Configuration.
3. Sous Outils de la plate-forme, développez Applications, puis Applications clientes externes.
4. Sélectionnez Utilisation de OAuth.
5. Choisissez l'application, puis ouvrez l'onglet Paramètres.
6. Cliquez sur Modifier en haut à droite.
7. Mettez à jour l'URL de rappel.
8. Cliquez sur Enregistrer.