Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Réception d'événements depuis Salesforce Amazon EventBridge
Vous pouvez utiliser Amazon EventBridge pour recevoir [des événements](eb-events.md) Salesforce de différentes manières :
+ En utilisant la fonction Salesforce's Event Bus Relay pour recevoir des événements directement sur le bus d'événements d'un EventBridge partenaire.
+ En configurant un flux dans [Amazon AppFlow](https://aws.amazon.com/appflow/) qui est utilisé Salesforce comme source de données. Amazon envoie AppFlow ensuite Salesforce les événements à EventBridge l'aide d'un [bus d'événements partenaire](eb-saas.md).
Vous pouvez envoyer des informations sur les événements à Salesforce l’aide de destinations d’API. Une fois que l’événement est envoyé à Salesforce, il peut être traité par des [flux](https://help.salesforce.com/s/articleView?id=flow.htm) ou des [déclencheurs Apex](https://developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_triggers.htm). Pour plus d’informations sur la configuration d’une destination d’API Salesforce, consultez [Tutoriel : Envoyer des événements Salesforce depuis Amazon EventBridge](eb-tutorial-salesforce.md).
**Topics**
+ [Réception d’événements de Salesforce à l’aide d’Event Bus Relay](#eb-saas-salesforce-relay)
+ [Réception d'événements liés à Salesforce l'utilisation d'Amazon AppFlow](#eb-saas-salesforce-appflow)
## Réception d’événements de Salesforce à l’aide d’Event Bus Relay
### Étape 1 : configurer Salesforce Event Bus Relay et une source d'événements EventBridge partenaire
Lorsque vous créez une configuration de relais d'événements surSalesforce, Salesforce crée une source d'événements partenaire EventBridge dans l'état en attente.
**Pour configurer Salesforce Event Bus Relay**
1. [Configuration d’un outil d’API REST](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.z63eim1tqkm3) (langue française non garantie)
1. [(Facultatif) Définition d’un événement de plateforme](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.2m5t2i52o23m) (langue française non garantie)
1. [Création d’une chaîne pour un événement de plateforme personnalisé](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.s0spl5puf9d0) (langue française non garantie)
1. [Création d’un membre de chaîne pour associer l’événement de plateforme personnalisé](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.rdhi4awp8cvv) (langue française non garantie)
1. [Création d’informations d’identification nommées](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.etec44jyv3og) (langue française non garantie)
1. [Création d’une configuration de relais d’événements](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.43rfyeehz0w5) (langue française non garantie)
### Étape 2 : activer la source d'événements du Salesforce partenaire dans la EventBridge console et démarrer le relais d'événements
1. Ouvrez la page des [sources d'événements partenaires](https://console.aws.amazon.com/events/home?#/partners) dans la EventBridge console.
1. Sélectionnez la source d’événement partenaire Salesforce que vous avez créée à l’étape 1.
1. Choisissez **Associer au bus d’événements**.
1. Validez le nom du bus d’événements partenaire.
1. Choisissez **Associer**.
1. [Démarrez le relais d’événements](https://resources.docs.salesforce.com/rel1/doc/en-us/static/pdf/Salesforce_Event_Bus_Relay_Pilot.pdf#h.t01b3xp87vhu).
Maintenant que vous avez configuré et démarré le relais Event Bus et configuré la source d'événements partenaire, vous pouvez créer une [EventBridge règle qui réagit aux événements](eb-create-rule-visual.md) pour filtrer et envoyer les données à une [cible](eb-targets.md).
## Réception d'événements liés à Salesforce l'utilisation d'Amazon AppFlow
Amazon AppFlow encapsule les événements depuis Salesforce une enveloppe d' EventBridge événements. L'exemple suivant montre un Salesforce événement reçu par un bus d'événements EventBridge partenaire.
```
{
"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"
}
}
```
### Étape 1 : configurer Amazon AppFlow pour l'utiliser Salesforce comme source d'événements partenaire
Pour envoyer des événements à EventBridge, vous devez d'abord configurer Amazon AppFlow pour l'utiliser Salesforce comme source d'événements partenaire.
1. Dans la [ AppFlowconsole Amazon](https://console.aws.amazon.com/appflow/), choisissez **Create flow**.
1. Dans la section **Détails du flux**, dans **Nom du flux**, entrez le nom de votre flux.
1. (Facultatif) Entrez une description du flux, puis choisissez **Suivant**.
1. Sous **Détails de la source**, choisissez *Salesforce* dans le menu déroulant **Nom de la source**, puis choisissez **Connexion** pour créer une nouvelle connexion.
1. Dans la boîte de dialogue **Connexion à Salesforce**, choisissez **Production** ou **Environnement de test (sandbox)** pour l’environnement Salesforce.
1. Dans le champ **Nom de la connexion**, entrez un nom unique pour la connexion, puis choisissez **Continuer**.
1. Dans la boîte de dialogue Salesforce, procédez comme suit :
1. Entrez vos informations d’identification de connexion Salesforce pour vous connecter à Salesforce.
1. Sélectionnez Salesforce des événements pour les types de données AppFlow à traiter par Amazon.
1. Dans le menu déroulant **Choisir un Salesforce événement**, sélectionnez le type d'événement auquel envoyer EventBridge.
1. Pour une destination, sélectionnez **Amazon EventBridge**.
1. Sélectionnez **Créer une nouvelle source d’événement partenaire**.
1. (Facultatif) Spécifiez un suffixe unique pour la source d’événement partenaire.
1. Choisissez **Générer une source d’événement partenaire**.
1. Choisissez un compartiment Amazon S3 pour stocker les fichiers de charge utile des événements d'une taille supérieure à 1 Mo.
1. Dans la section **Déclencheur de flux**, assurez-vous que le paramètre **Exécuter le flux en cas d’événement** est sélectionné. Ce paramètre garantit que le flux est exécuté lorsqu’un nouvel événement Salesforce se produit.
1. Choisissez **Suivant**.
1. Pour le mappage de champs, sélectionnez **Mapper directement tous les champs**. Vous pouvez également sélectionner les champs qui vous intéressent dans la liste **Nom de champ source**.
Pour plus d’informations sur le mappage de champs, consultez [Mappage des champs de données](https://docs.aws.amazon.com//appflow/latest/userguide/getting-started.html#map-fields).
1. Choisissez **Suivant**.
1. (Facultatif) Configurez les filtres pour les champs de données sur Amazon AppFlow.
1. Choisissez **Suivant**.
1. Passez en revue les paramètres, puis choisissez **Créer le flux**.
Une fois le flux configuré, Amazon AppFlow crée une nouvelle source d'événements partenaires que vous devez ensuite associer à un bus d'événements partenaire dans votre compte.
### Étape 2 : Configuration EventBridge pour recevoir des Salesforce événements
Assurez-vous que le AppFlow flux Amazon déclenché par des Salesforce événements ayant EventBridge pour destination est configuré avant de suivre les instructions de cette section.
**Pour configurer EventBridge la réception d'Salesforceévénements**
1. Ouvrez la page des [sources d'événements partenaires](https://console.aws.amazon.com/events/home?#/partners) dans la EventBridge console.
1. Sélectionnez la source d’événement partenaire Salesforce que vous avez créée à l’étape 1.
1. Choisissez **Associer au bus d’événements**.
1. Validez le nom du bus d’événements partenaire.
1. Choisissez **Associer**.
1. Dans la AppFlow console Amazon, ouvrez le flux que vous avez créé et choisissez **Activer le flux**.
1. Ouvrez la page [Règles](https://console.aws.amazon.com/events/home?#/rules) dans la EventBridge console.
1. Choisissez **Créer une règle**.
1. Entrez un nom unique pour la règle.
1. Choisissez **Modèle d’événement** dans la section **Définir un modèle**.
1. Pour **Modèle de correspondance d’événement**, sélectionnez **Modèle prédéfini par un service**.
1. Dans la section **Fournisseur de service**, sélectionnez **Tous les événements**.
1. Pour **Sélectionnez un bus d’événements**, choisissez **Bus d’événements personnalisé ou partenaire**.
1. Sélectionnez le bus d'événements que vous avez associé à la source d'événements du AppFlow partenaire Amazon.
1. Pour **Select targets**, choisissez le AWS service qui doit agir lors de l'exécution de la règle. Une règle peut avoir jusqu’à cinq cibles.
1. Choisissez **Créer**.
Le service cible reçoit tous les événements Salesforce configurés pour votre compte. Pour filtrer les événements ou envoyer certains événements à différentes cibles, vous pouvez utiliser le [filtrage basé sur le contenu avec des modèles d’événements](eb-create-pattern.md#eb-event-patterns-content-based-filtering).
**Note**
Pour les événements supérieurs à 1 Mo, Amazon AppFlow n'envoie pas l'événement complet à EventBridge. Amazon AppFlow place plutôt l'événement dans un compartiment S3 de votre compte, puis envoie un événement à l' EventBridge aide d'un pointeur vers le compartiment Amazon S3. Vous pouvez utiliser le pointeur pour obtenir l’événement complet depuis le compartiment.