Ricezione di eventi da Salesforce Amazon EventBridge - Amazon EventBridge
Ricezione di eventi da Salesforce mediante Event Bus RelayRicezione di eventi Salesforce tramite Amazon AppFlow

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Ricezione di eventi da Salesforce Amazon EventBridge

Puoi usare Amazon EventBridge per ricevere eventi Salesforce nei seguenti modi:

  • Utilizzando la funzione Salesforce's Event Bus Relay per ricevere eventi direttamente su un event bus EventBridge partner.

  • Configurando un flusso in Amazon AppFlow che viene utilizzato Salesforce come fonte di dati. Amazon invia AppFlow quindi Salesforce gli eventi EventBridge utilizzando un bus di eventi partner.

Puoi inviare informazioni sugli eventi a API destinazioni Salesforce che utilizzano. Una volta inviato a Salesforce, l'evento può essere elaborato da flussi o trigger Apex. Per ulteriori informazioni sulla configurazione di una Salesforce API destinazione, vedereTutorial: invia eventi a Salesforce da Amazon EventBridge.

Ricezione di eventi da Salesforce mediante Event Bus Relay

Fase 1: Configurare Salesforce Event Bus Relay e una fonte di eventi EventBridge partner

Quando crei una configurazione Event Relay suSalesforce, Salesforce crea una fonte di eventi partner nello stato EventBridge in sospeso.

Per configurare Event Bus Relay di Salesforce

  1. Configura uno strumento REST API

  2. (Facoltativo) Definisci un evento della piattaforma

  3. Crea un canale per un evento della piattaforma personalizzato

  4. Crea un membro del canale per associare l'evento della piattaforma personalizzato

  5. Crea credenziali con nome

  6. Crea una configurazione di inoltro di eventi

Fase 2: Attiva Salesforce il codice sorgente dell'evento per i partner nella EventBridge console e avvia il relay dell'evento

  1. Apri la pagina delle fonti degli eventi per i partner nella EventBridge console.

  2. Seleziona l'origine di eventi partner Salesforce creata in Passaggio 1.

  3. Scegli Associa con bus di eventi.

  4. Convalida il nome del router di eventi partner.

  5. Selezionare Associate (Associa).

  6. Avvia l'inoltro degli eventi

Ora che hai impostato e avviato Event Bus Relay e configurato l'origine degli eventi partner, puoi creare una EventBridge regola che reagisce agli eventi per filtrare e inviare i dati a una destinazione.

Ricezione di eventi Salesforce tramite Amazon AppFlow

Amazon AppFlow incapsula gli eventi Salesforce in una busta di EventBridge eventi. L'esempio seguente mostra un Salesforce evento ricevuto da un bus di eventi EventBridge partner.

{
    "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"
    }
}

Fase 1: configura Amazon AppFlow per utilizzarlo Salesforce come fonte di eventi per i partner

Per inviare eventi a EventBridge, devi prima configurare Amazon AppFlow per utilizzarlo Salesforce come fonte di eventi partner.

  1. Nella AppFlowconsole Amazon, scegli Create flow.

  2. Nella sezione Dettagli flusso, in Nome flusso immetti un nome per il flusso.

  3. (Facoltativo) Immetti un nome e una descrizione per il flusso, quindi scegli Successivo.

  4. In Dettagli origine, scegli Salesforce dal menu a discesa Nome origine, quindi scegli Connetti per creare una nuova connessione.

  5. Nella finestra di dialogo Connetti a Salesforce, scegli Produzione o Sandbox per l'ambiente Salesforce.

  6. Nel campo Nome connessione, immetti un nome univoco per la connessione, quindi scegli Continua.

  7. Nella finestra di dialogo Salesforce, procedi come segue:

    1. Immetti le credenziali di accesso Salesforce per accedere a Salesforce.

    2. Seleziona Salesforce gli eventi per i tipi di dati AppFlow da elaborare da Amazon.

  8. Nel menu a discesa Scegli Salesforce evento, seleziona il tipo di evento a cui inviare. EventBridge

  9. Per una destinazione, seleziona Amazon EventBridge.

  10. Seleziona Crea una nuova origine di eventi partner.

  11. (Facoltativo) Specifica un suffisso univoco per l'origine di eventi partner.

  12. Scegli Genera origine di eventi partner.

  13. Scegli un bucket Amazon S3 per archiviare file di payload di eventi di dimensioni superiori a 256 KB.

  14. Nella sezione Trigger flusso, assicurati che sia selezionata l'opzione Esegui flusso con nuovo evento. Questa impostazione assicura che il flusso venga eseguito quando si verifica un nuovo evento Salesforce.

  15. Scegli Next (Successivo).

  16. Per la mappatura dei campi, seleziona Mappa direttamente tutti i campi. In alternativa, puoi selezionare i campi che ti interessano dall'elenco Nomi campi di origine.

    Per ulteriori informazioni sulla mappatura dei campi, consulta Mappatura di campi di dati.

  17. Scegli Next (Successivo).

  18. (Facoltativo) Configura i filtri per i campi di dati in Amazon AppFlow.

  19. Scegli Next (Successivo).

  20. Esamina le impostazioni e quindi scegli Crea flusso.

Con il flusso configurato, Amazon AppFlow crea una nuova fonte di eventi per i partner che devi quindi associare a un partner event bus nel tuo account.

Fase 2: Configurazione EventBridge per ricevere Salesforce eventi

Assicurati che il AppFlow flusso Amazon attivato dagli Salesforce eventi con EventBridge come destinazione sia configurato prima di seguire le istruzioni in questa sezione.

Per configurare la ricezione EventBridge di eventi Salesforce

  1. Apri la pagina delle fonti degli eventi per i partner nella EventBridge console.

  2. Seleziona l'origine di eventi partner Salesforce creata in Passaggio 1.

  3. Scegli Associa con bus di eventi.

  4. Convalida il nome del router di eventi partner.

  5. Selezionare Associate (Associa).

  6. Nella AppFlow console Amazon, apri il flusso che hai creato e scegli Attiva flusso.

  7. Apri la pagina Regole nella EventBridge console.

  8. Scegli Crea regola.

  9. Immetti un nome univoco per il ruolo.

  10. Nella sezione Definisci il modello, scegli Modello di eventi.

  11. In Modello di corrispondenza degli eventi, seleziona Modello predefinito dal servizio.

  12. Nella sezione Fornitore di servizi, seleziona Tutti gli eventi.

  13. In Seleziona bus di eventi, scegli Bus di eventi personalizzato o dei partner.

  14. Seleziona il bus di eventi che hai associato all'origine dell'evento AppFlow partner Amazon.

  15. Per Select targets, scegli il AWS servizio che deve agire quando viene eseguita la regola. Una regola può avere fino a cinque destinazioni.

  16. Scegli Create (Crea) .

Il servizio di destinazione riceve tutti gli eventi Salesforce configurati per il tuo account. Per filtrare gli eventi o inviare alcuni eventi a destinazioni diverse, puoi utilizzare il filtro basato su contenuto con modelli di eventi.

Nota

Per eventi di dimensioni superiori a 256 KB, Amazon AppFlow non invia l'intero evento a EventBridge. Invece, Amazon AppFlow inserisce l'evento in un bucket S3 del tuo account, quindi invia un evento a EventBridge con un puntatore al bucket Amazon S3. Puoi utilizzare il puntatore per ottenere l'intero evento dal bucket.