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 sources requises, configurez votre connexion de destination pour finaliser la configuration.

Configurez 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 identifiants 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 électronique 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 la connexion de la configuration du connecteur Salesforce dans DataSync.
9. Dans la liste Portées OAuth disponibles, sélectionnez les portées requises pour l'accès aux données et déplacez-les vers Portées OAuth sélectionnées à 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 vos identifiants d'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 le Clé consommateur (il s'agit de l'ID client) et 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 que vous 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 de menu déroulant à droite, et 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. Depuis l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions source, cliquez sur Nouvelle.
4. Sélectionnez Salesforce.
5. Dans le panneau Propriétés de la connexion, saisissez les propriétés de connexion.
6. (Optionnel) Dans le panneau Autres propriétés de la connexion, cliquez sur Ajouter une propriété et ajoutez les les paramètres nécessaires.
7. Dans le panneau Paramètres avancés, configurez les paramètres avancés, notamment le Type de suivi et les autres valeurs selon vos besoins.
8. Cliquez sur Enregistrer uniquement après avoir attendu au moins 2 à 10 minutes depuis la création de l'application connectée pour éviter les 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 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. Doit être ajoutée à l'application connectée dans Salesforce.
ID client	Clé consommateur des paramètres OAuth de l'application connectée Salesforce.
Secret client	Secret consommateur des paramètres OAuth de l'application connectée Salesforce.
Verbosité	1 – Journaliser les requêtes, nombres de lignes, début/fin d'exécution, erreurs. 2 – Inclut le niveau 1 plus les requêtes de cache, en-têtes HTTP. 3 – Inclut le niveau 2 plus les corps de requête/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 améliorer les performances.
Délai d'inactivité du pool	Temps d'inactivité maximal pour les connexions avant de les retourner au pool, en secondes.
Taille maximale du pool	Nombre maximum de connexions autorisées dans le pool.
Temps d'attente du pool	Temps d'attente maximal pour l'allocation de connexion avant qu'une erreur ne soit générée, en secondes.

Autres propriétés de la connexion

Propriétés de chaîne de connexion supplémentaires non spécifiées dans le panneau Propriétés de la connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Crypté. En sélectionnant Crypté, la valeur est masquée dans l'interface et stockée cryptée à l'arrière-plan, comme 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 de la propriété. Exemple : True
Type	Visibilité de la propriété : Visible ou Crypté.

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 horaire, et traite les lots de données lors de l'extraction. Ces options permettent un ajustement fin pour la performance et la précision, et doivent être configurées en fonction de votre environnement système et de vos exigences opérationnelles.

Réglage	Description
Type de suivi	Méthode pour suivre les changements : Aucun ou Date.
Région	Réglage de région pour le connecteur, si nécessaire pour 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 timing dans la sélection des enregistrements. La valeur minimale est 0 ; le maximum est 3600 secondes.
Taille des lots	Quantité d'enregistrements traités dans chaque lot lors de l'extraction. Des tailles de lot 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 en fonction de votre vitesse réseau et des performances du disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.