Zum Inhalt springen

Salesforce-Connector in Jitterbit Studio

Zusammenfassung

Der Salesforce-Connector stellt Zugriff auf Salesforce her.

Der Salesforce-Connector bietet eine Schnittstelle zum Erstellen einer Salesforce-Verbindung, die Grundlage für die Generierung von Salesforce-Aktivitätsinstanzen. Diese konfigurieren Aktivitäten interagieren über die Verbindung mit Salesforce.

Der Salesforce-Connector wird über die Registerkarte Projektendpunkte und Konnektoren der Palette des Designkomponenten aufgerufen (siehe Designkomponentenpalette).

Tipp

Integrationsrezepte und Prozessvorlagen sind für diesen Connector über den Jitterbit Marketplace verfügbar.

Connector-Übersicht

Mit diesem Connector wird zunächst eine Salesforce-Verbindung konfiguriert. Aktivitätstypen, die dieser Verbindung zugeordnet sind, werden dann zur Erstellung von Aktivitätsinstanzen verwendet, die als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder Ziele (zum Verarbeiten von Daten in einem Vorgang) vorgesehen sind.

Zusammen werden eine bestimmte Salesforce-Verbindung und ihre Aktivitäten als Salesforce-Endpunkt bezeichnet:

Salesforce-Aktivitätstypen

Es sind elf Aktivitäten verfügbar, fünf Standard- und sechs Massenaktivitäten. Massenaktivitäten sollten nur verwendet werden, wenn eine Transformation zum Ändern von Daten vor dem Erreichen des Ziels nicht erforderlich ist.

  • Abfrage: Fragt Daten von Salesforce ab und ist als Quelle zur Bereitstellung von Daten in einem Vorgang vorgesehen.

  • Einfügen: Fügt neue Daten in Salesforce ein und ist als Ziel zur Verarbeitung von Daten in einem Vorgang vorgesehen.

  • Aktualisieren: Aktualisiert vorhandene Daten in Salesforce und ist als Ziel zur Verarbeitung von Daten in einem Vorgang vorgesehen.

  • Upsert: Aktualisiert vorhandene Daten und fügt neue Daten in Salesforce ein und ist als Ziel zur Verarbeitung von Daten in einem Vorgang vorgesehen.

  • Löschen: Löscht Daten in Salesforce und ist als Ziel zur Verarbeitung von Daten in einem Vorgang vorgesehen.

  • Massenabfrage: Fragt eine große Anzahl von Datensätzen von Salesforce ab und ist als Quelle zur Bereitstellung von Daten in einem Vorgang vorgesehen.

  • Masseneinfügung: Fügt eine große Anzahl neuer Datensätze in Salesforce ein und ist als Ziel zur Verarbeitung von Daten in einem Vorgang vorgesehen.

  • Massenaktualisierung: Aktualisiert eine große Anzahl vorhandener Datensätze in Salesforce und ist als Ziel zur Verarbeitung 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 zur Verarbeitung von Daten in einem Vorgang vorgesehen.

  • Massenlöschung: Löscht eine große Anzahl von Datensätzen aus Salesforce und ist als Ziel zur Verarbeitung 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 für die Verwendung als Ziel zum Verarbeiten von Daten in einem Workflow bestimmt. Endgültig gelöschte Datensätze werden automatisch zur Löschung freigegeben.

Dieser Connector ist ein nativer Connector: Seine Updates werden zusammen mit der Studio-Anwendung oder dem Agent und nicht separat veröffentlicht. Siehe Studio Connector-Updates.

Endpunkte, die mit diesem Connector erstellt werden, sind in der Endpoint-Nutzungsberichterstattung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Der Salesforce Connector unterstützt die Verwendung von Harmony Cloud- oder Private Agents der 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, stellen Sie sicher, dass das Permission Set, das der Salesforce-System-Integrations-Anmeldung zugewiesen ist, nicht über die Auswahl Multi-Factor Authentication for API Logins verfügt. Anmeldetypen für die Systemintegration sind von der MFA-Anforderung von Salesforce ausgenommen, wie in Is MFA required for my integration users? in der Salesforce-Dokumentation Salesforce Multi-Factor Authentication FAQ beschrieben.

Beim Konfigurieren einer Salesforce-Verbindung mit 2-legged OAuth 2.0-Authentifizierung finden Sie unter 2-legged OAuth 2.0-Voraussetzungen weitere Informationen.

Hinweis

Für die Verwendung von 2-legged OAuth 2.0 mit dem Salesforce Connector ist Agent-Version 11.59 / 12.3 oder höher erforderlich.

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 (Standard- oder keine Authentifizierung)
11.47 bis 11.59 (Standard- oder keine Authentifizierung)		 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

API-Version eines privaten Agenten bestätigen

Überprüfen Sie für einen privaten Agenten das Protokoll tomcat/logs/catalina.out nach einer Connector-Anfrage (z. B. nach dem Klicken auf Test bei der Verbindung). Das Protokoll erfasst die Anfrage-URL, z. B. Service request URL: https://login.salesforce.com/services/Soap/u/64.0, wobei die Zahl nach /u/ die aufgerufene Salesforce-API-Version ist.

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 Sitzungs-ID gefüllt wird, die bei der Authentifizierung der Verbindung erhalten wird.

Agent-Upgrades, die Salesforce SOAP API-Versionen überspringen, enthalten implizit Unterstützung für dazwischenliegende API-Versionen.

Weitere Informationen zu den Schemafeldern finden Sie in der Dokumentation über die obigen Links.

Fehlerbehebung und Anleitungen

Weitere Informationen finden Sie unter Salesforce Connector-Fehlerbehebung. Im Connector-Leitfaden zur Fehlerbehebung werden auch Salesforce Events-Probleme behandelt: Events können nach einem Agent-Neustart nicht aktiviert werden und Einschränkungen bei Listening-Aktivitäten. Darüber hinaus bieten die folgenden Leitseiten 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: