Zum Inhalt springen

Salesforce Events-Verbindung in Jitterbit Studio

Einführung

Eine Salesforce Events-Verbindung, die mit dem Salesforce Events-Connector erstellt wird, ermöglicht den Zugriff auf Salesforce Platform Events und Salesforce Change Data Capture Events in einer Salesforce-Instanz. Nach dem Konfigurieren einer Verbindung können Sie Instanzen von Salesforce Events-Aktivitäten erstellen, die dieser Verbindung zugeordnet sind. Diese können entweder als Quellen (zum Bereitstellen von Daten in einem Vorgang) oder als Ziele (zum Verarbeiten von Daten in einem Vorgang) verwendet werden.

Hinweis

Dieser Connector unterstützt die Organisationsrichtlinie Re-Authentifizierung bei Änderung aktivieren. Wenn diese aktiviert ist, erfordert eine Änderung von Host, Benutzername oder Consumer Key in dieser Verbindung, dass Benutzer das Passwort, das Sicherheits-Token, das Consumer Secret oder den Private Key (je nach ausgewählter Authentifizierung) erneut eingeben.

Salesforce Events-Verbindung erstellen oder bearbeiten

Eine neue Salesforce Events-Verbindung wird mit dem Salesforce Events-Connector an einem dieser Orte erstellt:

Eine vorhandene Salesforce Events-Verbindung kann an diesen Orten bearbeitet werden:

Salesforce Events-Verbindung konfigurieren

Im Folgenden wird jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Salesforce Events-Verbindung beschrieben.

Tipp

Felder mit dem -Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder klicken Sie auf das -Variablensymbol, um ein Menü mit vorhandenen Variablen zur Auswahl anzuzeigen.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Salesforce Events-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Salesforce Events-Endpunkt zu identifizieren, der sich auf eine bestimmte Verbindung und deren Aktivitäten bezieht.

  • Host: Geben Sie die Anmelde-URL der Salesforce Sandbox- oder Produktionsorganisation ein.

  • Authentifizierung: Wählen Sie die Authentifizierungsmethode aus, die für die Verbindung mit Salesforce verwendet werden soll.

    • Benutzername-Passwort: (Standard.) Wählen Sie diese Option, um sich mit einem Salesforce-Benutzernamen und -Passwort zu authentifizieren:

      • Benutzername: Geben Sie den Benutzernamen ein, der dem Salesforce-Konto zugeordnet ist.

      • Passwort: Geben Sie das Passwort ein, das dem Salesforce-Konto zugeordnet ist.

      • Sicherheits-Token: Geben Sie das Sicherheits-Token ein, das dem Salesforce-Konto zugeordnet ist.

  • Consumer Key: Geben Sie den Consumer Key aus der verbundenen Salesforce-App ein (siehe Voraussetzungen).

    -   **Consumer Secret:** Geben Sie das Consumer Secret aus der verbundenen Salesforce-App ein (siehe [Voraussetzungen](/de/integration-studio/design/connectors/salesforce-events/prerequisites/#key-secret)).

-   **Grant Type:** Geben Sie einen Grant Type von `password` ein.

    • Client Credentials: Wählen Sie diese Option, um sich mithilfe des Consumer Key und Secret aus einer externen Salesforce-Client-App oder einer verbundenen App zu authentifizieren (Authentifizierung von Maschine zu Maschine). Salesforce erfordert den OAuth 2.0-Client-Credentials-Flow, um die My Domain-URL Ihrer Organisation statt des generischen Login-Servers zu verwenden. Legen Sie deshalb Host oben auf eine URL wie https://exampleDomain.my.salesforce.com statt auf den Standardwert fest:

      • Consumer Key: Geben Sie den Consumer Key aus einer externen Salesforce-Client-App oder einer verbundenen App ein, die für den OAuth 2.0-Client-Credentials-Flow konfiguriert ist. Anweisungen zum Konfigurieren der App und zum Abrufen dieses Werts finden Sie unter Voraussetzungen für 2-legged OAuth 2.0 bei Salesforce-basierten Connectors.

      • Consumer Secret: Geben Sie das Consumer Secret aus der gleichen externen Salesforce-Client-App oder verbundenen App ein.

    • JWT Bearer: Wählen Sie diese Option, um sich mithilfe einer selbstsignierten JWT-Assertion zu authentifizieren, die mit einem privaten Schlüssel signiert ist (Authentifizierung von Server zu Server ohne erforderliches Passwort):

      • Username: Geben Sie den Benutzernamen des zugehörigen Salesforce-Kontos ein.

      • Consumer Key: Geben Sie den Consumer Key aus einer verbundenen Salesforce-App ein, die für den OAuth 2.0 JWT Bearer Flow konfiguriert ist. Weitere Informationen finden Sie in der Salesforce-Dokumentation zu OAuth 2.0 JWT Bearer Flow for Server-to-Server Integration.

      • Private Key: Geben Sie den privaten Schlüssel ein, der dem digitalen Zertifikat entspricht, das in die verbundene Salesforce-App hochgeladen wurde, in diesem Format:

        -----BEGIN PRIVATE KEY-----

<private key>

-----END PRIVATE KEY-----

        Ersetzen Sie <private key> (einschließlich der Spitzklammern < >) durch den entsprechenden Wert. Ein privater PKCS1-Schlüssel im Format -----BEGIN RSA PRIVATE KEY----- wird ebenfalls unterstützt.

  • API-Version: Geben Sie die Salesforce REST API-Version im numerischen Format ein (54, 56 usw.). Standardmäßig ist dieses Feld mit Version 63 vorausgefüllt.

  • Test: Klicken Sie, um die Verbindung mithilfe der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, lädt der Agent bzw. die Agents in der Agent-Gruppe, die der aktuellen Umgebung zugeordnet ist, die neueste Version des Connectors herunter. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Disable Auto Connector Update.

  • Änderungen speichern: Klicken Sie, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Klicken Sie nach Änderungen an einer neuen oder vorhandenen Konfiguration, um die Konfiguration zu schließen, ohne sie zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Abhängigkeiten, Löschung und Entfernung von Komponenten). Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Salesforce-Events-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Betrieb bereitgestellt zu werden) oder als Ziele (um Daten in einem Betrieb zu verarbeitet zu werden) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Designkomponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Subscribe Event: Empfängt ein Platformereignis 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 Platformereignis 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.