View a markdown version of this page

Empfangen von Ereignissen von Salesforce bei Amazon EventBridge - Amazon EventBridge
Empfangen von Ereignissen von Salesforce mithilfe von Event Bus RelayEmpfangen von Ereignissen aus der Salesforce Nutzung von Amazon AppFlow

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Empfangen von Ereignissen von Salesforce bei Amazon EventBridge

Sie können Amazon verwenden EventBridge , um Ereignisse von auf folgende Salesforce Weise zu empfangen:

  • Indem Sie die Salesforce's Event Bus Relay-Funktion verwenden, um Ereignisse direkt auf einem EventBridge Partner-Event-Bus zu empfangen.

  • Durch die Konfiguration eines Flows in Amazon AppFlow, der Salesforce als Datenquelle verwendet wird. Amazon sendet AppFlow dann EventBridge mithilfe eines Partner-Event-Busses Salesforce Ereignisse an.

Sie können mithilfe von API-Zielen Ereignisinformationen an Salesforce senden. Sobald das Ereignis an Salesforce gesendet wurde, kann es von Flows oder Apex-Auslösern verarbeitet werden. Weitere Informationen zum Einrichten eines Salesforce-API-Ziels finden Sie unter Tutorial: Ereignisse Salesforce von Amazon an senden EventBridge.

Empfangen von Ereignissen von Salesforce mithilfe von Event Bus Relay

Schritt 1: Einrichten von Salesforce Event Bus Relay und eine EventBridge Partnerereignisquelle

Wenn Sie eine Event-Relay-Konfiguration auf erstellenSalesforce, Salesforce wird eine Partnerereignisquelle mit dem Status „Ausstehend“ erstellt. EventBridge

Um zu konfigurieren Salesforce Event-Bus-Relay

  1. Einrichten eines REST-API-Tools

  2. (Optional) Definieren eines Plattformereignisses

  3. Erstellen eines Kanals für ein benutzerdefiniertes Plattformereignis

  4. Erstellen eines Kanalmitglieds zum Zuordnen des benutzerdefinierten Plattformereignisses

  5. Erstellen einer benannten Anmeldeinformation

  6. Erstellen einer Ereignis-Relay-Konfiguration

Schritt 2: Aktivieren Salesforce Partnerereignisquelle in der EventBridge Konsole und starten Sie das Event Relay

  1. Öffnen Sie in der EventBridge Konsole die Seite Partnerereignisquellen.

  2. Wählen Sie die Salesforce-Partnerereignisquelle aus, die Sie in Schritt 1 erstellt haben.

  3. Wählen Sie Mit Event Bus verknüpfen aus.

  4. Überprüfen Sie den Namen des Partner-Event-Bus.

  5. Wählen Sie Associate aus.

  6. Starten das Ereignis-Relays

Nachdem Sie das Event Bus Relay eingerichtet und gestartet und die Partnerereignisquelle konfiguriert haben, können Sie eine EventBridge Regel erstellen, die auf Ereignisse reagiert, um die Daten zu filtern und an ein Ziel zu senden.

Empfangen von Ereignissen von Salesforce mithilfe von Amazon AppFlow

Amazon AppFlow fasst Ereignisse Salesforce in einem EventBridge Veranstaltungsumschlag zusammen. Das folgende Beispiel zeigt ein Salesforce Ereignis, das von einem EventBridge Partner-Event-Bus empfangen wird.

{
    "version": "0",
    "id": "5c42b99e-e005-43b3-c744-07990c50d2cc",
    "detail-type": "AccountChangeEvent",
    "source": "aws.partner/appflow.test/salesforce.com/364228160620/CustomSF-Source-Final",
    "account": "000000000",
    "time": "2020-08-20T18:25:51Z",
    "region": "us-west-2",
    "resources": [],
    "detail": {
        "ChangeEventHeader": {
            "commitNumber": 248197218874,
            "commitUser": "0056g000003XW7AAAW",
            "sequenceNumber": 1,
            "entityName": "Account",
            "changeType": "UPDATE",
            "changedFields": [
                "LastModifiedDate",
                "Region__c"
            ],
            "changeOrigin": "com/salesforce/api/soap/49.0;client=SfdcInternalAPI/",
            "transactionKey": "000035af-b239-0581-9f14-461e4187de11",
            "commitTimestamp": 1597947935000,
            "recordIds": [
                "0016g00000MLhLeAAL"
            ]
        },
        "LastModifiedDate": "2020-08-20T18:25:35.000Z",
        "Region__c": "America"
    }
}

Schritt 1: Konfigurieren Sie Amazon AppFlow für die Verwendung Salesforce als Quelle für Partnerereignisse

