Salesforce

Utilisez le connecteur Salesforce pour vous connecter à Salesforce dans Designer.

Salesforce is available as a data source in the Input Data tool and Output Data tool, and as the standalone Salesforce Input and Salesforce Output tool.

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.

Détails du connecteur Salesforce

Salesforce est disponible dans Designer 2025.2 correctif 3 ou ultérieur en tant que source de données pour l'outil Entrée de données. Pour en savoir plus sur les options de type de fichier, accédez à [links].

Prerequisites

Ensure you have completed the following prerequisites before proceeding:

Requirement	Detail
Designer version	2025.1 Patch 5, 2025.2 Patch 3, or 2026.1 or later (all features except Built-in and Custom OAuth) 2025.1.2 Patch 7, 2025.2.1 Patch 5, or 2026.1 Patch (all auth methods)
Custom app (OAuth 2.0) setup, if used	A Salesforce Connected App with Client ID, Client Secret, Redirect URI (must match the connected app) and scope
Environment URL	Production (default), Sandbox or, Custom domain
DCM	You must enable DCM in Designer. Go to Options > Advanced Settings > DCM to enable it

Installer le connecteur

Vous pouvez facilement installer la dernière version du connecteur Salesforce depuis Designer via les Compléments. Vous n'avez pas besoin de vous rendre sur Alteryx Marketplace si vous installez les connecteurs de cette manière.

Pour installer le connecteur…

Dans Designer, accédez à Compléments > Gérer les compléments Marketplace.
Designer ouvre une fenêtre avec une liste de connecteurs disponibles.
Saisissez Salesforce pour effectuer la recherche.

Configurer une connexion avec DCM

Pour se connecter à Salesforce avec DCM…DCM - Designer

Faites glisser l'outil Entrée de données ou Sortie de données de la palette d'outils vers le canevas et sélectionnez-le.
Si vous avez déjà créé une connexion Google Drive, vous pouvez sélectionner Sources de données > Salesforce > Connexion rapide et passer à l'étape 12.
If you've created a Salesforce connection before, you can select the connection from the Recents tab.
Select + New. From the list of technologies, select Salesforce.
Dans la fenêtre Connexions de données, sélectionnez Sources de données.
Select +New.
Specify the connection name and the data source name. Select the Environment.
In the Credentials section, select your authentication method, and enter the credential name. For more information, see Authentication Methods.
Sélectionnez Enregistrer. Vous pouvez également tester la connexion avant de procéder à l'enregistrement.
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.

Input and Output Tools

The Salesforce Input and Output tools are used to read from and write to Salesforce.

Salesforce Input

Salesforce Input reads standard and custom objects. You can read in three ways:

Query Builder: Pick an object and select the fields you want to read. The field picker offers a multiselect list with Select All, search by string or substring, a live count of selected versus total fields, and a filter to show only what's selected. A record limit can also be set. Four field modes are available: Read all Standard Fields, Read all Custom Fields, Read all Fields, and Choose Manually.
Custom Query (SOQL): Write a SOQL query to read standard and custom objects, including __r relationship fields, then validate it before running. A custom query always returns a single table.
Read from Report: Browse and search saved reports, select one report, and parse its results.

Salesforce Output

Salesforce Output writes rows to a standard or custom object. Choose an action:

Insert: Add new records.
Update: Modify existing records. Requires the Salesforce record ID.
Delete: Remove records. Requires the Salesforce record ID.
Upsert: Insert new records and update existing ones in a single action.

Output processes records in batches and lets you choose the Salesforce API version. When you use Update, Delete, or Upsert, include the record ID as the primary key in your data.

Object Model

Salesforce stores data in objects, which behave like database tables:

Standard objects are built in, for example Account, Contact, Lead, Opportunity, Case, Campaign, Task, Event, and User.
Custom objects are created in your org and end with __c, for example Invoice__c.
Relationship fields between objects use the __r suffix and can be referenced in SOQL.

