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.

# Processeurs de transformation
<a name="transformation-processors"></a>

Les processeurs de transformation modifient la structure des événements du journal en ajoutant, en copiant, en déplaçant ou en supprimant des champs.

## processeur add\$1entries
<a name="add-entries-processor"></a>

Ajoute des paires clé-valeur statiques aux événements du journal. Au maximum 1 `add_entries` processeur peut être ajouté à un pipeline.

**Configuration**  
Configurez le processeur add\$1entries avec les paramètres suivants :

```
processor:
  - add_entries:
      entries:
        - key: "environment"
          value: "production"
          overwrite_if_key_exists: false
```Parameters

`entries` (obligatoire)  
Tableau de paires clé-valeur à ajouter à chaque événement du journal.

`entries[].key` (obligatoire)  
Le nom du champ à ajouter au journal des événements. Supporte les champs imbriqués à l'aide de la notation par points.

`entries[].value` (obligatoire)  
La valeur statique à attribuer à la clé.

`entries[].overwrite_if_key_exists` (facultatif)  
Drapeau booléen qui détermine le comportement lorsque la clé existe déjà. La valeur par défaut est false.

`when` (facultatif)  
Expression conditionnelle au niveau du processeur. Lorsque cette option est spécifiée, l'ensemble du processeur est ignoré si l'expression est fausse. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).

`entries[].when` (facultatif)  
Expression conditionnelle d'entrée de gamme. Lorsqu'elle est spécifiée, seule cette entrée est ignorée si l'expression est fausse. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).

`entries[].when_else` (facultatif)  
Entrée de secours qui s'exécute uniquement lorsqu'aucune des autres `when` conditions du même processeur ne correspond. La valeur de l'expression identifie les `when` conditions à prendre en compte. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).

## processeur copy\$1values
<a name="copy-values-processor"></a>

Copie les valeurs d'un champ vers un autre. Au maximum 1 `copy_values` processeur peut être ajouté à un pipeline.

**Configuration**  
Configurez le processeur copy\$1values avec les paramètres suivants :

```
processor:
  - copy_values:
      entries:
        - from_key: "user_id"
          to_key: "backup_user"
          overwrite_if_to_key_exists: false
```Parameters

`entries` (obligatoire)  
Tableau d'opérations de copie à effectuer sur chaque événement du journal.

`entries[].from_key` (obligatoire)  
Le nom du champ à partir duquel copier la valeur. Utilise la notation par points pour les champs imbriqués.

`entries[].to_key` (obligatoire)  
Le nom du champ dans lequel copier la valeur. Créera des structures imbriquées si vous utilisez la notation par points.

`entries[].overwrite_if_to_key_exists` (facultatif)  
Drapeau booléen contrôlant le comportement lorsque le champ cible existe déjà. La valeur par défaut est false.

`when` (facultatif)  
Expression conditionnelle au niveau du processeur. Lorsque cette option est spécifiée, l'ensemble du processeur est ignoré si l'expression est fausse. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).

`entries[].when` (facultatif)  
Expression conditionnelle d'entrée de gamme. Lorsqu'elle est spécifiée, seule cette entrée est ignorée si l'expression est fausse. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).

`entries[].when_else` (facultatif)  
Entrée de secours qui s'exécute uniquement lorsqu'aucune des autres `when` conditions du même processeur ne correspond. La valeur de l'expression identifie les `when` conditions à prendre en compte. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).

## processeur delete\$1entries
<a name="delete-entries-processor"></a>

Supprime les champs spécifiés des événements du journal.

**Configuration**  
Configurez le processeur delete\$1entries avec les paramètres suivants :

```
processor:
  - delete_entries:
      with_keys: ["temp_field", "debug_info"]
```Parameters

`with_keys` (obligatoire)  
Tableau de noms de champs à supprimer de chaque événement du journal. Supporte la suppression de champs imbriqués à l'aide de la notation par points.

`when` (facultatif)  
Expression conditionnelle qui détermine si ce processeur s'exécute. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).

## processeur move\$1keys
<a name="move-keys-processor"></a>

Déplace les champs d'un endroit à un autre.

**Configuration**  
Configurez le processeur move\$1keys avec les paramètres suivants :

```
processor:
  - move_keys:
      entries:
        - from_key: "old_field"
          to_key: "new_field"
          overwrite_if_to_key_exists: true
```Parameters

`entries` (obligatoire)  
Ensemble d'opérations de déplacement. Maximum de 5 entrées.

`entries[].from_key` (obligatoire)  
Nom du champ source. 128 caractères maximum.

`entries[].to_key` (obligatoire)  
Nom du champ cible. 128 caractères maximum.

`entries[].overwrite_if_to_key_exists` (facultatif)  
S'il faut remplacer le champ cible existant.

`when` (facultatif)  
Expression conditionnelle au niveau du processeur. Lorsque cette option est spécifiée, l'ensemble du processeur est ignoré si l'expression est fausse. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).

`entries[].when` (facultatif)  
Expression conditionnelle d'entrée de gamme. Lorsqu'elle est spécifiée, seule cette entrée est ignorée si l'expression est fausse. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).

`entries[].when_else` (facultatif)  
Entrée de secours qui s'exécute uniquement lorsqu'aucune des autres `when` conditions du même processeur ne correspond. La valeur de l'expression identifie les `when` conditions à prendre en compte. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).

## aplatir le processeur
<a name="flatten-processor"></a>

Aplatit les structures d'objets imbriquées.

**Configuration**  
Configurez le processeur d'aplatissement avec les paramètres suivants :

```
processor:
  - flatten:
      source: "metadata"
      target: "flattened"
      remove_processed_fields: true
      exclude_keys: ["sensitive_data"]
```Parameters

`source` (obligatoire)  
Champ contenant un objet imbriqué à aplatir.

`target` (obligatoire)  
Préfixe du champ cible pour les touches aplaties.

`remove_processed_fields` (facultatif)  
S'il faut supprimer le champ imbriqué d'origine après l'aplatissement.

`exclude_keys` (facultatif)  
Tableau de clés à exclure de l'aplatissement. 20 touches au maximum, chacune comportant 128 caractères maximum.

`when` (facultatif)  
Expression conditionnelle qui détermine si ce processeur s'exécute. La longueur maximale est de 256 caractères. Consultez [Syntaxe d'expression pour le traitement conditionnel](conditional-processing.md).