Filter Data Keys

Filter Data Keys decide qué campos de tus registros siguen adelante en el flujo. Puedes trabajar de dos formas: indicar los campos que quieres conservar o indicar los que quieres quitar. Funciona con un registro o con una lista, y llega también a campos que están dentro de otros, como cliente.direccion.ciudad.

Cuándo usarlo

• La respuesta de una API trae muchos datos y solo necesitas tres o cuatro campos, algunos dentro de otros.
• Quieres quitar campos internos o sensibles, como password o notas_internas, antes de enviar los datos a un tercero.
• Vas a crear filas en una hoja de cálculo y quieres que cada campo anidado se convierta en una columna.

Configuración

Campo	Qué hace
Input Data	El registro o la lista de registros que quieres filtrar.
Filter Criteria	Lista de campos, uno por línea. Para un campo dentro de otro, separa los niveles con un punto: cliente.email. No distingue entre mayúsculas y minúsculas.
Exclude Keys	Desactivado (por defecto): se conservan solo los campos de la lista. Activado: se conservan todos los campos excepto los de la lista.

Resultado

La salida Filtered Data devuelve un registro si recibiste uno, o una lista si recibiste varios.

• Conservando campos: el resultado tiene un campo por cada elemento de la lista, todos en el primer nivel. Los puntos del nombre se convierten en guiones bajos: cliente.email pasa a ser cliente_email. Si un registro no tiene ese campo, aparece vacío.
• Excluyendo campos: el registro mantiene su estructura original, sin los campos indicados.

Ejemplo

Un flujo consulta los pedidos en una tienda online y quiere escribirlos en una hoja de cálculo.

1. Conecta la lista de pedidos a Input Data.
2. En Filter Criteria, escribe id, total, cliente.nombre y cliente.email.
3. Deja Exclude Keys desactivado. Cada pedido saldrá con los campos id, total, cliente_nombre y cliente_email, listos para convertirse en columnas.

Componentes relacionados

• Filter Data Values: filtra registros según el valor de un campo.
• Extract Data: conserva campos por su nombre o por cómo empiezan.
• Flatten By Key: convierte una lista dentro de un registro en varios registros.