Salesforce Events-Connector in Jitterbit Studio

Zusammenfassung

Der Salesforce Events-Connector stellt Zugriff auf Salesforce Platform Events und Salesforce Change Data Capture (CDC) Events in einer Salesforce-Instanz bereit.

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

Der Salesforce Events-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 Events-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 Events-Verbindung und ihre Aktivitäten als Salesforce Events-Endpunkt bezeichnet:

Salesforce Events-Aktivitätstypen

Subscribe Event: Empfängt ein Plattformereignis oder ein CDC-Ereignis von Salesforce und soll als Quelle in einem Vorgang verwendet werden.
Subscribe Insert CDC Event: Empfängt ein Insert-CDC-Ereignis von Salesforce und soll als Quelle in einem Vorgang verwendet werden.
Publish Event: Veröffentlicht ein Plattformereignis in Salesforce und soll als Ziel in einem Vorgang verwendet werden.
Subscribe Update CDC Event: Empfängt ein Update-CDC-Ereignis von Salesforce und soll als Quelle in einem Vorgang verwendet werden.
Subscribe Delete CDC Event: Empfängt ein Delete-CDC-Ereignis von Salesforce und soll als Quelle in einem Vorgang verwendet werden.

Die Lizenzklasse dieses Connectors ist Enterprise, verfügbar als Add-on für Ihr Harmony iPaaS-Abonnement. Um diese zu aktivieren, kontaktieren Sie Ihren Customer Success Manager. Mit diesem Connector erstellte Endpunkte sind in der Endpunkt-Nutzungsberichterstellung enthalten und werden auf Ihre Lizenz angerechnet.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update aussetzen.

Die Voraussetzungen für die Verwendung des Salesforce Events-Connectors werden in Salesforce Events-Voraussetzungen beschrieben.

Der Salesforce Events-Connector verwendet die Version der Salesforce REST API, die in der Verbindung angegeben ist. Die Standardversion ist 63.0. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

Fehlerbehebung

Wenn Probleme mit dem Salesforce Events-Connector auftreten, werden diese Schritte zur Fehlerbehebung empfohlen:

Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Disable Auto Connector Update verwendet wird).
Überprüfen Sie die Operationsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.
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.
Bei Verwendung von privaten Agenten können Sie das ausführliche Connector-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag zur logback.xml-Datei Ihres privaten Agenten hinzufügen:
```
<logger name="org.jitterbit.connector.platformevents" level="DEBUG"/>
```
Weitere Informationen zum ausführlichen Connector-Logging finden Sie unter Ausführliches Logging für Connectors mit privaten Jitterbit-Agenten.
Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle für weitere Informationen überprüfen.
Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung bei Operationen.

Häufige Probleme mit Listening-Aktivitäten (Subscribe event, Subscribe insert cdc event, Subscribe update cdc event oder Subscribe delete cdc event) werden nachfolgend beschrieben.

Problem	Ursache	Workaround
Ereignisse können nicht aktiviert oder deaktiviert werden.	Der private Agent wurde kürzlich installiert oder neu gestartet.	Öffnen Sie die Verbindungskonfiguration und testen Sie die Verbindung, um den Connector auf den Agenten herunterzuladen.
Ereignisse können nicht aktiviert werden.	Die Salesforce-Verbindungsanmeldedaten sind möglicherweise gesperrt oder falsch. In diesem Fall werden die folgenden Fehlerdetails zurückgegeben: `Unable to login; INVALID_LOGIN: Invalid username, password, security token; or user locked out.`	Bestätigen Sie, dass die Verbindungskonfiguration korrekt ist.
Ereignisse können nicht aktiviert werden.	Die maximale Anzahl von Clients (Abonnenten), die die Salesforce-Instanz zulässt, wurde erreicht.	Keine.
Maßeinheiten werden nicht in der Antwort zurückgegeben.	Messsymbole wie `$` und `%` werden aufgrund des Designs der Salesforce-API nicht zurückgegeben.	Keine.
Null-Werte werden in der Antwort zurückgegeben.	Bei CDC-Aktivitäten werden unveränderte Felder aufgrund des Designs der Salesforce-API als null in der Antwort zurückgegeben.	Keine.