View a markdown version of this page

Ricezione di eventi da Salesforce in Amazon EventBridge - Amazon EventBridge
Ricezione di eventi da Salesforce mediante Event Bus RelayRicezione di eventi dall'Salesforceutilizzo di 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 in Amazon EventBridge

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

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

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

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

Ricezione di eventi da Salesforce utilizzando Event Bus Relay

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

Quando si crea una configurazione di inoltro di eventi attivaSalesforce, Salesforce crea una fonte di eventi partner in stato EventBridge in sospeso.

Per configurare Salesforce Event Bus Relay

  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: Attivazione Salesforce collega la sorgente degli eventi nella EventBridge console e avvia l'evento relay

  1. Apri la pagina delle sorgenti degli eventi dei 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 la fonte degli eventi partner, puoi creare una EventBridge regola che reagisce agli eventi per filtrare e inviare i dati a un target.

Ricezione di eventi da Salesforce usando Amazon AppFlow

Amazon AppFlow incapsula gli eventi Salesforce in una busta contenente gli 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"
    }
}

Passaggio 1: configura Amazon AppFlow per l'utilizzo Salesforce come fonte di eventi per i partner

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

  1. Nella AppFlow console 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 i file di payload degli eventi di dimensioni superiori a 1 MB.

  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 Avanti.

  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 Avanti.

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

  19. Scegli Avanti.

  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 bus di eventi partner nel tuo account.

Fase 2: Configurazione EventBridge per ricevere Salesforce eventi

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

Per configurare EventBridge la ricezione Salesforce eventi

  1. Apri la pagina delle sorgenti degli eventi dei 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 delle 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. Per lo schema di abbinamento degli eventi, seleziona il Pre-defined modello per 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 alla fonte dell'evento del AppFlow partner Amazon.

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

  16. Scegli 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 1 MB, Amazon AppFlow non invia l'evento completo a EventBridge. Invece, Amazon AppFlow inserisce l'evento in un bucket S3 nel 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.