Méthodes d'authentification

Salesforce prend en charge…

Method	Required Fields	Desktop (Flagship)	Cloud (Alteryx One)
Built-in app (OAuth 2.0)	None	Yes	Not available (built-in connection creation is not offered on Cloud)
Custom app (OAuth 2.0)	Client ID, Client Secret, Redirect URI (default `http://localhost:1717/`), Scope (default `api offline_access)`	Yes	Yes
Salesforce Credentials (username, password, security token)	Username, Password, Security Token (optional), Client ID, Client Secret	Yes	Yes
Custom domain across all methods	NA	Yes	Not available (custom domain is not supported for all methods on Cloud)

OAuth supports both the Authorization Code flow (user to app) and the Client Credentials flow (service principal, for headless or scheduled automation).

Migration to Unified Connector

If you already use the Salesforce connector in Alteryx, read the section below. It walks through what has been changed in the unified version.

Parameter	Legacy Connector	Unified Connector (v6.1.0)
Platforms and Tools	Desktop (Input and Output) Cloud (Input only)	Desktop (Input and Output) Cloud (Input and Output, in progress)
Framework	Python SDK (Desktop) CData ODBC driver (Cloud)	EACD framework (Desktop and Cloud)
Communication / API	Salesforce API v52 (Summer '21)	Salesforce API v61+ (Summer '24)
Auth methods	OAuth 2.0 Username + Password + Security Token	Same methods, with expanded configuration
Connection model	Separate Production / Sandbox / Custom URL choices	DCM, with a single Environment URL field

Key Changes

Production, Sandbox, and Custom URL dropdown options have been replaced by a single Environment URL field. Reconfigure any workflow that used this dropdown.
Environment URL replaces the old dropdown: https://login.salesforce.com (production, default), https://test.salesforce.com (sandbox), or your custom domain.
Salesforce Credentials authentication now also requires Client ID and Client Secret.
On Desktop, custom domains now work with all authentication methods (previously OAuth only).

Existing workflows can be migrated using the Alteryx Workflow Migration Utility in Designer 2025.2 Patch 3 or later. For more information, see workflow migration utility.

Note

The migration utility is available on Desktop only.
After installing the unified connector, you may see both the legacy and unified Salesforce technologies listed in Manage Connections. This is expected during the transition. Use the unified connector for any new work.

Limitations

The connector does not support a dry run for reads or custom queries. Run the workflow to retrieve data, or use the SOQL validation step to check a custom query before running.
For objects with more than 200 fields, the Read all Custom Fields and Read all Fields modes fail. Use Choose Manually to pick the fields you need, or write a SOQL Custom Query that lists specific fields.
A SOQL Custom Query always returns one table. To combine data from multiple objects, join them within the SOQL query, or use multiple Input tools and blend the results in the workflow.
Read from Report supports selecting a single Report per Input tool. To read multiple reports, use multiple input tools.
The connector uses the Salesforce REST API. The Salesforce Bulk API is not yet supported. For very large reads or writes, expect REST API throughput and Salesforce API limits to apply.
The object and field data preview is available on Cloud but not on Desktop. On Desktop, configure fields using the Query Builder field list or a SOQL query.
On Cloud, custom domain support across all authentication methods is not available. Use a supported method for your Cloud connection, or connect from Desktop where custom domain works with all methods.
The workflow migration utility runs on Desktop only.
On Cloud, the built-in app connection creation flow is not offered. Use a Custom OAuth app or Salesforce Credentials on Cloud.
The datatypes produced from the same object can differ between Cloud and Desktop.
On Cloud, loading a dataset can fail for some objects. If a specific object does not load, try a SOQL Custom Query for that object or reduce the selected fields.
The connector is generally available on Desktop. Cloud support is in progress and not yet generally available.

Notes de publication des connecteurs Salesforce

Compatibilité avec Designer (à discuter)

Version majeure xxxx.x.x.xxxxx du COnnecteur
ID JIRA	Requires Designer 2025.1.2 Patch 7, 2025.2.1 Patch 5, 2026.1 Patch 2, or 2026.2 GA for all authentication methods. Uses DCM and communicates via Salesforce API v61+ (Summer '24). DCM-based connections with a simplified connection setup (a single Environment URL, and Custom OAuth that exposes Redirect URI and Scope). Input: Query Builder: field Select All, search, count, filter, record limit. Read from Report with no record cap. SOQL Custom Query with validation. Choose API version. Output Insert, Update, Delete, and new Upsert action. Batch processing Choose API version. Fixed an issue where reading from a Salesforce report was limited to a fixed number of records (2000). This works only when using the standard REST API. Fixed an issue where DateTime values were returned as 00:00:00, and empty values are now handled correctly. Select All is now available on the column list. Reusing an idle Custom OAuth DCM connection no longer fails with a token error. Built-in app OAuth now authenticates correctly. Dataset loading can fail for certain objects on Cloud. Preview by schema is disabled for a Salesforce Custom Query.

Version majeure xxxx.x.x.xxxxx du COnnecteur

Description

ID JIRA

Requires Designer 2025.1.2 Patch 7, 2025.2.1 Patch 5, 2026.1 Patch 2, or 2026.2 GA for all authentication methods.
Uses DCM and communicates via Salesforce API v61+ (Summer '24).
DCM-based connections with a simplified connection setup (a single Environment URL, and Custom OAuth that exposes Redirect URI and Scope).
Input:
Query Builder: field Select All, search, count, filter, record limit.
Read from Report with no record cap.
SOQL Custom Query with validation.
Choose API version.
Output
Insert, Update, Delete, and new Upsert action.
Batch processing
Choose API version.
Fixed an issue where reading from a Salesforce report was limited to a fixed number of records (2000). This works only when using the standard REST API.
Fixed an issue where DateTime values were returned as 00:00:00, and empty values are now handled correctly.
Select All is now available on the column list.
Reusing an idle Custom OAuth DCM connection no longer fails with a token error.
Built-in app OAuth now authenticates correctly.
Dataset loading can fail for certain objects on Cloud.
Preview by schema is disabled for a Salesforce Custom Query.

Connecteurs autonomes Salesforce

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.

Notes de publication des outils Salesforce

Version	Description
v5.1.4	Compatible avec Designer 2021.4.2 correctif 6, 2022.1 correctif 4 et versions ultérieures. Compatible avec AMP Engine uniquement. DCM est requis pour exécuter ce connecteur dans Alteryx Server. Par défaut, le connecteur Salesforce définit la précision Time et DateTime sur millisecondes afin d'éviter les zéros de fin supplémentaires, tout en continuant de prendre en charge la résolution en nanosecondes lorsque le workflow l'exige. (TPM-4753, TPM-4736) Correction d'un problème où les outils Salesforce ignoraient les paramètres de proxy sur Server. (TPM-4647) Correction d'un problème où Server ne pouvait pas exécuter de workflows avec les outils Salesforce car ils dépendaient de jetons d'accès de Designer. (TPM-4846) Résolution d'un problème où les outils Développeur de Designer exposaient des valeurs secrètes dans les fichiers JSON renvoyés. (TPM-4788)
v5.1.3	Compatible avec Designer 2021.4.2 correctif 6, 2022.1 correctif 4 et versions ultérieures. Compatible avec AMP Engine uniquement. DCM est requis pour exécuter ce connecteur dans Alteryx Server. Ajout de la prise en charge des domaines Salesforce personnalisés lors de l'utilisation de DCM. Amélioration de l'authentification. Mise à jour du SDK vers la version 2.4.2. Mise à jour de l'API vers la dernière version. Correction du problème où les outils Salesforce ignoraient le script PAC lors de l'utilisation de DCM. (TPM-4620) Correction du problème où l'outil Entrée Salesforce ne parvenait pas à lire certaines colonnes de type date. (TPM-4604) Correction du problème où l'outil Sortie Salesforce ne pouvait pas afficher le mappage de champ pour l'opération de mise à jour. (TPM-4519) Correction du problème où les outils Salesforce affichaient « Accès refusé » si le jeton de sécurité n'avait pas été créé dans DCM. (TPM-4507) Correction du problème où la version de l'API des outils Salesforce n'était pas alignée en fonction de la balise front-end. (TPM-4493) Correction du problème où les outils Salesforce ne pouvaient pas se connecter à l'aide d'un domaine personnalisé. (TPM-4488) Correction du problème où les outils Salesforce avertissaient d'une troncature inattendue des horodatages. (TPM-4368) Correction du problème où l'outil Entrée Salesforce tronquait les valeurs lors de l'utilisation d'objets de relation imbriqués dans une requête SOQL personnalisée. (TPM-4367) Correction du problème où les outils Sortie Salesforce s'exécutaient indéfiniment si les workflows contenaient plusieurs outils Sortie Salesforce. (TPM-4268) Correction du problème où les outils Salesforce affichaient plusieurs versions d'API en tant qu'options sélectionnables. (TPM-4264) Correction du problème où l'outil Sortie Salesforce échouait à écrire des données avec les opérations d'insertion et de mise à jour. (TPM-4248) Correction du problème où les outils Salesforce ne pouvaient pas lire correctement le type de données pourcentage. (TPM-4174) Correction du problème où les outils Salesforce renvoyaient une erreur avec les champs de date personnalisés. (TPM-4051) Correction du problème où les outils Salesforce renvoyaient « Code d'erreur 400 : syntaxe de demande incorrecte ou méthode non prise en charge ». (TPM-3982) Correction du problème où les outils Salesforce montraient une baisse de performance. (TPM-3919) Correction du problème où l'outil Entrée Salesforce renvoyait le champ versionData sous forme d'URL au lieu d'un corps de document. (TPM-3662) Problèmes connus Certains champs apparaissent comme nuls après la mise à niveau vers la nouvelle version des outils Salesforce. (TPM-4805) Les connecteurs SDK ignorent le proxy sur Server (Galerie). (TPM-4647) Les outils de développement Designer HMTL exposent la valeur secrète dans le JSON renvoyé. (TPM-4788) Les requêtes renvoient des enregistrements nuls dans l'outil Entrée Salesforce. (TPM-4641)
v5.1.2	Compatible avec Designer 2021.4.2 correctif 6, 2022.1 correctif 4 et versions ultérieures. Compatible avec AMP Engine uniquement. DCM est requis pour exécuter ce connecteur dans Alteryx Server. Mise à jour pour une exécution sur Designer et Server 2024.1. Correction d'un problème où l'outil Entrée Salesforce échouait après 45 minutes d'exécution. (TPM-3556) Correction d'un problème où les métadonnées sources et de description étaient manquantes. (TPM-3486) Correction d'un problème où les outils Salesforce ignoraient les paramètres proxy. (TPM-3358) Correction d'un problème où l'outil Entrée Salesforce renvoyait l'erreur « Code d'erreur 401 : Aucune autorisation, voir les schémas d'autorisation ». (TDCE-449 et TDCE-361)
v5.1.1	Compatible avec Designer 2021.4.2 correctif 6, 2022.1 correctif 4 et versions ultérieures. Compatible avec AMP Engine uniquement. DCM est requis pour exécuter ce connecteur dans Alteryx Server. Mise à jour pour une exécution sur Designer et Server 2024.1. Correction d'un problème où l'authentification via l'application OAuth personnalisée ne fonctionnait pas. (TFLN-1912) Correction d'un problème où l'outil Entrée Salesforce s'exécutait en continu lorsqu'il était configuré pour lire un jeu de données vide. (TPM-2453) Problèmes connus L'outil Salesforce 5.1.1 ne fonctionne pas sur Designer FIPS et Server FIPS. Pour contourner le problème, utilisez la version 5.1.0. (TFLN-1982) Les métadonnées sources et de description sont actuellement manquantes dans les résultats du workflow. (TPM-3486)
v5.1.0	Compatible avec Designer 2021.4.2 correctif 6, 2022.1 correctif 4 et versions ultérieures. Compatible avec AMP Engine uniquement. Ajout de la prise en charge de DCM dans l'outil Sortie Salesforce. DCM est requis pour exécuter ce connecteur dans Alteryx Server. L'outil Sortie Salesforce est désormais compatible FIPS. Performances améliorées pour la fonctionnalité de configuration automatique. Ajout de l'option d'exécution à blanc dans l'outil Entrée Salesforce. Correction d'un problème où l'outil Entrée Salesforce 5.0.10 analysait les types de données de manière incorrecte. (TFLN-1676)
v5.0.10	Compatible avec Designer 2021.4.2 correctif 6, 2022.1 correctif 4 et versions ultérieures. Compatible avec AMP Engine uniquement. Ajout du support pour DCM. DCM est requis pour exécuter ce connecteur dans Alteryx Server. Compatible FIPS. Ajout de la prise en charge de l'authentification OAuth et des domaines personnalisés. Correction d'un problème où l'Entrée Salesforce n'affichait pas tous les champs et objets. (TPM-1579) Correction d'un problème où l'Entrée Salesforce analysait incorrectement le fichier PAC. (TFLN-1243) Correction d'un problème où l'Entrée Salesforce n'affichait pas la fenêtre de configuration lorsque la langue Designer était définie sur le français. (TDCE-119) Problèmes connus L'outil Rapports répertorie uniquement les rapports récents, pas tous les rapports disponibles pour l'utilisateur. L'outil Rapports ne renvoie que les 2 000 premiers enregistrements.
v4.2.4	Correction d'un défaut d'analyse des requêtes personnalisées à partir de l'outil Entrée Salesforce. Les tâches d'entrée Salesforce n'échoueront plus lorsqu'elles sont planifiées ou exécutées à partir de la ligne de commande. Correction d'un défaut de vérification des certificats dans l'outil Entrée Salesforce. Prise en charge du téléchargement de l'outil Entrée Salesforce vers Gallery sans jeton.
v4.1.0	Ajout de la prise en charge de la connexion via un proxy en utilisant la détection et la configuration automatiques. Compatible avec la version d'Alteryx 2019.2 et ultérieure.
v4.0.0	Ajout de la possibilité d'interroger les rapports Salesforce. Le générateur de requête et la requête personnalisée renvoient tous les enregistrements (y compris ceux qui sont supprimés) par défaut. Ajoutez « IsDeleted=False » dans la clause WHERE pour exclure les enregistrements supprimés. Compatible avec la version d'Alteryx 2018.3 - 2019.2.
v3.1	Correction des défauts relatifs à la limite d'enregistrement sous l'onglet Exécution de Configuration du workflow et aux mots de passe contenant des caractères spéciaux XML. Compatible avec la version d'Alteryx 11.0 - 2018.2.

Notes de publication de l'outil Sortie Salesforce (obsolète)

Version	Description
v1.3.1	Mise à jour de méta-infos de l'outil.
v1.3	Mise à jour de la version de l'API Salesforce dans le moteur de macro. Correction du défaut d'échappement des caractères.
v1.2	Les champs DateHeure sont convertis automatiquement au format AAAA-MM-DDThh:mm:ss.sss. Problème résolu : les messages d'erreur « Le nom de la table est requis » et « L'opération de sortie est nécessaire » s'affichent alors que l'utilisateur n'est pas encore connecté.