Salesforce
Utilisez le connecteur Salesforce pour vous connecter à Salesforce dans Designer. Utilisez le connecteur pour lire des données depuis des objets Salesforce et les réécrire dans Salesforce via un seul connecteur fonctionnant de manière identique dans Alteryx Designer (version de bureau) et Alteryx One (version Cloud).
Salesforce est disponible en tant que source de données dans les outils Entrée de données et Sortie de données, ainsi qu'en tant qu'outils Entrée Salesforce et Sortie Salesforce autonomes.
Nouvelle version du connecteur dans Designer
Le connecteur Salesforce fait désormais partie de l'expérience de connecteurs Alteryx One. Lisez attentivement les informations figurant sur cette page afin de vous assurer que vous utilisez correctement les outils appropriés.
Si vous souhaitez mettre à jour le connecteur Salesforce dans vos workflows Designer, vous pouvez utiliser l'utilitaire de migration des workflows.
Configuration du connecteur Salesforce
Salesforce est disponible dans la version Designer 2025.1.2, correctif 7 ou ultérieure. Si vous avez déjà utilisé le connecteur Salesforce, voir la section Migration vers le connecteur unifié.
Conditions préalables
Assurez-vous d'avoir rempli les conditions préalables suivantes avant de continuer :
Exigences | Détails |
|---|---|
Version de Designer |
|
Configuration de l'application personnalisée (OAuth 2.0), le cas échéant | Une application connectée Salesforce nécessite un ID client, un secret du client, une URI de redirection (qui doit correspondre à l'application connectée) et un champ d'application |
URL de l'environnement | Production (par défaut), Sandbox ou domaine personnalisé |
DCM | Vous devez activer DCM dans Designer. Accédez à Options > Paramètres avancés > DCM pour l'activer |
Installer le connecteur
Vous pouvez facilement installer la dernière version du connecteur Salesforce depuis Designer via les Compléments. C'est la méthode d'installation recommandée qui vous permet de parcourir, d'installer et de mettre à jour les connecteurs sans quitter Designer ni accéder à Alteryx Marketplace.
Pour installer le connecteur…
Dans Designer, accédez à Compléments > Gérer les compléments Marketplace. Vous verrez une liste des connecteurs disponibles.
Sélectionnez le connecteur Salesforce, puis sélectionnez Installer. Designer télécharge et installe le package. Designer peut avoir besoin de redémarrer pour terminer l'installation.
Une fois l'installation et la configuration terminées, le connecteur Salesforce est accessible via les outils Entrée de données et Sortie de données.
Configurer une connexion
Pour se connecter à Salesforce avec DCM…
Faites glisser l'outil Entrée de données ou Sortie de données vers le canevas, puis sélectionnez Se connecter aux données.
Sous Configuration du connecteur, sélectionnez Créer ou parcourir une connexion de données.
Si vous avez déjà créé une connexion Salesforce, vous pouvez la sélectionner dans l'onglet Récents.
Sélectionnez + Nouveau. Dans la liste des technologies, sélectionnez Salesforce.
Sélectionnez Connexion rapide, puis Configurer la connexion. La fenêtre Connexions s'ouvre.
Sélectionnez + Nouveau.
Spécifiez le nom de la connexion et celui de la source de données. Sélectionnez l'environnement.
Dans la section Informations d'identification, sélectionnez votre méthode d'authentification et saisissez le nom d'identification. Pour plus d'informations, consultez la page Méthodes d'authentification.
Sélectionnez Enregistrer.
Sélectionnez Se connecter. Salesforce peut demander une authentification.
Sélectionnez le fichier depuis lequel lire ou vers lequel écrire dans la fenêtre de l'Explorateur de fichiers.
Sélectionnez la configuration en lecture ou en écriture dans la fenêtre Options.
Sélectionnez confirmer pour créer une connexion vers le fichier. Vous pouvez continuer à créer votre workflow.
Migration vers le connecteur unifié
Si vous utilisez déjà le connecteur Salesforce dans Alteryx, consultez la section ci-dessous. Elle présente les modifications apportées à la version unifiée.
Paramètre | Connecteur hérité | Connecteur unifié (v6.1.0) |
|---|---|---|
Plateformes et outils | Bureau (entrée et sortie) Cloud (Entrée uniquement) | Bureau (entrée et sortie) Cloud (Entrée et Sortie, en cours) |
Cadre | SDK de Python (Bureau) Pilote ODBC CData (Cloud) | Cadre EACD (Bureau et Cloud) |
Communication / API | API Salesforce v52 (été 2021) | API Salesforce v61 et ultérieure (été 2024) |
Méthodes d'authentification | OAuth 2.0 Nom d'utilisateur + mot de passe + jeton de sécurité | Les mêmes méthodes, avec une configuration élargie |
Modèle de connexion | Options distinctes pour la production, le Sandbox et les URL personnalisées | DCM, avec un seul champ URL de l'environnement |
Principaux changements
Les options de menu déroulant Production, Sandbox et URL personnalisée ont été remplacées par un champ unique URL de l'environnement. Reconfigurez tout workflow qui utilisait ce menu déroulant.
L'URL de l'environnement remplace l'ancien menu déroulant :
https://login.salesforce.com(production, par défaut),https://test.salesforce.com(sandbox) ou votre domaine personnalisé.L'authentification via les informations d'identification Salesforce nécessite désormais également un ID client et un secret de client.
Sur bureau, les domaines personnalisés fonctionnent désormais avec toutes les méthodes d'authentification, et non plus uniquement avec OAuth.
Les workflows existants peuvent être migrés grâce à l'utilitaire de migration des workflows Alteryx, disponible dans la version Designer 2025.2 correctif 3 ou ultérieure. Pour plus d'informations, voir Utilitaire de migration des workflows.
Note
L'utilitaire de migration est uniquement disponible dans la version de bureau.
Après l'installation du connecteur unifié, vous constaterez parfois que les technologies Salesforce, tant anciennes qu'unifiées, sont toutes deux listées dans la section Gérer les connexions. C'est normal pendant la période de transition. Utilisez le connecteur unifié pour tout nouveau projet.
About Salesforce Connector
Outils d'entrée et de sortie
Les outils d'entrée et de sortie de Salesforce permettent de lire et d'écrire des données dans Salesforce.
Entrée Salesforce
Entrée Salesforce peut lire des objets standard et personnalisés. Il existe trois façons de lire :
Générateur de requêtes : sélectionnez un objet et choisissez les champs que vous souhaitez consulter. L'outil de sélection de champ propose une liste de sélection multiple avec l'option Sélectionner tout, une recherche par chaîne ou sous-chaîne, un décompte en temps réel des champs sélectionnés et du nombre total de champs, ainsi qu'un filtre pour afficher uniquement les éléments sélectionnés. Une limite d'enregistrements peut également être définie. Quatre modes de champ sont disponibles : Lire tous les champs standard, Lire tous les champs personnalisés, Lire tous les champset Choisir manuellement.
Requête personnalisée (SOQL) : rédigez une requête SOQL pour lire des objets standard et personnalisés, y compris les champs de relation
__r, puis validez-la avant de l'exécuter. Une requête personnalisée ne renvoie toujours qu'une seule table.Consulter le rapport : parcourez et recherchez les rapports enregistrés, sélectionnez-en un et analysez ses résultats.
Sortie Salesforce
Sortie Salesforce écrit des lignes dans un objet standard ou personnalisé. Choisissez une action :
Insérer : ajouter de nouveaux enregistrements.
Mettre à jour : modifier les enregistrements existants. Nécessite l'ID d'enregistrement Salesforce.
Supprimer : supprimer les enregistrements. Nécessite l'ID d'enregistrement Salesforce.
Upsert : insérez de nouveaux enregistrements et mettez à jour les existants en une seule opération.
La sortie trait les enregistrements par lots et vous permet de choisir la version de l'API Salesforce. Lorsque vous utilisez les options Mettre à jour, Supprimer ou Upsert, incluez l'ID d'enregistrement en tant que clé primaire dans vos données.
Modèle d'objet
Salesforce stocke les données dans des objets qui fonctionnent comme des tables de base de données :
Les objets standard sont intégrés, tels que les comptes, contacts, leads, opportunités, cas, campagnes, tâches, événements et utilisateurs.
Les objets personnalisés sont créés dans votre entreprise et se terminent par
__c, par exempleFacture__c.Les champs de relation entre les objets utilisent le suffixe
__ret peuvent être référencés dans les requêtes SOQL.
Méthodes d'authentification
Salesforce prend en charge trois méthodes d'authentification. Utilisez la table ci-dessous pour choisir la méthode la plus adaptée à votre cas d'usage.
Méthode | Champs obligatoires | Bureau (modèle phare) | Cloud (Alteryx One) |
|---|---|---|---|
Application intégrée (OAuth 2.0) | Aucune | Oui | Non disponible (la création de connexion intégrée n'est pas prise en charge dans le Cloud) |
Application personnalisée (OAuth 2.0) | ID client, secret du client, URI de redirection (par défaut : | Oui | Oui |
Informations d'identification Salesforce (nom d'utilisateur, mot de passe, jeton de sécurité) | Nom d'utilisateur, mot de passe, jeton de sécurité (optionnel), ID client, secret du client | Oui | Oui |
Domaine personnalisé pour toutes les méthodes | N/A | Oui | Non disponible (le domaine personnalisé n'est pas pris en charge pour toutes les méthodes dans le Cloud) |
L'authentification OAuth prend en charge à la fois le flux de code d'autorisation (de l'utilisateur à l'application) et le flux d'informations d'identification du client (principal du service, pour l'automatisation sans interface ou planifiée).
Limites
Le connecteur ne prend pas en charge le test à blanc pour les opérations de lecture ou les requêtes personnalisées. Exécutez le workflow pour récupérer les données ou utilisez l'étape de validation SOQL pour vérifier une requête personnalisée avant son exécution.
Pour les objets contenant plus de 200 champs, les modes Lire tous les champs personnalisés et Lire tous les champs ne fonctionnent pas. Utilisez l'option Choisir manuellement pour sélectionner les champs dont vous avez besoin, ou écrivez une requête SOQL personnalisée pour lister des champs spécifiques.
Une requête personnalisée SOQL renvoie toujours une seule table. Pour combiner des données provenant de plusieurs objets, vous pouvez les joindre directement dans une requête SOQL ou utiliser plusieurs outils d'entrée et fusionner les résultats dans le workflow.
L'option Consulter le rapport permet de sélectionner un seul outil Rapport par entrée. Pour lire plusieurs rapports, utilisez plusieurs outils d'entrée.
Le connecteur utilise l'API REST de Salesforce. L'API de traitement par lots de Salesforce n'est pas encore prise en charge. Pour les opérations de lecture ou d'écriture de grande envergure, tenez compte des limites de débit de l'API REST et des restrictions imposées par l'API Salesforce.
L'aperçu des données d'objet et de champ est disponible dans le Cloud, mais pas dans la version de bureau. Dans la version de bureau, configurez les champs en utilisant la liste des champs du générateur de requêtes ou une requête SOQL.
Dans la version Cloud, la prise en charge des domaines personnalisés n'est pas disponible pour toutes les méthodes d'authentification. Utilisez une méthode de connexion au Cloud prise en charge, ou connectez-vous depuis votre version de bureau, où le domaine personnalisé fonctionne avec toutes les méthodes.
L'utilitaire de migration des workflows ne fonctionne que dans la version de bureau.
Dans la version Cloud, le flux de création de connexions d'applications intégrées n'est pas disponible. Utilisez une application OAuth personnalisée ou vos informations d'identification Salesforce dans le Cloud.
Les types de données générés à partir d'un même objet peuvent être différents entre la version Cloud et celle de bureau.
Dans la version Cloud, le chargement d'un jeu de données peut échouer pour certains objets. Si un objet spécifique ne se charge pas, essayez d'exécuter une requête SOQL personnalisée pour cet objet ou réduisez le nombre de champs sélectionnés.
Le connecteur est généralement disponible dans la version de bureau. Le prise en charge de la version Cloud est en cours et n'est pas encore disponible pour le grand public.
Salesforce version 6.1.0
Connector version de publication 6.1.0 | |
|---|---|
Version | Description |
v6.1.0 |
|
Type de connexion | Outils d'Alteryx. La version la plus récente est disponible dans Alteryx Marketplace. |
Type de prise en charge | Lecture et écriture |
Validé le | ODBC Client version 2.2.20 est également disponible pour les outils Sortie de données et Entrée de données. |
Version | Description |
|---|---|
v5.1.4 |
|
v5.1.3 |
Problèmes connus
|
v5.1.2 |
|
v5.1.1 |
Problèmes connus
|
v5.1.0 |
|
v5.0.10 |
Problèmes connus
|
v4.2.4 |
|
v4.1.0 |
|
v4.0.0 |
|
v3.1 |
|
Version | Description |
v1.3.1 |
|
v1.3 |
|
v1.2 |
|
Note
Assurez-vous que l'outil AMP Engine est activé pour les workflows contenant l'outil Entrée Salesforce version 2.2.0 et ultérieure.
Pour configurer une application API personnalisée pour cet outil, voir ce guide.
Si vous souhaitez traiter un fichier PAC qui achemine les demandes via plusieurs adresses IP proxy, utilisez des jetons de sécurité.
Domaines Salesforce personnalisés
Les outils Salesforce prennent en charge les domaines Salesforce personnalisés.
Pour vous connecter manuellement à un domaine personnalisé…
Dans la fenêtre de configuration des outils Salesforce, sélectionnez Utiliser l'URL de l'environnement personnalisé.
Saisissez votre domaine personnalisé dans Environnement personnalisé.
Pour se connecter à un domaine personnalisé à l'aide de DCM…
Sélectionnez Configurer une connexion. DCM s'ouvre.
Sélectionnez + Nouveau. La fenêtre Nouvelle source de données s'ouvre avec la technologie Salesforce présélectionnée.
Sélectionnez Personnalisé dans Environnement.
Saisissez votre domaine personnalisé dans Environnement personnalisé, puis cliquez sur Enregistrer.
