

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.

# Test d'un transformateur d'entrée cible à l'aide du EventBridge Sandbox
<a name="eb-sandbox-input-trans"></a>

Vous pouvez utiliser des transformateurs d'entrée pour personnaliser le texte d'un [événement](eb-events.md) avant de EventBridge transmettre les informations à la [cible](eb-targets.md) d'une [règle](eb-rules.md).

La configuration d’un transformateur d’entrée fait généralement partie du processus plus vaste qui consiste à spécifier une cible lors de la [création d’une nouvelle règle](eb-create-rule-visual.md) ou de la modification d’une règle existante. En utilisant le Sandbox EventBridge, vous pouvez toutefois configurer rapidement un transformateur d'entrée et utiliser un exemple d'événement pour confirmer que vous obtenez la sortie souhaitée, sans avoir à créer ou à modifier de règle.

Pour plus d’informations sur les transformations d’entrée, consultez [Transformation des EventBridge entrées Amazon](eb-transform-target-input.md).

**Pour tester un transformateur d’entrée cible**

1. Ouvrez la EventBridge console Amazon à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Sous **Ressources pour développeurs**, choisissez **Environnement de test (sandbox)**, puis sur la page **Environnement de test (sandbox)**, cliquez sur l’onglet **Transformateur d’entrée cible**.

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.