Um Ereignisse an diese zu senden EventBridge, müssen Sie zunächst Amazon so konfigurieren AppFlow , dass es Salesforce als Partnerereignisquelle verwendet wird.

  1. Wählen Sie in der AppFlow Amazon-Konsole Create flow aus.

  2. Geben Sie im Abschnitt Flow-Details unter Flow-Name einen Namen für Ihren Flow ein.

  3. (Optional) Geben Sie eine Beschreibung für den Flow ein und wählen Sie dann Weiter aus.

  4. Wählen Sie unter Quelldetails die Option Salesforce im Dropdown-Menü Quellname und dann Verbinden aus, um eine neue Verbindung zu erstellen.

  5. Wählen Sie im Dialogfeld Mit Salesforce verbinden entweder Produktion oder Sandbox für die Salesforce-Umgebung aus.

  6. Geben Sie im Feld Verbindungsname einen eindeutigen Namen für die Verbindung ein und klicken Sie dann auf Weiter.

  7. Führen Sie im Dialogfeld Salesforce folgende Schritte aus:

    1. Geben Sie Ihre Salesforce-Anmeldeinformationen ein, mit denen Sie sich bei Salesforce anmelden möchten.

    2. Wählen Sie Salesforce Ereignisse für die Datentypen aus, die Amazon verarbeiten AppFlow soll.

  8. Wählen Sie im Drop-down-Menü Salesforce Ereignis auswählen den Ereignistyp aus, an den gesendet EventBridge werden soll.

  9. Wählen Sie Amazon als Ziel aus EventBridge.

  10. Wählen Sie Neue Partnerereignisquelle erstellen aus.

  11. (Optional) Geben Sie ein eindeutiges Suffix für die Partnerereignisquelle an.

  12. Wählen Sie Partnerereignisquelle generieren aus.

  13. Wählen Sie einen Amazon S3-Bucket, um Event-Payload-Dateien zu speichern, die größer als 1 MB sind.

  14. Stellen Sie sicher, dass im Abschnitt Flow-Auslöser die Option Flow bei Ereignis ausführen ausgewählt ist. Diese Einstellung stellt sicher, dass der Flow ausgeführt wird, wenn ein neues Salesforce-Ereignis eintritt.

  15. Wählen Sie Weiter aus.

  16. Wählen Sie für die Feldzuordnung die Option Alle Felder direkt zuordnen aus. Alternativ können Sie die Felder, die für Sie von Interesse sind, aus der Liste Quellfeldname auswählen.

    Weitere Informationen zur Feldzuordnung finden Sie unter Zuordnen von Datenfeldern.

  17. Wählen Sie Weiter aus.

  18. (Optional) Konfigurieren Sie Filter für Datenfelder in Amazon AppFlow.

  19. Wählen Sie Weiter aus.

  20. Überprüfen Sie die Einstellungen und wählen Sie dann Flow erstellen aus.

Wenn der Ablauf konfiguriert ist, AppFlow erstellt Amazon eine neue Partnerereignisquelle, die Sie dann mit einem Partnerereignisbus in Ihrem Konto verknüpfen müssen.

Schritt 2: Für EventBridge den Empfang konfigurieren Salesforce Veranstaltungen

Stellen Sie sicher, dass der AppFlow Amazon-Flow, der durch Salesforce Ereignisse ausgelöst wird, die EventBridge als Ziel dienen, konfiguriert ist, bevor Sie den Anweisungen in diesem Abschnitt folgen.

So konfigurieren Sie EventBridge den Empfang Salesforce Veranstaltungen

  1. Öffnen Sie in der EventBridge Konsole die Seite Partnerereignisquellen.

  2. Wählen Sie die Salesforce-Partnerereignisquelle aus, die Sie in Schritt 1 erstellt haben.

  3. Wählen Sie Mit Event Bus verknüpfen aus.

  4. Überprüfen Sie den Namen des Partner-Event-Bus.

  5. Wählen Sie Associate aus.

  6. Öffnen Sie in der AppFlow Amazon-Konsole den Flow, den Sie erstellt haben, und wählen Sie Flow aktivieren aus.

  7. Öffnen Sie die Seite Regeln in der EventBridge Konsole.

  8. Wählen Sie Regel erstellen aus.

  9. Geben Sie einen eindeutigen Namen für die Regel ein.

  10. Wählen Sie die Option Ereignismuster im Abschnitt Muster definieren aus.

  11. Wählen Sie unter Muster für den Ereignisabgleich die Option Pre-defined Muster nach Dienst aus.

  12. Wählen Sie im Bereich Serviceanbieter die Option Alle Ereignisse aus.

  13. Wählen Sie für Event Bus auswählen die Option Benutzerdefinierter oder Partner-Event-Bus aus.

  14. Wählen Sie den Event-Bus aus, den Sie mit der Eventquelle des AppFlow Amazon-Partners verknüpft haben.

  15. Wählen Sie für Ziele auswählen den AWS Service aus, der bei Ausführung der Regel aktiv werden soll. Eine Regel kann bis zu fünf Ziele haben.

  16. Wählen Sie Erstellen aus.

Der Zielservice empfängt alle für Ihr Konto konfigurierten Salesforce-Ereignisse. Wenn Sie die Ereignisse filtern oder einige Ereignisse an verschiedene Ziele senden möchten, können Sie eine inhaltsbasierte Filterung mit Ereignismustern verwenden.

Anmerkung

Bei Ereignissen, die größer als 1 MB sind, sendet Amazon AppFlow nicht die gesamte Veranstaltung an EventBridge. Stattdessen AppFlow platziert Amazon das Ereignis in einem S3-Bucket in Ihrem Konto und sendet dann ein Ereignis EventBridge mit einem Zeiger auf den Amazon S3-Bucket an. Sie können den Zeiger verwenden, um das vollständige Ereignis aus dem Bucket abzurufen.