Salesforce-Connector in Jitterbit Studio
Zusammenfassung
Der Salesforce-Connector stellt den Zugriff auf Salesforce her.
Der Salesforce-Connector bietet eine Schnittstelle zum Erstellen einer Salesforce-Verbindung, die Grundlage für die Generierung von Instanzen von Salesforce-Aktivitäten. Diese Aktivitäten interagieren nach der Konfiguration mit Salesforce über die Verbindung.
Der Salesforce-Connector wird über die Registerkarte Projektendpunkte und Connectors der Palette der Designkomponenten aufgerufen (siehe Palette der Designkomponenten).
Tipp
Integrations-Rezepte und Prozessvorlagen sind für diesen Connector über Jitterbit Marketplace verfügbar.
Connector-Übersicht
Dieser Connector wird zunächst zum Konfigurieren einer Salesforce-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann zum Erstellen von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) verwendet werden sollen.
Zusammen werden eine bestimmte Salesforce-Verbindung und ihre Aktivitäten als Salesforce-Endpunkt bezeichnet:
Es sind elf Aktivitäten verfügbar, fünf Standard- und sechs Massenaktivitäten. Massenaktivitäten sollten nur verwendet werden, wenn man keine Transformation benötigt, um Daten vor dem Erreichen des Ziels zu ändern.
-
Abfrage: Fragt Daten aus Salesforce ab und ist als Quelle zum Bereitstellen von Daten in einem Vorgang vorgesehen.
-
Einfügen: Fügt neue Daten in Salesforce ein und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Aktualisieren: Aktualisiert vorhandene Daten in Salesforce und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Upsert: Aktualisiert vorhandene Daten und fügt neue Daten in Salesforce ein und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Löschen: Löscht Daten in Salesforce und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Massenabfrage: Fragt eine große Anzahl von Datensätzen aus Salesforce ab und ist als Quelle zum Bereitstellen von Daten in einem Vorgang vorgesehen.
-
Masseneinfügung: Fügt eine große Anzahl neuer Datensätze in Salesforce ein und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Massenaktualisierung: Aktualisiert eine große Anzahl vorhandener Datensätze in Salesforce und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Massen-Upsert: Aktualisiert eine große Anzahl vorhandener Datensätze und fügt eine große Anzahl neuer Datensätze in Salesforce ein und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.
-
Massenlöschung: Löscht eine große Anzahl von Datensätzen aus Salesforce und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen. Gelöschte Datensätze werden im Salesforce-Papierkorb gespeichert, bevor sie endgültig gelöscht werden.
-
Bulk Hard Delete: Löscht eine große Anzahl von Datensätzen aus Salesforce endgültig und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen. Endgültig gelöschte Datensätze werden automatisch zum Löschen freigegeben.
Hinweis
Dieser Connector ist ein nativer Studio-Connector, auf den sich Jitterbit bei der Kommunikation von Änderungen an Connectoren beziehen kann. Der Veröffentlichungsplan für native Studio-Connectoren basiert auf dem Rhythmus der Harmony-Portal-Webanwendungen.
Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf die Lizenz angerechnet.
Voraussetzungen und unterstützte API-Versionen
Der Salesforce-Connector unterstützt die Verwendung von Harmony Cloud- oder Private Agents in Version 9.4.2 oder höher.
Beim Konfigurieren einer Salesforce-Verbindung mit Standardauthentifizierung ist ein Salesforce-Konto erforderlich, für das die Multi-Faktor-Authentifizierung (MFA) nicht aktiviert ist. Um ein Salesforce-Konto ohne MFA zu konfigurieren, stelle sicher, dass das Permission Set, das dem Salesforce-Systemintegrations-Login zugewiesen ist, nicht die Option Multi-Factor Authentication for API Logins ausgewählt hat. Systemintegrations-Login-Typen sind von der MFA-Anforderung von Salesforce ausgenommen, wie in der Salesforce-Dokumentation unter Is MFA required for my integration users? in den Salesforce Multi-Factor Authentication FAQ beschrieben.
Beim Konfigurieren einer Salesforce-Verbindung mit 2-legged OAuth 2.0-Authentifizierung findest du weitere Informationen in den 2-legged OAuth 2.0-Voraussetzungen.
Hinweis
Agent-Version 11.59 / 12.3 oder höher ist erforderlich, um 2-legged OAuth 2.0 mit dem Salesforce-Connector zu verwenden.
Die API-Version, die der Connector für Nicht-Bulk-Aktivitäten verwendet, hängt von der Jitterbit-Agent-Version ab:
| Jitterbit-Agent-Version | Salesforce SOAP API-Version | Salesforce-Release |
|---|---|---|
| 12.10 oder höher (OAuth 2.0) | 67.0 | Summer '26 |
| 12.7 bis 12.9 (OAuth 2.0) | 66.0 | Spring '26 |
| 12.4 bis 12.6 (OAuth 2.0) | 65.0 | Winter '26 |
| 12.3 oder höher (Standardauth oder keine Auth) 11.47 bis 11.59 (Standardauth oder keine Auth) |
64.0 | Summer '25 |
| 11.41 bis 11.46 | 63.0 | Spring '25 |
| 11.35 bis 11.40 | 62.0 | Winter '25 |
| 11.30 bis 11.34 | 61.0 | Summer '24 |
| 11.23 bis 11.29 10.85 bis 10.87 |
60.0 | Spring '24 |
| 11.18 bis 11.22 10.80 bis 10.84 |
59.0 | Winter '24 |
| 11.11 bis 11.17 10.73 bis 10.79 |
58.0 | Summer '23 |
| 11.7 bis 11.10 10.69 bis 10.72 |
57.0 | Spring '23 |
| 11.0 bis 11.6 10.55 bis 10.68 |
54.0 | Spring '22 |
| 10.44 bis 10.54 | 52.0 | Summer '21 |
| 10.42 bis 10.43 | 51.0 | Fall '21 |
| 10.28 bis 10.41 | 50.0 | Winter '21 |
| 10.23 bis 10.27 | 49.0 | Summer '20 |
| 10.17 bis 10.22 | 48.0 | Spring '20 |
| 10.11 bis 10.16 | 47.0 | Winter '20 |
| 10.3 bis 10.10 | 45.0 | Spring '19 |
| 9.8 bis 10.2 | 44.0 | Winter '19 |
| 9.4.2 bis 9.7 | 41.0 | Winter '18 |
Die SOAP-basierte Salesforce Bulk API wird für Massenaktivitäten verwendet.
Die Salesforce Bulk API verwendet einen X-SFDC-Session-Header, der mit einer Session-ID gefüllt wird, die über einen Salesforce SOAP API login()-Aufruf für gültige Anfragen abgerufen wird.
Agent-Upgrades, die Salesforce SOAP API-Versionen überspringen, beinhalten implizit Unterstützung für dazwischenliegende API-Versionen.
Weitere Informationen zu den Schemafeldern finden Sie in der Dokumentation unter den obigen Links.
Fehlerbehebung und Anleitungen
Weitere Informationen finden Sie unter Salesforce-Connector-Fehlerbehebung. Das Connector-Fehlerbehebungs-Handbuch behandelt auch Salesforce Events-Probleme: Events können nach Agent-Neustart nicht aktiviert werden und Einschränkungen bei Listening-Aktivitäten. Darüber hinaus bieten die folgenden Anleitungsseiten detaillierte Anweisungen zum Ausführen bestimmter Aufgaben mit Integrationsprojekten, die den Salesforce-Connector verwenden:
Zusätzliche Ressourcen
Die folgenden Jitterbit Microlearning-Tutorials sind über unsere Jitterbit Basics-Videoserie verfügbar: