Salesforce

Mit dem Salesforce-Konnektor können Sie eine Verbindung zu Salesforce in Designer herstellen.

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.

Neue Konnektorversion in Designer

Der Salesforce-Konnektor ist jetzt Teil der Alteryx One-Konnektoren. Lesen Sie sich die Informationen auf dieser Seite sorgfältig durch, um sicherzustellen, dass Sie die entsprechenden Tools richtig verwenden.

Wenn Sie den Salesforce-Konnektor in Ihren Designer-Workflows aktualisieren möchten, können Sie das Hilfsprogramm für Workflow-Migration verwenden.

Details zum Salesforce-Konnektor

Salesforce ist in Designer 2025.2 Patch 3 oder höher als Datenquelle für das Eingabedaten-Tool verfügbar. Erfahren Sie mehr über die Dateityp-Optionen unter [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

Konnektor installieren

Sie können die neueste Version des Salesforce-Konnektors ganz einfach über die Add-ons in Designer installieren. Wenn Sie Konnektoren auf diese Weise installieren, müssen Sie Alteryx Marketplace nicht besuchen.

So installieren Sie den Konnektor:

Gehen Sie in Designer auf Add-ons > Marketplace-Add-ons verwalten.
Designer öffnet ein Fenster mit einer Liste der verfügbaren Konnektoren.
Geben Sie Salesforce in die Suchleiste ein.

Verbindung mit dem DCM einrichten

So verbinden Sie Salesforce mit dem DCM:DCM – Designer

Ziehen Sie das Eingabedaten- oder Datenausgabe-Tool aus der Tool-Palette auf den Canvas und wählen Sie es aus.
Wenn Sie bereits eine Google Drive-Verbindung erstellt haben, können Sie Datenquellen > Salesforce > Schnellverbindung auswählen und mit Schritt 12 fortfahren.
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.
Wählen Sie im Fenster Datenverbindungen die Option Datenquellen aus.
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.
Wählen Sie Speichern aus. Sie haben auch die Möglichkeit, die Verbindung vor dem Speichern zu testen.
Wählen Sie Verbinden aus. Salesforce kann eine Authentifizierung anfordern.
Wählen Sie im Dateiauswahl-Fenster die Datei aus, aus der Sie lesen oder in die Sie schreiben möchten.
Wählen Sie im Fenster Optionen die Lese- oder Schreibkonfiguration aus.
Wählen Sie Bestätigen, um eine Verbindung zur Datei herzustellen. Anschließend können Sie mit der Erstellung Ihres Workflows fortfahren.

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.

Authentifizierungsmethoden

Salesforce unterstützt…

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.

Anmerkung

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.

Versionshinweise zu Salesforce-Konnektor

Kompatibilität mit Designer (noch klären)

Konnektor-Version xxxx.x.x.xxxxx
JIRA-ID	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.

Konnektor-Version xxxx.x.x.xxxxx

Beschreibung

JIRA-ID

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.

Eigenständige Salesforce-Konnektoren

Verbindungstyp	Alteryx-Tools. Die aktuellste Version ist im Alteryx Marketplace verfügbar.
Typ der Unterstützung	Lesen und Schreiben
Validiert am	ODBC Client Version 2.2.20 ist auch für die Dateneingabe- und -ausgabe-Tools verfügbar.

Versionshinweise zu Salesforce-Tools

Version	Beschreibung
v5.1.4	Kompatibel mit Designer 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Nur mit AMP Engine kompatibel. Für die Ausführung dieses Konnektors in Alteryx Server ist DCM erforderlich. Der Salesforce-Konnektor setzt die Genauigkeit von Zeit und Datum/Uhrzeit standardmäßig auf Millisekunden, um zusätzliche nachgestellte Nullen zu vermeiden. Wenn der Workflow es erfordert, wird die Auflösung in Nanosekunden jedoch weiterhin unterstützt. (TPM-4753, TPM-4736) Problem behoben, bei dem die Salesforce-Tools die Proxy-Einstellungen auf Server ignoriert haben. (TPM-4647) Problem behoben, bei dem Server Workflows mit den Salesforce-Tools nicht ausführen konnte, da sie von Zugriffstoken von Designer abhängig waren. (TPM-4846) Problem behoben, bei dem die Entwicklertools von Designer Geheimniswerte in den zurückgegebenen JSON-Dateien gezeigt haben. (TPM-4788)
v5.1.3	Kompatibel mit Designer 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Nur mit AMP Engine kompatibel. Für die Ausführung dieses Konnektors in Alteryx Server ist DCM erforderlich. Unterstützung für benutzerdefinierte Salesforce-Domains bei Verwendung des DCM hinzugefügt. Authentifizierung verbessert. SDK auf Version 2.4.2 aktualisiert. API auf die neueste Version aktualisiert. Problem behoben, bei dem das PAC-Skript bei Verwendung des DCM von den Salesforce-Tools ignoriert wurde. (TPM-4620) Problem behoben, bei dem bestimmte Datumstypspalten nicht vom Salesforce-Eingabe-Tool gelesen wurden. (TPM-4604) Problem behoben, bei dem das Salesforce-Ausgabe-Tool die Feldzuordnung für den Aktualisierungsvorgang nicht anzeigen konnte. (TPM-4519) Problem behoben, bei dem die Salesforce-Tools „Zugriff verweigert“ anzeigten, wenn das Sicherheitstoken nicht im DCM erstellt worden war. (TPM-4507) Problem behoben, bei dem die API-Version in den Salesforce-Tools nicht entsprechend dem Frontend-Tag angepasst war. (TPM-4493) Problem behoben, bei dem die Salesforce-Tools keine Verbindung über eine benutzerdefinierte Domain herstellen konnten. (TPM-4488) Problem behoben, bei dem die Salesforce-Tools vor einem unerwarteten Abschneiden der Zeitstempel warnten. (TPM-4368) Problem behoben, bei dem vom Salesforce-Eingabe-Tool Werte abgeschnitten wurden, wenn verschachtelte Beziehungsobjekte in einer benutzerdefinierten SOQL-Abfrage verwendet wurden. (TPM-4367) Problem behoben, bei dem die Salesforce-Ausgabe-Tools unbegrenzt ausgeführt wurden, wenn die Workflows mehrere Salesforce-Ausgabe-Tools enthalten. (TPM-4268) Problem behoben, bei dem von den Salesforce-Tools mehrere API-Versionen als auswählbare Optionen angezeigt wurden. (TPM-4264) Problem behoben, bei dem das Salesforce-Ausgabe-Tool keine Daten mit den Einfügungs- und Aktualisierungsvorgängen schreiben konnte. (TPM-4248) Problem behoben, bei dem die Salesforce-Tools den Prozentsatz-Datentyp nicht korrekt lesen konnten. (TPM-4174) Problem behoben, bei dem von den Salesforce-Tools ein Fehler bei benutzerdefinierten Datumsfeldern zurückgegeben wurde. (TPM-4051) Problem behoben, bei dem von den Salesforce-Tools „Fehlercode 400: Unzulässige Anfragesyntax oder nicht unterstützte Methode“ zurückgegeben wurde. (TPM-3982) Problem behoben, bei dem die Salesforce-Tools langsame Leistung zeigten. (TPM-3919) Problem behoben, bei dem das versionData-Feld vom Salesforce-Eingabe-Tool als URL zurückgegeben wurde anstatt als Dokumenttext. (TPM-3662) Bekannte Probleme Bestimmte Felder werden nach dem Upgrade auf die neue Version der Salesforce-Tools als Null angezeigt. (TPM-4805) SDK-Konnektoren ignorieren Proxy auf Server (Gallery). (TPM-4647) Designer-HMTL-Entwicklertools zeigen in der zurückgegebenen JSON einen Geheimniswert. (TPM-4788) Abfragen im Salesforce-Eingabe-Tool geben Null-Datensätze zurück. (TPM-4641)
v5.1.2	Kompatibel mit Designer 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Nur mit AMP Engine kompatibel. Für die Ausführung dieses Konnektors in Alteryx Server ist DCM erforderlich. Aktualisiert, sodass Ausführung auf Designer und Server 2024.1 möglich ist. Problem behoben, bei dem das Salesforce-Eingabe-Tool nach 45 Minuten fehlgeschlagen ist. (TPM-3556) Problem behoben, bei dem die Quell- und Beschreibungsmetadaten fehlten. (TPM-3486) Problem behoben, bei dem die Salesforce-Tools Proxyeinstellungen ignoriert haben. (TPM-3358) Problem behoben, bei dem das Salesforce-Eingabe-Tool den Fehler „Fehlercode 401: Keine Berechtigung, siehe Autorisierungsschemata.“ zurückgegeben hat. (TDCE-449 und TDCE-361)
v5.1.1	Kompatibel mit Designer 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Nur mit AMP Engine kompatibel. Für die Ausführung dieses Konnektors in Alteryx Server ist DCM erforderlich. Aktualisiert, sodass Ausführung auf Designer und Server 2024.1 möglich ist. Problem behoben, bei dem die Authentifizierung über eine benutzerdefinierte OAuth-Anwendung nicht funktioniert hat. (TFLN-1912) Problem behoben, bei dem das Salesforce-Eingabe-Tool unbegrenzt ausgeführt wurde, wenn es zum Lesen eines leeren Datasets konfiguriert wurde. (TPM-2453) Bekannte Probleme Das Salesforce Tool 5.1.1 funktioniert nicht auf Designer-FIPS und Server-FIPS. Verwenden Sie als Workaround bitte Version 5.1.0. (TFLN-1982) Quell- und Beschreibungsmetadaten fehlen derzeit in Workflowergebnissen. (TPM-3486)
v5.1.0	Kompatibel mit Designer 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Nur mit AMP Engine kompatibel. Salesforce-Ausgabe-Tool um Unterstützung für den DCM ergänzt. Für die Ausführung dieses Konnektors in Alteryx Server ist DCM erforderlich. Das Salesforce-Ausgabe-Tool ist jetzt FIPS-fähig. Leistung der automatischen Konfigurationsfunktion verbessert. Probelauf-Option zum Salesforce-Eingabe-Tool hinzugefügt. Problem behoben, bei dem das Salesforce-Eingabe-Tool 5.0.10 Datentypen falsch parste. (TFLN-1676)
v5.0.10	Kompatibel mit Designer 2021.4.2 Patch 6, 2022.1 Patch 4 und höher. Nur mit AMP Engine kompatibel. Unterstützung für DCM hinzugefügt. Für die Ausführung dieses Konnektors in Alteryx Server ist DCM erforderlich. FIPS-fähig. Unterstützung für OAuth-Authentifizierung und benutzerdefinierte Domänen hinzugefügt. Problem behoben, bei dem die Salesforce-Eingabe nicht alle Felder und Objekte anzeigt. (TPM-1579) Problem behoben, bei dem die Salesforce-Eingabe die PAC-Datei falsch geparst hat. (TFLN-1243) Problem behoben, bei dem die Salesforce-Eingabe das Konfigurationsfenster nicht anzeigt, wenn die Sprache in Designer auf Französisch eingestellt war. (TDCE-119) Bekannte Probleme Unter „Berichte“ werden nur aktuelle Berichte aufgeführt, nicht alle Berichte, die dem Benutzer zur Verfügung stehen. „Berichte“ gibt nur die ersten 2000 Datensätze zurück.
v4.2.4	Behebt einen Fehler, bei dem benutzerdefinierte Abfragen nicht vom Salesforce-Eingabe-Tool geparst werden können. Die Salesforce-Eingabe-Jobs funktionieren nun, wenn sie über die Befehlszeile geplant oder ausgeführt werden. Behebt einen Fehler bei der Zertifikatüberprüfung im Salesforce-Eingabe-Tool. Unterstützt das Hochladen des Salesforce-Eingabe-Tools ohne Token in Gallery.
v4.1.0	Zusätzliche Unterstützung für die Verbindung über einen Proxy mit automatischer Erkennung und Konfiguration. Kompatibel mit Alteryx ab Version 2019.2.
v4.0.0	Zusätzliche Möglichkeit zur Abfrage von Salesforce-Berichten. Query Builder und Custom Query geben standardmäßig alle Datensätze zurück (einschließlich gelöschter). Fügen Sie „IsDeleted=False“ zur WHERE-Klausel hinzu, um gelöschte Datensätze auszuschließen. Kompatibel mit Alteryx Version 2018.3 bis 2019.2.
v3.1	Behebt Fehler für die Datensatzgrenze auf der Laufzeit-Registerkarte der Workflow-Konfiguration und von Kennwörtern mit XML-Sonderzeichen. Kompatibel mit Alteryx Version 11.0 bis 2018.2.

Versionshinweise zum Salesforce-Ausgabe-Tool (Veraltet)

Version	Beschreibung
v1.3.1	Tool-Metainformationen wurden aktualisiert.
v1.3	Salesforce-API-Version in Makro-Engine wurde aktualisiert. Fehler behoben, um Escape-Zeichen korrekt anzugeben.
v1.2	Datum/Uhrzeit-Felder werden automatisch in „JJJJ-MM-TT-hh:mm:ss.sss“ konvertiert. Fehler dort behoben, wo die Fehlermeldungen „Tabellenname ist erforderlich“ und „Ausgabevorgang ist erforderlich“ angezeigt wurden, obwohl der/die Benutzer:in noch nicht angemeldet war.