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).

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) dienen 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.

Dieser Connector ist ein nativer Connector: Seine Updates werden zusammen mit der Studio-Anwendung oder dem Agent veröffentlicht, 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-Connector unterstützt die Verwendung von Harmony Cloud- oder Private Agents ab Version 9.4.2.

Wenn eine Salesforce-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, 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 Salesforce Multi-Factor Authentication FAQ unter Is MFA required for my integration users? beschrieben.

Wenn eine Salesforce-Verbindung mit 2-legged OAuth 2.0-Authentifizierung konfiguriert wird, siehe 2-legged OAuth 2.0-Voraussetzungen für weitere Informationen.

Die API-Version, die der Connector für Nicht-Bulk-Aktivitäten verwendet, hängt von der Jitterbit-Agent-Version ab:

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 der Überwachungsaktivität. Darüber hinaus bieten die folgenden Anleitungsseiten detaillierte Anweisungen zum Ausführen bestimmter Aufgaben mit Integrationsprojekten, die den Salesforce-Connector verwenden:

• Erstellen einer Salesforce External ID für Jitterbit

• Benutzer in Salesforce erstellen

• Bereitstellen eines Custom Fields-Pakets in Salesforce

• Manuelles Hinzufügen von Custom Fields in Salesforce

• Aktualisieren von Salesforce Picklist-Werten und Bezeichnungen

• Salesforce Functions verwenden

• Salesforce Jitterbit-Variablen verwenden

Zusätzliche Ressourcen

Die folgenden Jitterbit Microlearning-Tutorials sind über unsere Jitterbit Basics-Videoserie verfügbar:

• FTP zu Salesforce Insert

• FTP zu Salesforce Upsert

• Salesforce zu FTP als JSON