Recibir eventos desde Salesforce Amazon EventBridge - Amazon EventBridge
Recepción de eventos de Salesforce con Event Bus RelayRecibir eventos a partir del Salesforce uso de Amazon AppFlow

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Recibir eventos desde Salesforce Amazon EventBridge

Puedes usar Amazon EventBridge para recibir eventos de Salesforce las siguientes maneras:

  • Al utilizar la función Salesforce's Event Bus Relay para recibir eventos directamente en un autobús de eventos EventBridge asociado.

  • Configurando un flujo en Amazon AppFlow que se utiliza Salesforce como fuente de datos. AppFlow A continuación, Amazon envía Salesforce los eventos a EventBridge mediante un bus de eventos asociado.

Puedes enviar la información del evento a Salesforce varios API destinos. Una vez enviado el evento a Salesforce, este puede ser procesado por Flujos o desencadenadores de Apex. Para obtener más información sobre la configuración de un Salesforce API destino, consulteTutorial: Enviar eventos a Salesforce desde Amazon EventBridge.

Recepción de eventos de Salesforce con Event Bus Relay

Paso 1: Configure Salesforce Event Bus Relay y una fuente de eventos EventBridge asociada

Al crear una configuración de retransmisión de eventos activadaSalesforce, Salesforce crea una fuente de eventos asociada EventBridge en estado pendiente.

Para configurar Salesforce Event Bus Relay

  1. Configura una REST API herramienta

  2. (Opcional) Defina un evento de plataforma

  3. Cree un canal para un evento de plataforma personalizado

  4. Cree un miembro del canal para asociar el evento de plataforma personalizado

  5. Cree una credencial con nombre

  6. Cree una configuración de retransmisión de eventos

Paso 2: Active la fuente de eventos Salesforce asociada en la EventBridge consola e inicie la retransmisión del evento

  1. Abra la página de fuentes de eventos de los socios en la EventBridge consola.

  2. Seleccione el origen de evento de socios de Salesforce que creó en el Paso 1.

  3. Seleccione Asociar con bus de eventos.

  4. Valide el nombre del bus de eventos de socios.

  5. Seleccione Asociar.

  6. Inicie la retransmisión del evento

Ahora que ha configurado e iniciado el Event Bus Relay y ha configurado la fuente de eventos asociada, puede crear una EventBridge regla que reaccione a los eventos para filtrar y enviar los datos a un destino.

Recibir eventos a partir del Salesforce uso de Amazon AppFlow

Amazon AppFlow encapsula los eventos Salesforce en un sobre de EventBridge eventos. El siguiente ejemplo muestra un Salesforce evento recibido por un bus de eventos EventBridge asociado.

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

Paso 1: Configurar Amazon AppFlow para que Salesforce lo utilice como fuente de eventos asociada

Para enviar eventos a EventBridge, primero debes configurar Amazon AppFlow para que Salesforce lo utilice como fuente de eventos asociada.

  1. En la AppFlowconsola de Amazon, selecciona Create flow.

  2. En la sección Detalles del flujo, en Nombre del flujo, indique un nombre para el flujo.

  3. (Opcional) Indique una descripción para el flujo y, a continuación, seleccione Siguiente.

  4. En Detalles del origen, seleccione Salesforce del menú desplegable Nombre del origen y, a continuación, seleccione Conectar para crear una conexión nueva.

  5. En el cuadro de diálogo Conectar a Salesforce, seleccione Producción o Entorno aislado para el entorno de Salesforce.

  6. En el campo Nombre de la conexión, introduzca un nombre exclusivo para la conexión y, a continuación, seleccione Continuar.

  7. En el cuadro de diálogo de Salesforce, haga lo siguiente:

    1. Introduzca sus credenciales de inicio de sesión de Salesforce para iniciar sesión de Salesforce.

    2. Selecciona Salesforce eventos para los tipos de datos que Amazon va AppFlow a procesar.

  8. En el menú desplegable Elegir Salesforce evento, selecciona el tipo de evento al que deseas realizar el envío EventBridge.

  9. Para un destino, selecciona Amazon EventBridge.

  10. Seleccione Crear un origen de evento de socios nuevo.

  11. (Opcional) Especifique un sufijo único para el origen de evento de socios.

  12. Seleccione Generar origen de evento de socios.

  13. Seleccione un bucket de Amazon S3 para almacenar los archivos de carga de eventos que superen los 256 KB.

  14. En la sección Desencadenador de flujo, asegúrese de que esté seleccionada la opción Ejecutar flujo en el evento. Esta configuración garantiza que el flujo se ejecute cuando se produzca un evento de Salesforce nuevo.

  15. Seleccione Siguiente.

  16. Para la asignación de campos, seleccione Asignar todos los campos directamente. Como alternativa, puede seleccionar los campos que sean de interés en la lista Nombre de campos de origen.

    Para obtener más información sobre la asignación de campos, consulte Asignación de campos de origen de datos.

  17. Elija Next (Siguiente).

  18. (Opcional) Configura filtros para los campos de datos en Amazon AppFlow.

  19. Elija Next (Siguiente).

  20. Revise la configuración y, a continuación, seleccione Crear.

Con el flujo configurado, Amazon AppFlow crea una nueva fuente de eventos de socios que, a continuación, tendrás que asociar a un bus de eventos de socios en tu cuenta.

Paso 2: EventBridge Configúralo para recibir Salesforce eventos

Asegúrese de que el AppFlow flujo de Amazon que se desencadena a partir de Salesforce eventos con EventBridge como destino esté configurado antes de seguir las instrucciones de esta sección.

Para configurarlo EventBridge para recibir Salesforce eventos

  1. Abra la página de fuentes de eventos de los socios en la EventBridge consola.

  2. Seleccione el origen de evento de socios de Salesforce que creó en el Paso 1.

  3. Seleccione Asociar con bus de eventos.

  4. Valide el nombre del bus de eventos de socios.

  5. Seleccione Asociar.

  6. En la AppFlow consola de Amazon, abre el flujo que has creado y selecciona Activar flujo.

  7. Abre la página de reglas en la EventBridge consola.

  8. Seleccione Crear regla.

  9. Introduzca un nombre exclusivo para la regla.

  10. Seleccione patrón de eventos en la sección Definir patrón.

  11. En Patrón de coincidencia de eventos, seleccione Patrón predefinido de un servicio.

  12. En la sección Proveedor de servicios, seleccione Todos los eventos.

  13. En Seleccionar bus de eventos, seleccione Bus de eventos de socio o personalizado.

  14. Selecciona el bus de eventos que has asociado a la fuente de eventos del AppFlow socio de Amazon.

  15. En Seleccionar objetivos, elige el AWS servicio que actuará cuando se ejecute la regla. Una regla puede tener hasta cinco destinos.

  16. Seleccione Crear.

El servicio de destino recibe todos los eventos de Salesforce configurados para la cuenta. Para filtrar los eventos o enviar algunos eventos a diferentes destinos, puede utilizar la opción Filtrar en función del contenido con patrones de eventos.

nota

En el caso de eventos de más de 256 KB, Amazon AppFlow no envía el evento completo a EventBridge. En su lugar, Amazon AppFlow coloca el evento en un bucket de S3 de tu cuenta y, a continuación, envía un evento al bucket de Amazon S3 EventBridge con un puntero. Puede usar el puntero para obtener el evento completo del bucket.