Connecteur Source Salesforce

Le connecteur source Salesforce dans DataSync vous permet de récupérer des données depuis Salesforce pour les charger ou les synchroniser dans votre entrepôt de données. Après avoir créé toutes les connexions source requises, configurez votre source de destination pour compléter la configuration de la connexion.

Configurer une application connectée dans Salesforce

Avant de configurer le connecteur Salesforce dans DataSync, vous devez créer une application connectée dans Salesforce pour obtenir les informations d'authentification.

Créer une application connectée

1. Connectez-vous à Salesforce.
2. Sélectionnez l'onglet Accueil.
3. Sous Outils de Plateforme, développez Applications, puis sélectionnez Gestionnaire d'applications.
4. Cliquez sur Nouvelle application connectée dans le coin supérieur droit.
5. Entrez un nom descriptif pour l'application.
6. Dans Email de contact, entrez une adresse email valide.
7. Sélectionnez Activer les paramètres OAuth.
8. Dans URL de rappel, collez l'URL de rappel affichée dans les Propriétés de connexion de la configuration du connecteur Salesforce dans DataSync.
9. Dans la liste des Scopes OAuth disponibles, sélectionnez les scopes requis pour l'accès aux données et déplacez-les vers Scopes OAuth sélectionnés à l'aide de la flèche.
10. Désélectionnez Exiger une clé de preuve pour l'échange de code (PKCE).
11. Cliquez sur Enregistrer, puis sur Continuer. Attendez de 2 à 10 minutes avant d'utiliser cette application connectée.

Récupérer les identifiants de votre application

1. Sous Outils de Plateforme, développez Applications, Applications connectées, puis sélectionnez Gérer les applications connectées.
2. Sous API (Activer les paramètres OAuth), copiez la Clé consommateur (c'est l'ID client) et le Secret consommateur — vous aurez besoin des deux dans DataSync.

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

Si vous avez déjà une application connectée et devez mettre à jour l'URL de rappel :

1. Connectez-vous à Salesforce.
2. Sélectionnez l'onglet Accueil.
3. Sous Outils de Plateforme, développez Applications, puis sélectionnez Gestionnaire d'applications.
4. Localisez votre application connectée, cliquez sur l'icône déroulante à droite, puis sélectionnez Modifier.
5. Modifiez l'URL de rappel.
6. Cliquez sur Enregistrer.

Créer des connexions source dans DataSync

1. Connectez-vous à DataSync.
2. À partir de l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions source, cliquez sur Nouvelle.
4. Sélectionnez Salesforce.
5. Dans le panneau des Propriétés de connexion, entrez les propriétés de connexion.
6. (Facultatif) Dans le panneau des Propriétés de connexion supplémentaires, sélectionnez Ajouter une propriété et entrez les paramètres pour chaque propriété.
7. Dans le panneau des Paramètres avancés, configurez les paramètres, y compris le Type de suivi et d'autres valeurs selon vos besoins.
8. Cliquez sur Enregistrer seulement après avoir attendu au moins 2 à 10 minutes depuis la création de l'application connectée pour éviter des erreurs.

remarque

Si vous voyez error=invalid_client_id&error_description=client%20identifier%20invalid, attendez quelques minutes, puis modifiez la connexion source Salesforce dans DataSync. Cliquez sur Authentifier et Enregistrer, puis Autoriser.

Paramètres

Propriétés de 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. Doit être ajoutée à l'Application connectée dans Salesforce.
ID client	Clé consommateur de l'application connectée Salesforce paramètres OAuth.
Secret client	Secret consommateur de l'application connectée Salesforce paramètres OAuth.
Verbosité	1 – Journaliser les requêtes, les décomptes de lignes, le début/fin d'exécution, les erreurs. 2 – Inclut le niveau 1 plus les requêtes de cache, les en-têtes HTTP. 3 – Inclut le niveau 2 plus les corps de demande/réponse. 4 – Inclut le niveau 3 plus la communication au niveau de transport. 5 – Inclut le niveau 4 plus toutes les commandes d'interface.
Activer le pooling	Option de pooling de connexion pour la performance.
Délai d'inactivité du pool	Temps d'inactivité maximal pour les connexions avant de les renvoyer au pool, en secondes.
Taille maximale du pool	Nombre maximal de connexions autorisées dans le pool.
Temps d'attente dans le pool	Temps d'attente maximal pour l'allocation de connexion avant qu'une erreur ne soit générée, en secondes.

Propriétés supplémentaires de connexion

Propriétés supplémentaires de chaîne de connexion non spécifiées dans le panneau Propriétés de connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Chiffré. Sélectionner Chiffré masque la valeur de l'interface et la stocke chiffrée dans le backend, par exemple lors de la définition de mots de passe.

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

Paramètres avancés

Les paramètres avancés contrôlent la manière dont le connecteur Salesforce suit les changements, gère la configuration régionale et temporelle, et traite les lots de données lors de l'extraction. Ces options permettent un réglage fin pour la performance et l'exactitude, et doivent être configurées selon l'environnement de votre système et vos exigences opérationnelles.

Paramètre	Description
Type de suivi	Méthode de suivi des changements : Aucun ou Date.
Région	Paramètre régional pour le connecteur, si requis par votre configuration.
Fuseau horaire	Fuseau horaire correspondant au serveur d'application Salesforce.
Décalage horaire	Décalage de rafraîchissement en secondes pour compenser les problèmes de synchronisation dans la sélection des enregistrements. La valeur minimale est 0 ; la valeur maximale est 3600 secondes.
Taille des lots	Quantité d'enregistrements traités dans chaque lot lors de l'extraction. Des tailles de lots plus grandes augmentent l'utilisation de la mémoire mais peuvent améliorer les performances jusqu'à un certain point. La valeur par défaut est 2000 et le maximum ne doit pas dépasser 10000 enregistrements. Ajustez selon la vitesse de votre réseau et les performances de votre disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.

Exemple