Empfangen von Ereignissen Salesforce aus Amazon EventBridge - Amazon EventBridge
Empfangen von Ereignissen von Salesforce mithilfe von Event Bus RelayEmpfangen von Ereignissen Salesforce über 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 Salesforce aus Amazon EventBridge

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

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

  • Indem Sie einen Flow in Amazon konfigurieren AppFlow, der Salesforce als Datenquelle verwendet wird. Amazon sendet AppFlow dann Salesforce Ereignisse EventBridge mithilfe eines Partner-Event-Busses an.

Sie können Veranstaltungsinformationen an folgende Salesforce API Ziele 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 unterTutorial: Ereignisse Salesforce von Amazon an senden EventBridge.

Empfangen von Ereignissen von Salesforce mithilfe von Event Bus Relay

Schritt 1: Richten Sie Salesforce Event Bus Relay und eine EventBridge Partner-Eventquelle ein

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

So konfigurieren Sie Salesforce Event Bus Relay

  1. Richten Sie ein REST API Tool ein

  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 Sie die Salesforce Partner-Eventquelle in der EventBridge Konsole und starten Sie das Event Relay

  1. Öffnen Sie in der EventBridge Konsole die Seite Partner-Eventquellen.

  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 Salesforce über Amazon AppFlow

Amazon AppFlow kapselt Ereignisse aus einem Salesforce EventBridge Ereignisumschlag. Das folgende Beispiel zeigt ein Salesforce Ereignis, das von einem EventBridge Partner-Event-Bus empfangen wurde.

{
    "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: Amazon AppFlow für die Verwendung Salesforce als Partner-Eventquelle konfigurieren

Um Ereignisse an 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 AppFlowAmazon-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 für ein 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 aus, um Ereignisnutzlastdateien zu speichern, die größer als 256 KB 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.

  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.

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

  19. Wählen Sie Weiter.

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

Wenn der Ablauf konfiguriert ist, AppFlow erstellt Amazon eine neue Partner-Eventquelle, die Sie dann einem Partner-Event-Bus in Ihrem Konto zuordnen müssen.

Schritt 2: Für EventBridge den Empfang von Salesforce Ereignissen konfigurieren

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

Um den Empfang EventBridge von Salesforce Ereignissen zu konfigurieren

  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 von Ihnen erstellten Flow und wählen Sie Flow aktivieren.

  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 für Event-Matching-Muster die Option Vordefiniertes Muster nach Service 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 Ausgewählte Ziele den AWS Service aus, der ausgeführt werden soll, wenn die Regel ausgeführt wird. Eine Regel kann bis zu fünf Ziele haben.

  16. Wählen Sie Create (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 Veranstaltungen, die größer als 256 KB sind, sendet Amazon AppFlow nicht die gesamte Veranstaltung an EventBridge. Stattdessen AppFlow fügt Amazon das Ereignis in einen S3-Bucket in Ihrem Konto ein und sendet dann ein Ereignis EventBridge mit einem Zeiger auf den Amazon S3 S3-Bucket an. Sie können den Zeiger verwenden, um das vollständige Ereignis aus dem Bucket abzurufen.