Zum Inhalt springen

Salesforce Service Cloud-Connector in Jitterbit Studio

Zusammenfassung

Der Salesforce Service Cloud-Connector stellt Zugriff auf Salesforce Service Cloud her.

Der Salesforce Service Cloud-Connector bietet eine Schnittstelle zum Erstellen einer Salesforce Service Cloud-Verbindung, die Grundlage für die Generierung von Instanzen von Salesforce Service Cloud-Aktivitäten. Diese Aktivitäten interagieren nach der Konfiguration mit Salesforce Service Cloud über die Verbindung.

Man greift auf den Salesforce Service Cloud-Connector über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Palette der Designkomponenten zu (siehe Design component palette).

Hinweis

Die Informationen in Salesforce connector troubleshooting und Salesforce connector how-tos können auch auf den ServiceMax-Connector zutreffen, da dieser auf der Codebasis des Salesforce-Connectors aufgebaut ist.

Tipp

Integration recipes sind für diesen Connector über Jitterbit Marketplace verfügbar.

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer Salesforce Service Cloud-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) dienen sollen.

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

Salesforce Service Cloud activity types

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.

  • Query: Fragt Daten aus Salesforce Service Cloud ab und ist als Quelle zum Bereitstellen von Daten in einem Vorgang vorgesehen.

  • Insert: Fügt neue Daten in Salesforce Service Cloud ein und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Update: Aktualisiert vorhandene Daten in Salesforce Service Cloud und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Upsert: Aktualisiert vorhandene Daten und fügt neue Daten in Salesforce Service Cloud ein und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Delete: Löscht Daten aus Salesforce Service Cloud und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Bulk Query: Fragt eine große Anzahl von Datensätzen aus Salesforce Service Cloud ab und ist als Quelle zum Bereitstellen von Daten in einem Vorgang vorgesehen.

  • Bulk Insert: Fügt eine große Anzahl neuer Datensätze in Salesforce Service Cloud ein und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Bulk Update: Aktualisiert eine große Anzahl vorhandener Datensätze in Salesforce Service Cloud und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Bulk Upsert: Aktualisiert eine große Anzahl vorhandener Datensätze und fügt eine große Anzahl neuer Datensätze in Salesforce Service Cloud ein. Die Aktivität ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

  • Bulk Delete: Löscht eine große Anzahl von Datensätzen aus Salesforce Service Cloud 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 endgültig aus Salesforce Service Cloud und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen. Endgültig gelöschte Datensätze werden automatisch zum Löschen freigegeben.

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

Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Der Salesforce Service Cloud Connector unterstützt die Verwendung von Harmony Cloud oder Private Agents in Version 9.4.2 oder höher.

Wenn eine Salesforce Service Cloud-Verbindung mit Standardauthentifizierung konfiguriert wird, 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 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.

Wenn eine Salesforce Service Cloud-Verbindung mit 2-legged OAuth 2.0-Authentifizierung konfiguriert wird, finden Sie weitere Informationen unter 2-legged OAuth 2.0-Voraussetzungen. Da der Salesforce Service Cloud Connector die gleiche Codebasis wie der Salesforce Connector nutzt, gelten die gleichen Voraussetzungen.

Hinweis

Agent-Version 11.59 (für 11.x-Agents) oder 12.4 oder höher (für 12.x-Agents) ist erforderlich, um 2-legged OAuth 2.0 mit dem Salesforce Service Cloud 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.4 oder höher (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 Sommer '25
11.41 bis 11.46 63.0 Frühling '25
11.35 bis 11.40 62.0 Winter '25
11.30 bis 11.34 61.0 Sommer '24
11.23 bis 11.29
10.85 bis 10.87		 60.0 Frühling '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 Sommer '23
11.7 bis 11.10
10.69 bis 10.72		 57.0 Frühling '23
11.0 bis 11.6
10.55 bis 10.68		 54.0 Frühling '22
10.44 bis 10.54 52.0 Sommer '21
10.42 bis 10.43 51.0 Herbst '21
10.28 bis 10.41 50.0 Winter '21
10.23 bis 10.27 49.0 Sommer '20
10.17 bis 10.22 48.0 Frühling '20
10.11 bis 10.16 47.0 Winter '20
10.3 bis 10.10 45.0 Frühling '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

Falls Probleme mit dem Salesforce Service Cloud-Connector auftreten, werden folgende Schritte zur Fehlerbehebung empfohlen:

  1. Stellen Sie sicher, dass die Salesforce Service Cloud-Verbindung erfolgreich ist, indem Sie die Schaltfläche Test im Konfigurationsbildschirm verwenden. Falls die Verbindung nicht erfolgreich ist, kann der zurückgegebene Fehler einen Hinweis auf das Problem geben.

  2. Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

  3. Aktivieren Sie das Debug-Logging für Operationen (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

  5. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen. Die Informationen zur Fehlerbehebung des Salesforce-Connectors können ebenfalls relevant sein.