Salesforce
Mit dem Salesforce-Konnektor können Sie eine Verbindung zu Salesforce in Designer herstellen. Verwenden Sie den Konnektor, um Daten aus Salesforce-Objekten auszulesen und Daten zurück in Salesforce zu schreiben. Dabei kommt ein einziger Konnektor zum Einsatz, der in Alteryx Designer (Desktop) und Alteryx One (Cloud) auf die gleiche Weise funktioniert.
Salesforce ist als Datenquelle im Eingabedaten- und im Datenausgabe-Tool sowie in den eigenständigen Salesforce-Eingabe- und Salesforce-Ausgabe-Tools verfügbar.
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.
Salesforce-Konnektoreinrichtung
Salesforce ist in Designer ab 2025.1.2 Patch 7 verfügbar. Wenn Sie den Salesforce-Konnektor bereits zuvor verwendet haben, sehen Sie bei Migration zu einheitlichem Konnektor nach.
Voraussetzungen
Stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllt haben, bevor Sie fortfahren:
Anforderung | Beschreibung |
|---|---|
Designer-Version |
|
Benutzerdefinierte App-Einrichtung (OAuth 2,0), falls verwendet | Eine mit Salesforce verbundene App, mit Client-ID, Client-Geheimnis, Umleitungs-URI (muss mit der verbundenen App übereinstimmen) und Geltungsbereich |
Umgebungs-URL | Produktion (Standard), Sandbox oder benutzerdefinierte Domain |
DCM | Sie müssen DCM in Designer aktivieren. Gehen Sie zu Optionen > Erweiterte Einstellungen > DCM, um das Tool zu aktivieren. |
Konnektor installieren
Sie können die neueste Version des Salesforce-Konnektors ganz einfach über die Add-ons in Designer installieren. Dies ist die empfohlene Installationsmethode, mit der Sie Konnektoren durchsuchen, installieren und aktualisieren können, ohne Designer zu verlassen oder den Alteryx Marketplace zu besuchen.
So installieren Sie den Konnektor:
Gehen Sie in Designer zu Add-ons > Marketplace-Add-ons verwalten. Es wird eine Liste der verfügbaren Konnektoren angezeigt.
Wählen Sie den Salesforce-Konnektor aus und gehen Sie dann auf Installieren. Designer lädt das Paket herunter und installiert es. Designer erfordert möglicherweise einen Neustart, um die Installation abzuschließen.
Nach Abschluss der Installation und der Einrichtung ist der Salesforce-Konnektor über das Eingabedaten-Tool und das Datenausgabe-Tool verfügbar.
Eine Verbindung einrichten
So verbinden Sie Salesforce über DCM:
Ziehen Sie das Dateneingabe-Tool oder das Datenausgabe-Tool auf den Canvas und wählen Sie Mit Daten verbinden aus.
Wählen Sie in der Konnektoreinrichtung die Option Datenverbindung erstellen oder durchsuchen aus.
Wenn Sie zuvor eine Salesforce-Verbindung erstellt haben, können Sie die Verbindung auf der Registerkarte Zuletzt verwendete auswählen.
Wählen Sie + Neu aus. Wählen Sie in der Liste der Technologien Salesforce aus.
Wählen Sie Schnellverbindung und anschließend Verbindung einrichten aus. Das Fenster Verbindungen öffnet sich.
Wählen Sie +Neu aus.
Geben Sie den Verbindungsnamen und den Datenquellennamen an. Wählen Sie die Umgebung aus.
Wählen Sie im Abschnitt Anmeldedaten Ihre Authentifizierungsmethode aus und geben Sie den Anmeldenamen ein. Weitere Informationen finden Sie unter Authentifizierungsmethoden.
Wählen Sie Speichern aus.
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.
Migration zu einheitlichem Konnektor
Wenn Sie den Salesforce Connector bereits in Alteryx verwenden, lesen Sie den Abschnitt unten. Es wird beschrieben, was in der einheitlichen Version geändert wurde.
Parameter | Legacy-Konnektor | Einheitlicher Konnektor (v6.1.0) |
|---|---|---|
Plattformen und Tools | Desktop (Eingabe und Ausgabe) Cloud (nur Eingabe) | Desktop (Eingabe und Ausgabe) Cloud (Eingabe und Ausgabe, in Bearbeitung) |
Rahmenwerk | Python SDK (Desktop) Der CData ODBC-Treiber (Cloud) ermöglicht die Verbindung zu verschiedenen Datenquellen in der Cloud. | Das EACD-Framework (Desktop und Cloud) ist ein Rahmenwerk, das die Integration von Desktop- und Cloud-Anwendungen ermöglicht. |
Kommunikation/API | Salesforce-API-Version 52 (Sommer 2021) | Salesforce API v61+ (Sommer 2024) |
Authentifizierungsmethoden | OAuth 2.0 Benutzername + Kennwort + Sicherheitstoken | Gleiche Methoden mit erweiterter Konfiguration |
Verbindungsmodell | Separate Auswahlmöglichkeiten für Produktion / Sandbox / benutzerdefinierte URL | DCM mit einem einzelnen Feld für die Umgebungs-URL |
Wichtige Änderungen
Die Dropdown-Optionen für Produktion, Sandbox und benutzerdefinierte URL wurden durch ein einziges Feld für die Umgebungs-URL ersetzt. Konfigurieren Sie alle Workflows neu, in denen diese Dropdown-Liste verwendet wurde.
Die Umgebungs-URL ersetzt das alte Dropdown
https://login.salesforce.com(Produktion, Standard),https://test.salesforce.com(Sandbox), oder Ihre benutzerdefinierte Domain.Bei der Authentifizierung der Salesforce-Anmeldedaten werden nun auch die Client-ID und das Client-Secret erforderlich.
Auf dem Desktop funktionieren benutzerdefinierte Domänen nun mit allen Authentifizierungsmethoden (bisher nur OAuth).
Vorhandene Workflows können mit dem Alteryx Hilfsprogramm für Workflow-Migration in Designer 2025.2 Patch 3 oder höher migriert werden. Weitere Informationen finden Sie unter Hilfsprogramm für Workflow-Migration.
Anmerkung
Die Migrations-Funktion ist nur auf dem Desktop verfügbar.
Nach der Installation des einheitlichen Konnektors werden ggf. sowohl die veralteten als auch die einheitlichen Salesforce-Technologien unter Verbindungen verwalten aufgeführt. Dies wird während des Übergangs erwartet. Verwenden Sie den einheitlichen Konnektor für alle neuen Arbeiten.
Informationen zum Salesforce-Konnektor
Eingabe- und Ausgabe-Tools
Die Salesforce-Eingabe- und Ausgabetools werden verwendet, um Daten von Salesforce zu lesen und in Salesforce zu schreiben.
Salesforce-Eingabe
Salesforce Input liest Standard- und benutzerdefinierte Objekte. Es gibt drei Möglichkeiten, wie Sie lesen können:
Query Builder: Wählen Sie ein Objekt und dazu die Felder aus, die gelesen werden sollen. Die Feldauswahl bietet eine Mehrfachauswahl-Liste mit „Alle auswählen“, „Suche nach Zeichenfolge oder Teilzeichenfolge“, einer Live-Zählung der ausgewählten Felder im Vergleich zu den Gesamtfeldern, und einem Filter, um nur die Auswahl anzuzeigen. Es kann auch eine Datensatzgrenze festgelegt werden. Es stehen vier Feldmodi zur Verfügung: Alle Standardfelder lesen, Alle benutzerdefinierten Felder lesen, Alle Felder lesen und Manuell auswählen.
Benutzerdefinierte Abfrage (SOQL): Schreiben Sie eine SOQL-Abfrage, um Standard- und benutzerdefinierte Objekte zu lesen, einschließlich
__r-Beziehungsfeldern, und validieren Sie dann vor der Ausführung. Eine benutzerdefinierte Abfrage gibt immer eine einzelne Tabelle zurück.Aus Bericht lesen: Navigieren Sie zu bzw. suchen sie nach gespeicherten Berichten, wählen Sie einen Bericht aus und parsen Sie die Ergebnisse.
Salesforce-Ausgabe
Salesforce Output schreibt Zeilen in ein Standard- oder benutzerdefiniertes Objekt. Wählen Sie eine Aktion aus:
Einfügen: Neue Datensätze hinzufügen.
Aktualisieren: vorhandene Datensätze ändern. Erfordert die Salesforce-Datensatz-ID.
Löschen: Datensätze entfernen. Erfordert die Salesforce-Datensatz-ID.
Aktualisieren: Fügen Sie neue Datensätze ein, und aktualisieren Sie vorhandene Datensätze in einem einzigen Vorgang.
Die Ausgabeprozesse verarbeiten Datensätze in Batches und ermöglichen die Auswahl der Salesforce-API-Version. Wenn Sie Aktualisierung, Löschen oder Upsert verwenden, geben Sie die Datensatz-ID als primären Schlüssel in Ihre Daten ein.
Objektmodellierung
Salesforce speichert Daten in Objekten, die sich wie Datenbanktabellen verhalten:
Standardobjekte sind integriert, z. B. Konto, Kontakt, Lead, Chance, Fall, Kampagne, Aufgabe, Ereignis und Benutzer.
Benutzerdefinierte Objekte werden in Ihrer Organisation erstellt und enden mit
__c, zum BeispielRechnung__c.Beziehungsfelder zwischen Objekten verwenden das
Suffix __r und können in SOQL referenziert werden.
Authentifizierungsmethoden
Salesforce unterstützt drei Authentifizierungsmethoden. Verwenden Sie die nachstehende Tabelle, um die richtige für Ihren Anwendungsfall auszuwählen.
Methode | Pflichtfelder | Desktop (Flagship) | Cloud (Alteryx One) |
|---|---|---|---|
Integrierte App (OAuth 2.0) | Keine | Ja | Nicht verfügbar (Erstellung einer integrierten Verbindung wird nicht in der Cloud angeboten) |
Benutzerdefinierte App (OAuth 2.0) | Client-ID, Client-Geheimnis, Umleitungs-URI (standardmäßig | Ja | Ja |
Salesforce-Anmeldedaten (Benutzername, Kennwort, Sicherheitstoken) | Benutzername, Kennwort, Sicherheitstoken (optional), Client-ID, Client-Geheimnis | Ja | Ja |
Benutzerdefinierte Domain für alle Methoden | N/V | Ja | Diese Funktion ist nicht verfügbar, da benutzerdefinierte Domains nicht für alle Methoden in der Cloud unterstützt werden. |
OAuth unterstützt sowohl den Autorisierungscode-Flow (Benutzer zu Anwendung) als auch den Client-Anmeldedaten-Flow (Dienstprinzipal, für Headless- oder geplante Automatisierung).
Beschränkungen
Der Konnektor unterstützt keinen Probelauf für Lesevorgänge oder benutzerdefinierte Abfragen. Führen Sie den Workflow aus, um Daten abzurufen, oder verwenden Sie den SOQL-Validierungsschritt, um eine benutzerdefinierte Abfrage vor der Ausführung zu prüfen.
Bei Objekten mit mehr als 200 Feldern schlagen die Modi "Alle benutzerdefinierten Felder lesen" und "Alle Felder lesen" fehl. Verwenden Sie Manuell auswählen, um die benötigten Felder auszuwählen, oder erstellen Sie eine benutzerdefinierte SOQL-Abfrage, um die gewünschten Felder aufzulisten.
Eine benutzerdefinierte SOQL-Abfrage gibt immer eine Tabelle zurück. Um Daten aus mehreren Objekten zu kombinieren, fügen Sie sie in der SOQL-Abfrage zusammen. Sie können auch mehrere Eingabe-Tools verwenden und die Ergebnisse im Workflow kombinieren.
Die Option Aus Bericht lesen unterstützt die Auswahl eines einzelnen Berichts für jedes Eingabe-Tool. Verwenden Sie mehrere Eingabewerkzeuge, um mehrere Berichte zu lesen.
Der Konnektor nutzt die Salesforce REST API. Die Salesforce Bulk-API wird noch nicht unterstützt. Für sehr große Lese- oder Schreibvorgänge gelten die Grenzwerte für den REST-API-Durchsatz und die Salesforce-API.
Die Vorschau von Objekt- und Felddaten ist in der Cloud verfügbar, aber nicht auf dem Desktop. Auf dem Desktop: Konfigurieren Sie Felder mithilfe der Query Builder-Feldliste oder einer SOQL-Abfrage.
In der Cloud ist keine benutzerdefinierte Domainunterstützung für alle Authentifizierungsmethoden verfügbar. Verwenden Sie eine unterstützte Methode für Ihre Cloud-Verbindung, oder stellen Sie eine Verbindung vom Desktop her, wo die benutzerdefinierte Domain mit allen Methoden funktioniert.
Das Workflow-Migrations-Dienstprogramm läuft nur auf dem Desktop.
In der Cloud wird der integrierte Ablauf zum Erstellen von App-Verbindungen nicht angeboten. Verwenden Sie eine benutzerdefinierte OAuth-App oder Salesforce-Zugangsdaten in der Cloud.
Die Datentypen, die aus demselben Objekt erstellt werden, können sich zwischen Cloud und Desktop unterscheiden.
In der Cloud kann das Laden eines Datasets für einige Objekte fehlschlagen. Wenn ein bestimmtes Objekt nicht geladen wird, versuchen Sie eine benutzerdefinierte SOQL-Abfrage für dieses Objekt, oder reduzieren Sie die ausgewählten Felder.
Der Connector ist in der Regel auf dem Desktop verfügbar, kann aber auch auf anderen Plattformen genutzt werden. Cloud-Support ist in Bearbeitung und noch nicht allgemein verfügbar.
Salesforce Version 6.1.0
Konnektor Release-Version 6.1.0 | |
|---|---|
Version | Beschreibung |
v6.1.0 |
|
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. |
Version | Beschreibung |
|---|---|
v5.1.4 |
|
v5.1.3 |
Bekannte Probleme
|
v5.1.2 |
|
v5.1.1 |
Bekannte Probleme
|
v5.1.0 |
|
v5.0.10 |
Bekannte Probleme
|
v4.2.4 |
|
v4.1.0 |
|
v4.0.0 |
|
v3.1 |
|
Version | Beschreibung |
v1.3.1 |
|
v1.3 |
|
v1.2 |
|
Anmerkung
Die AMP Engine muss für Workflows aktiviert sein, die das Salesforce-Eingabe-Tool ab Version 2.2.0 enthalten.
Informationen zum Einrichten einer benutzerdefinierten API-Anwendung für dieses Tool finden Sie in diesem Handbuch.
Wenn Sie eine PAC-Datei verarbeiten möchten, die Anfragen über mehrere Proxy-IPs weiterleitet, verwenden Sie Sicherheits-Token.
Benutzerdefinierte Salesforce-Domains
Die Salesforce-Tools unterstützen benutzerdefinierte Salesforce-Domains.
So stellen Sie manuell eine Verbindung zu einer benutzerdefinierten Domain her:
Wählen Sie im Konfigurationsfenster der Salesforce-Tools die Option Benutzerdefinierte Umgebungs-URL verwenden aus.
Geben Sie Ihre benutzerdefinierte Domain bei Benutzerdefinierte Umgebung ein.
So stellen Sie über den DCM eine Verbindung zu einer benutzerdefinierten Domain her:
Wählen Sie Verbindung einrichten aus. Der DCM wird geöffnet.
Wählen Sie +Neu aus. Das Fenster „Neue Datenquelle“ öffnet sich. Die Salesforce-Technologie ist bereits ausgewählt.
Wählen Sie unter Umgebung die Option Benutzerdefiniert aus.
Geben Sie Ihre benutzerdefinierte Domäne in der Benutzerdefinierten Umgebung ein und klicken Sie auf Speichern.
