# Procesadores de transformación
Los procesadores de transformación modifican la estructura de los eventos del registro mediante la adición, la copia, el desplazamiento o la eliminación de campos.
## Procesador add\$1entries
Agrega pares clave-valor estáticos a eventos de registro. Se puede agregar un máximo de 1 procesador `add_entries` a una canalización.
**Configuración**
Configure el procesador add\$1entries con los siguientes parámetros:
```
processor:
- add_entries:
entries:
- key: "environment"
value: "production"
overwrite_if_key_exists: false
```Parameters
`entries` (obligatorio)
Matriz de pares clave-valor que se agregarán a cada evento de registro.
`entries[].key` (obligatorio)
Nombre del campo que se agregará al evento de registro. Admite campos anidados mediante notación de puntos.
`entries[].value` (obligatorio)
Valor estático que se asignará a la clave.
`entries[].overwrite_if_key_exists` (opcional)
Indicador booleano que determina el comportamiento cuando la clave ya existe. El valor predeterminado es falso.
`when` (opcional)
Expresión condicional de procesador. Si se especifica, se omite todo el procesador si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).
`entries[].when` (opcional)
Expresión condicional de entrada. Si se especifica, solo se omite esta entrada si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).
`entries[].when_else` (opcional)
Entrada alternativa que se pone en marcha solo cuando ninguna de las otras condiciones `when` del mismo procesador se cumplió. El valor de la expresión identifica qué condiciones `when` se deben tener en cuenta. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).
## Procesador copy\$1values
Copia valores de un campo a otro. Se puede agregar un máximo de 1 procesador `copy_values` a una canalización.
**Configuración**
Configure el procesador copy\$1values con los siguientes parámetros:
```
processor:
- copy_values:
entries:
- from_key: "user_id"
to_key: "backup_user"
overwrite_if_to_key_exists: false
```Parameters
`entries` (obligatorio)
Matriz de operaciones de copia que se llevarán a cabo en cada evento de registro.
`entries[].from_key` (obligatorio)
Nombre del campo desde el que se copiará el valor. Utiliza la notación de puntos para campos anidados.
`entries[].to_key` (obligatorio)
Nombre del campo al que se copiará el valor. Creará estructuras anidadas si se utiliza la notación de puntos.
`entries[].overwrite_if_to_key_exists` (opcional)
Indicador booleano que controla el comportamiento cuando el campo de destino ya existe. El valor predeterminado es falso.
`when` (opcional)
Expresión condicional de procesador. Si se especifica, se omite todo el procesador si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).
`entries[].when` (opcional)
Expresión condicional de entrada. Si se especifica, solo se omite esta entrada si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).
`entries[].when_else` (opcional)
Entrada alternativa que se pone en marcha solo cuando ninguna de las otras condiciones `when` del mismo procesador se cumplió. El valor de la expresión identifica qué condiciones `when` se deben tener en cuenta. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).
## Procesador delete\$1entries
Elimina los campos especificados de los eventos de registro.
**Configuración**
Configure el procesador delete\$1entries con los siguientes parámetros:
```
processor:
- delete_entries:
with_keys: ["temp_field", "debug_info"]
```Parameters
`with_keys` (obligatorio)
Matriz de nombres de campos que se eliminarán de cada evento de registro. Admite la eliminación de campos anidados mediante la notación de puntos.
`when` (opcional)
Expresión condicional que determina si este procesador se pone en marcha. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).
## Procesador move\$1keys
Desplaza campos de una ubicación a otra.
**Configuración**
Configure el procesador move\$1keys con los siguientes parámetros:
```
processor:
- move_keys:
entries:
- from_key: "old_field"
to_key: "new_field"
overwrite_if_to_key_exists: true
```Parameters
`entries` (obligatorio)
Matriz de operaciones de desplazamiento. Número máximo de entradas: 5.
`entries[].from_key` (obligatorio)
Nombre del campo de origen. 128 caracteres como máximo.
`entries[].to_key` (obligatorio)
Nombre del campo de destino. 128 caracteres como máximo.
`entries[].overwrite_if_to_key_exists` (opcional)
Si se debe sobrescribir el campo de destino existente.
`when` (opcional)
Expresión condicional de procesador. Si se especifica, se omite todo el procesador si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).
`entries[].when` (opcional)
Expresión condicional de entrada. Si se especifica, solo se omite esta entrada si la expresión se evalúa como falsa. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).
`entries[].when_else` (opcional)
Entrada alternativa que se pone en marcha solo cuando ninguna de las otras condiciones `when` del mismo procesador se cumplió. El valor de la expresión identifica qué condiciones `when` se deben tener en cuenta. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).
## Procesador flatten
Aplana estructuras de objetos anidados.
**Configuración**
Configure el procesador flatten con los siguientes parámetros:
```
processor:
- flatten:
source: "metadata"
target: "flattened"
remove_processed_fields: true
exclude_keys: ["sensitive_data"]
```Parameters
`source` (obligatorio)
Campo que contiene el objeto anidado que aplanará.
`target` (obligatorio)
Prefijo del campo de destino para claves aplanadas.
`remove_processed_fields` (opcional)
Si se debe eliminar el campo anidado original después del aplanamiento.
`exclude_keys` (opcional)
Matriz de claves que se excluirán del aplanamiento. Máximo de 20 claves, cada una de hasta 128 caracteres.
`when` (opcional)
Expresión condicional que determina si este procesador se pone en marcha. La longitud máxima es de 256 caracteres. Consulte [Sintaxis de expresiones para el procesamiento condicional](conditional-processing.md).