Réception d'événements depuis Salesforce Amazon EventBridge

Vous pouvez utiliser Amazon EventBridge pour recevoir des événements 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 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.

Vous pouvez envoyer des informations sur les événements à des API destinations Salesforce en utilisant. 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 Salesforce API destination, consultezTutoriel : Envoyer des événements Salesforce depuis Amazon EventBridge.

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 REST API outil

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

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, choisissez Create flow.

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 Salesforce des événements pour les types de données AppFlow à traiter par Amazon.

8. Dans le menu déroulant Choisir un Salesforce événement, sélectionnez le type d'événement auquel 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 d’événement dont la taille est supérieure à 256 Ko.

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 sur 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 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 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 d’événement, sélectionnez Modèle prédéfini par un 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 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.

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 supérieurs à 256 Ko, 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.