Salesforce Events Connector für Jitterbit Studio

Zusammenfassung

Der Salesforce Events Connector ermöglicht den Zugriff auf Salesforce Platform Events und Salesforce Change Data Capture (CDC) Events in einer Salesforce Instanz.

Der Salesforce Events Connector bietet eine Schnittstelle zur Erstellung einer Salesforce Events Verbindung, die als Grundlage für die Generierung von Instanzen von Salesforce Events Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit Salesforce Events.

Der Salesforce Events Connector wird über die Registerkarte Projektendpunkte und Connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Connector-Übersicht

Dieser Connector wird zunächst verwendet, um eine Salesforce Events Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) gedacht sind.

Zusammen werden eine spezifische 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 ist als Quelle in einem Vorgang gedacht.
Subscribe Insert CDC Event: Empfängt ein Insert CDC-Ereignis von Salesforce und ist als Quelle in einem Vorgang gedacht.
Publish Event: Veröffentlicht ein Plattformereignis in Salesforce und ist als Ziel in einem Vorgang gedacht.
Abonnieren Sie das Update CDC-Ereignis: Empfängt ein Update CDC-Ereignis von Salesforce und ist als Quelle in einem Vorgang vorgesehen.
Abonnieren Sie das Lösch-CDC-Ereignis: Empfängt ein Lösch-CDC-Ereignis von Salesforce und ist als Quelle in einem Vorgang vorgesehen.

Hinweis

Dieser Connector ist ein auf dem Connector SDK-basierten Connector, auf den Jitterbit verweisen kann, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Die Lizenzklasse dieses Connectors ist Enterprise, verfügbar als Zusatzoption zu Ihrem Harmony iPaaS-Abonnement. Um ihn zu aktivieren, kontaktieren Sie Ihren Customer Success Manager. Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Voraussetzungen und unterstützte API-Versionen

Die Voraussetzungen für die Verwendung des Salesforce Events-Connectors sind in den Voraussetzungen für Salesforce Events 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 den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.

Fehlersuche

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

Klicken Sie auf die Schaltfläche Test in der Verbindungs-Konfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Auto Connector Update deaktivieren).
Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung des Vorgangs geschrieben wurden.
Aktivieren Sie das Debug-Protokoll für Operationen (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.
Wenn Sie private Agenten verwenden, können Sie das ausführliche Protokollieren des Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:
```
<logger name="org.jitterbit.connector.platformevents" level="DEBUG"/>
```
Weitere Informationen zum ausführlichen Protokollieren von Connectors finden Sie unter Ausführliches Protokollieren für Connectoren, die Jitterbit private Agenten verwenden.
Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle für weitere Informationen überprüfen.
Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlerbehebung bei Operationen.

Häufige Probleme mit Listening-Aktivitäten (Ereignis abonnieren, Insert CDC-Ereignis abonnieren, Update CDC-Ereignis abonnieren oder Delete CDC-Ereignis abonnieren) sind unten 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 Verbindungs-Konfiguration und testen Sie die Verbindung, um den Connector zum Agenten herunterzuladen.
Ereignisse können nicht aktiviert werden.	Die Anmeldeinformationen für die Salesforce-Verbindung sind möglicherweise gesperrt oder falsch. In diesem Fall werden die folgenden Fehlermeldungen zurückgegeben: `Unable to login; INVALID_LOGIN: Ungültiger Benutzername, Passwort, Sicherheitstoken; oder Benutzer gesperrt.`	Bestätigen Sie, dass die Verbindungs-Konfiguration korrekt ist.
Ereignisse können nicht aktiviert werden.	Die maximale Anzahl von Clients (Abonnenten), die von der Salesforce-Instanz erlaubt ist, wurde erreicht.	Keine.
Maßeinheiten werden nicht in der Antwort zurückgegeben.	Maßeinheitensymbole wie `$` und `%` werden aufgrund des Designs der Salesforce-API nicht zurückgegeben.	Keine.
Nullwerte 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.