View a markdown version of this page

Recevoir des événements de Salesforce sur Amazon EventBridge - Amazon EventBridge
Réception d’événements de Salesforce à l’aide d’Event Bus RelayRecevoir des événements en Salesforce utilisant Amazon AppFlow

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.

Recevoir des événements de Salesforce sur Amazon EventBridge

Vous pouvez utiliser Amazon EventBridge pour recevoir des événements de Salesforce la manière suivante :

  • En utilisant la fonction Salesforce's Event Bus Relay pour recevoir des événements directement sur un bus événementiel EventBridge partenaire.

  • En configurant un flux dans Amazon AppFlow qui l'utilise Salesforce comme source de données. Amazon envoie AppFlow ensuite Salesforce les événements à EventBridge l'aide d'un bus d'événements partenaire.

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 ou des déclencheurs Apex. Pour plus d’informations sur la configuration d’une destination d’API Salesforce, consultez Tutoriel : Envoyer des événements Salesforce depuis Amazon EventBridge.

Recevoir des événements de Salesforce en utilisant 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 activéeSalesforce, Salesforce crée une source d'événements partenaire EventBridge à l'état en attente.

Pour configurer Salesforce Relais de bus événementiel

  1. Configuration d’un outil d’API REST (langue française non garantie)

  2. (Facultatif) Définition d’un événement de plateforme (langue française non garantie)

  3. Création d’une chaîne pour un événement de plateforme personnalisé (langue française non garantie)

  4. Création d’un membre de chaîne pour associer l’événement de plateforme personnalisé (langue française non garantie)

  5. Création d’informations d’identification nommées (langue française non garantie)

  6. Création d’une configuration de relais d’événements (langue française non garantie)

Étape 2 : activer Salesforce source d'événements partenaire dans la EventBridge console et démarrez le relais d'événements

  1. Ouvrez la page des sources d'événements partenaires dans la EventBridge console.

  2. Sélectionnez la source d’événement partenaire Salesforce que vous avez créée à l’étape 1.

  3. Choisissez Associer au bus d’événements.

  4. Validez le nom du bus d’événements partenaire.

  5. Choisissez Associer.

  6. Démarrez le relais d’événements.

Maintenant que vous avez configuré et démarré le relais Event Bus Relay et configuré la source d'événements partenaire, vous pouvez créer une EventBridge règle qui réagit aux événements pour filtrer et envoyer les données à une cible.

Recevoir des événements de Salesforce en utilisant Amazon AppFlow

Amazon AppFlow encapsule les événements Salesforce dans une enveloppe d' EventBridge événement. L'exemple suivant montre un Salesforce événement reçu par un bus événementiel 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 utiliser Salesforce en tant que source d'événements partenaire

Pour envoyer des événements à EventBridge, vous devez d'abord configurer Amazon AppFlow pour qu'il l'utilise Salesforce comme source d'événements partenaire.

  1. Dans la AppFlow console Amazon, choisissez Créer un flux.

  2. Dans la section Détails du flux, dans Nom du flux, entrez le nom de votre flux.

  3. (Facultatif) Entrez une description du flux, puis choisissez Suivant.

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

  5. Dans la boîte de dialogue Connexion à Salesforce, choisissez Production ou Environnement de test (sandbox) pour l’environnement Salesforce.

  6. Dans le champ Nom de la connexion, entrez un nom unique pour la connexion, puis choisissez Continuer.

  7. Dans la boîte de dialogue Salesforce, procédez comme suit :

    1. Entrez vos informations d’identification de connexion Salesforce pour vous connecter à Salesforce.

    2. Sélectionnez les Salesforce événements correspondant aux types de données AppFlow à traiter par Amazon.

  8. Dans la liste déroulante Choisir Salesforce un événement, sélectionnez le type d'événement auquel vous souhaitez envoyer EventBridge.

  9. Pour une destination, sélectionnez Amazon EventBridge.

  10. Sélectionnez Créer une nouvelle source d’événement partenaire.

  11. (Facultatif) Spécifiez un suffixe unique pour la source d’événement partenaire.

  12. Choisissez Générer une source d’événement partenaire.

  13. Choisissez un compartiment Amazon S3 pour stocker les fichiers de charge utile des événements dont la taille est supérieure à 1 Mo.

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

  15. Choisissez Suivant.

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

  17. Choisissez Suivant.

  18. (Facultatif) Configurez les filtres pour les champs de données dans Amazon AppFlow.

  19. Choisissez Suivant.

  20. 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 événementiel partenaire de votre compte.

Étape 2 : configurer EventBridge pour recevoir Salesforce events

Assurez-vous que l'Amazon AppFlow Flow déclenché à partir d'Salesforceévénements EventBridge ayant pour destination est configuré avant de suivre les instructions de cette section.

Pour configurer EventBridge pour recevoir Salesforce events

  1. Ouvrez la page des sources d'événements partenaires dans la EventBridge console.

  2. Sélectionnez la source d’événement partenaire Salesforce que vous avez créée à l’étape 1.

  3. Choisissez Associer au bus d’événements.

  4. Validez le nom du bus d’événements partenaire.

  5. Choisissez Associer.

  6. Dans la AppFlow console Amazon, ouvrez le flux que vous avez créé et choisissez Activer le flux.

  7. Ouvrez la page Règles dans la EventBridge console.

  8. Choisissez Créer une règle.

  9. Entrez un nom unique pour la règle.

  10. Choisissez Modèle d’événement dans la section Définir un modèle.

  11. Pour Modèle de correspondance des événements, sélectionnez Pre-defined modèle par service.

  12. Dans la section Fournisseur de service, sélectionnez Tous les événements.

  13. Pour Sélectionnez un bus d’événements, choisissez Bus d’événements personnalisé ou partenaire.

  14. Sélectionnez le bus d'événements que vous avez associé à la source d'événements du AppFlow partenaire Amazon.

  15. Pour Sélectionner des cibles, choisissez le AWS service qui doit agir lorsque la règle s'exécute. Une règle peut avoir jusqu’à cinq cibles.

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

Note

Pour les événements d'une taille supérieure à 1 Mo, Amazon AppFlow n'envoie pas l'intégralité de l'événement à 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.