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.

DataSync propose deux modes d'authentification pour Salesforce : OAuth Headless et OAuth avec PKCE. PKCE (Proof Key for Code Exchange) est l'option la plus sécurisée et est recommandée dans la majorité des cas.

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

important

Certaines étapes s'appliquent uniquement aux configurations PKCE et sont signalées en conséquence.

É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. For PKCE, select:
   • Manage user data via APIs
   • Perform requests at any time
9. If using PKCE, check 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. Complétez toutes les propriétés de connexion requises.
6. (Facultatif) Dans le panneau Autres propriétés de la connexion, cliquez sur Ajouter une propriété et définissez les paramètres supplémentaires nécessaires.
7. Configurez les paramètres avancés selon votre 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.
Mode d'authentification	Choisir entre OAuthHeadless et OAuthPKCE.
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.
URL d'autorisation	PKCE uniquement Remplacer hostname par le domaine hôte Salesforce. Exemple : https://hostname/services/oauth2/authorize.
URL d'aquisition du jeton d'accès	PKCE uniquement Remplacer hostname par le domaine hôte Salesforce. Exemple : https://hostname/services/oauth2/token.
Scope	Portées correspondant aux domaines OAuth sélectionnés dans l'application Salesforce : api, offline_access et refresh_token.
Verbosité	Contrôle le niveau de détail écrit dans le journal. Chaque niveau inclut tout ce qui précède plus des informations supplémentaires. 1 enregistre les requêtes, les nombres de lignes, les heures de début et de fin d'exécution ainsi que les erreurs. 2 ajoute les requêtes de cache et les en-têtes HTTP. 3 ajoute les corps de requête et de réponse. 4 ajoute la communication au niveau du transport. 5 ajoute toutes les commandes d'interface.

Autres propriétés de la connexion

Ce panneau permet d'ajouter des propriétés de chaîne de connexion qui ne figurent pas dans le panneau Propriétés de la connexion. Pour les valeurs sensibles comme les mots de passe, choisissez le type Crypté. La valeur reste alors masquée dans l'interface et stockée de façon chiffrée côté serveur.

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

Paramètres avancés

Ces paramètres déterminent la façon dont le connecteur suit les modifications de données, gère l'heure et la région, et traite les enregistrements pendant l'extraction. Ajustez-les selon votre environnement Salesforce afin que les résultats restent exacts et cohérents.

Paramètre	Description
Type de suivi	Méthode de suivi des modifications de données : Aucun ou Date.
Region	Paramètre régional du connecteur, si la configuration l'exige.
Fuseau horaire	Fuseau horaire correspondant à l'environnement Salesforce.
Décalage de temps	Décalage d'actualisation en secondes pour compenser les écarts de synchronisation lors de la sélection des enregistrements. Minimum 0, maximum 3600.
Taille du lot	Nombre d'enregistrements traités par lot lors de l'extraction. Des lots plus grands peuvent améliorer les performances mais consomment davantage de mémoire. La valeur par défaut est 2000, le maximum est 10000. À ajuster selon la vitesse du réseau et les performances du disque. La valeur par défaut convient dans la plupart des cas.

Exemple de configuration

Connexion source Salesforce entièrement configurée dans DataSync, avec toutes les propriétés et tous les paramètres complété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.