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 stellt eine Schnittstelle zur Erstellung einer Salesforce Events-Verbindung bereit, die als Grundlage für die Generierung von Instanzen von Salesforce Events-Aktivitäten dient. Diese Aktivitäten interagieren nach ihrer Konfiguration mit Salesforce Events über die Verbindung.

Auf den Salesforce Events-Connector kann über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectors) in der Design Component Palette zugegriffen werden (siehe Design component palette).

Connector-Übersicht

Dieser Connector wird zunächst zur Konfiguration einer Salesforce Events-Verbindung verwendet. Die dieser Verbindung zugeordneten Aktivitätstypen 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) fungieren 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 Platform Event oder ein CDC Event von Salesforce und soll als Quelle in einem Vorgang verwendet werden.
Subscribe Insert CDC Event: Empfängt ein Insert CDC Event von Salesforce und soll als Quelle in einem Vorgang verwendet werden.
Publish Event: Veröffentlicht ein Platform Event in Salesforce und soll als Ziel in einem Vorgang verwendet werden.
Subscribe Update CDC Event: Empfängt ein Update CDC Event von Salesforce und soll als Quelle in einem Vorgang verwendet werden.
Subscribe Delete CDC Event: Empfängt ein Delete CDC Event von Salesforce und soll als Quelle in einem Vorgang verwendet werden.

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

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud Agents und Private Agents verwendet werden.

Agents laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Auf Private Agents können diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update (Auto-Update für Connector deaktivieren) ausgesetzt werden.

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

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

Troubleshooting

Wenn Sie Probleme mit dem Salesforce Events-Connector haben, werden die folgenden Schritte zur Fehlerbehebung empfohlen:

Klicken Sie die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich hergestellt wird und um sicherzustellen, dass die neueste Version des Connectors auf den Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Disable Auto Connector Update (Auto-Update für Connector deaktivieren) verwendet wird).
Überprüfen Sie die Vorgangsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.
Aktivieren Sie das Debug-Protokollierung für Vorgänge (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 die ausführliche Protokollierung von Konnektoren für diesen Konnektor 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 zur ausführlichen Protokollierung von Konnektoren finden Sie unter Ausführliche Protokollierung für Konnektoren mit privaten Jitterbit-Agenten.
Bei Verwendung von privaten Agenten können Sie die Agent-Protokolle überprüfen, um weitere Informationen zu erhalten.
Weitere Überlegungen zur Fehlerbehebung finden Sie unter Fehlerbehebung für Vorgänge.

Häufige Probleme mit Abhör-Aktivitäten (Event abonnieren, CDC-Ereignis einfügen abonnieren, CDC-Ereignis aktualisieren abonnieren oder CDC-Ereignis löschen abonnieren) 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 Konnektor zum Agent herunerzuladen.
Ereignisse können nicht aktiviert werden.	Die Salesforce-Verbindungsanmeldedaten sind möglicherweise gesperrt oder fehlerhaft. In diesem Fall werden folgende Fehlerdetails zurückgegeben: `Unable to login; INVALID_LOGIN: Invalid username, password, security token; or user locked out.`	Überprüfen Sie, ob die Verbindungskonfiguration korrekt ist.
Ereignisse können nicht aktiviert werden.	Die maximale Anzahl von Clients (Abonnenten), die von der Salesforce-Instanz zulässig sind, wurde erreicht.	Keine.
Ereignisse können nicht aktiviert werden.	Das Objekt ist nicht für Change Data Capture in Salesforce ausgewählt. In diesem Fall werden folgende Fehlerdetails zurückgegeben: `Unable to subscribe to [/data/<ObjectName>ChangeEvent:-1] [...]: 400::The channel specified is not valid {/data/<ObjectName>ChangeEvent}`	Fügen Sie das Objekt in Salesforce unter Ausgewählte Entitäten hinzu, wie in Entitäten auswählen, die Ereignisse generieren beschrieben.
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 ungeänderte Felder aufgrund des Designs der Salesforce-API als null in der Antwort zurückgegeben.	Keine.