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.

# Configuration d'un transformateur d'entrée lors de la création d'une règle dans EventBridge
<a name="eb-transform-input-rule"></a>

Lors de la création d'une règle, vous pouvez spécifier un transformateur d'entrée EventBridge à utiliser pour traiter les événements correspondants avant de les envoyer à la cible spécifiée. Vous pouvez configurer des transformateurs d'entrée pour des cibles qui sont des AWS services ou des destinations d'API.

**Pour créer un transformateur d’entrée cible dans le cadre d’une règle**

1. Suivez les étapes de création d’une règle, comme décrit dans [Création de règles sur Amazon EventBridge](eb-create-rule-visual.md).

1. À l’**Étape 3 : Sélectionner la ou les cibles**, développez **Réglages supplémentaires**.

1. Pour **Configurer l’entrée cible**, choisissez **Transformateur d’entrée** dans la liste déroulante.

   Cliquez sur **Configurer le transformateur d’entrée**.

   EventBridge affiche la boîte de dialogue **Configurer le transformateur d'entrée**.

1. Dans la section **Exemple d’événement**, choisissez un **Type d’exemple d’événement** par rapport auquel vous souhaitez tester votre modèle d’événement. Vous pouvez choisir un AWS événement, un événement partenaire ou créer votre propre événement personnalisé.

------
#### [ AWS events ]

   Faites votre choix parmi les événements émis par les Services AWS pris en charge.

   1. Sélectionnez **Événements AWS **.

   1. Sous **Exemples d'événements**, sélectionnez l' AWS événement souhaité. Les événements sont organisés par AWS service.

      Lorsque vous sélectionnez un événement, EventBridge renseigne l'exemple d'événement.

      Par exemple, si vous choisissez **S3 Object Created**, EventBridge affiche un exemple d'événement S3 Object Created.

   1. (Facultatif) Vous pouvez également sélectionner **Copier** pour copier l’exemple d’événement dans le presse-papiers de votre appareil.

------
#### [ Partner events ]

   Choisissez parmi les événements émis par des services tiers compatibles EventBridge, tels que Salesforce.

   1. Sélectionnez les **événements EventBridge partenaires**.

   1. Sous **Exemples d’événements**, choisissez l’événement partenaire souhaité. Les événements sont organisés par partenaire.

      Lorsque vous sélectionnez un événement, EventBridge renseigne l'exemple d'événement.

   1. (Facultatif) Vous pouvez également sélectionner **Copier** pour copier l’exemple d’événement dans le presse-papiers de votre appareil.

------
#### [ Enter your own ]

   Entrez votre propre événement au format texte JSON.

   1. Sélectionnez **Saisir mon propre**.

   1. EventBridge remplit l'exemple d'événement avec un modèle d'attributs d'événement obligatoires.

   1. Modifiez et faites des ajouts à l’exemple d’événement selon vos besoins. L’exemple d’événement doit être au format JSON valide.

   1. (Facultatif) Vous pouvez également choisir l’une des options suivantes :
      + **Copier** : copiez l’exemple d’événement dans le presse-papiers de votre appareil.
      + **Prettify** : facilite la lecture du texte JSON en ajoutant des sauts de ligne, des tabulations et des espaces.

------

1. (Facultatif) Développez la section **Exemples de chemins d’entrée, de modèles et de sorties** pour afficher les exemples suivants :
   + Comment les chemins JSON sont-ils utilisés pour définir des variables qui représentent les données d’événement
   + Comment ces variables peuvent être utilisées dans un modèle de transformateur d’entrée
   + La sortie résultante qui est EventBridge envoyée à la cible

   Pour obtenir des exemples plus détaillés de transformations d’entrée, consultez [Exemples de transformation d’entrée](eb-transform-target-input.md#eb-transform-input-examples).

1. Dans la section **Transformateur d’entrée cible**, définissez les variables que vous souhaitez utiliser dans le modèle d’entrée.

   Les variables utilisent le chemin JSON pour référencer des valeurs dans la source d’événement d’origine. Vous pouvez ensuite référencer ces variables dans le modèle d'entrée afin d'inclure les données de l'événement source d'origine dans l'événement transformé EventBridge transmis à la cible. Vous pouvez définir jusqu’à 100 variables. Le transformateur d’entrée doit être au format JSON valide.

   Supposons, par exemple, que vous ayez choisi l' AWS événement **S3 Object Created** comme exemple d'événement pour ce transformateur d'entrée. Vous pouvez alors définir les variables suivantes à utiliser dans votre modèle :

   ```
   {
     "requester": "$.detail.requester",
     "key": "$.detail.object.key",
     "bucket": "$.detail.bucket.name"
   }
   ```

   (Facultatif) Vous pouvez également choisir **Copier** pour copier le transformateur d’entrée dans le presse-papiers de votre appareil.

1. Dans la section **Modèle**, composez le modèle que vous souhaitez utiliser pour déterminer ce qui EventBridge passe à la cible.

   Vous pouvez utiliser du code JSON, des chaînes, des informations statiques, les variables que vous avez définies ainsi que des variables réservées. Pour obtenir des exemples plus détaillés de transformations d’entrée, consultez [Exemples de transformation d’entrée](eb-transform-target-input.md#eb-transform-input-examples).

   Par exemple, supposons que vous avez défini les variables dans l’exemple précédent. Vous pouvez alors composer le modèle suivant, qui fait référence à ces variables, ainsi qu’aux variables réservées et aux informations statiques.

   ```
   {
       "message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
       "RuleName": <aws.events.rule-name>,
       "ruleArn" : <aws.events.rule-arn>,
       "Transformed": "Yes"
   }
   ```

   (Facultatif) Vous pouvez également choisir **Copier** pour copier le modèle dans le presse-papiers de votre appareil.

1. Pour tester votre modèle, sélectionnez **Générer une sortie**.

   EventBridge traite l'exemple d'événement en fonction du modèle d'entrée et affiche la sortie transformée générée sous **Sortie**. Il s'agit des informations qui EventBridge seront transmises à la cible à la place de l'événement source d'origine.

   La sortie générée pour l’exemple de modèle d’entrée décrit ci-dessus est la suivante :

   ```
   {
       "message": "123456789012 has created the object "example-key" in the bucket "amzn-s3-demo-bucket"",
       "RuleName": rule-name,
       "ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
       "Transformed": "Yes"
   }
   ```

   (Facultatif) Vous pouvez également choisir **Copier** pour copier la sortie générée dans le presse-papiers de votre appareil.

1. Sélectionnez **Confirmer**.

1. Suivez le reste des étapes de création d’une règle, comme décrit dans [Création de règles sur Amazon EventBridge](eb-create-rule-visual.md).