Extract Data

Extract Data es un componente sencillo que te permite seleccionar solo los campos que necesitas de un objeto de datos. Ideal cuando quieres reducir la información que pasa a los siguientes pasos de tu flujo de trabajo.

¿Cómo funciona?

El componente recibe un objeto Data (o un Message que contiene datos) y una lista de claves.

1. Entrada de datos: Si el dato es una lista, procesa cada elemento; si es un solo objeto, lo trata como una lista de un solo elemento.
2. Filtrado: Por cada clave indicada, copia el valor correspondiente al nuevo objeto.
   • Si la clave termina con *, se considera un comodín y se incluyen todas las claves que empiecen con la parte antes del asterisco.
3. Salida: Devuelve una lista de objetos Data que contienen únicamente los campos solicitados.
   No se realizan llamadas externas; todo el procesamiento ocurre localmente dentro del dashboard.

Entradas

• Data: Data object to filter.

  • Se puede conectar con la salida de cualquier componente que genere datos (por ejemplo, un componente de lectura de base de datos o un extractor de texto).

• Extract keys: List of keys to extract.

  • Escribe los nombres de los campos que quieres conservar, separados por comas o en líneas distintas.
  • Puedes usar * al final de una clave para incluir todos los campos que comiencen con ese prefijo (ejemplo: user_* incluirá user_id, user_name, etc.).

Salidas

• Extracted Data: Data
  • La salida es una lista de objetos Data que contienen solo los campos especificados.
  • Puedes conectar esta salida a cualquier otro componente que requiera datos filtrados, como un visualizador, un guardador o un analizador.

Ejemplo de Uso

Supongamos que tienes un flujo que extrae información de un formulario y quieres enviar solo el nombre y el correo electrónico a un sistema externo.

1. Entrada

   • Conecta la salida de tu componente de lectura de formulario a Data.
   • En Extract keys escribe:

     name
     email

2. Salida

   • Conecta Extracted Data a un componente de envío de correo o a un visualizador de tabla.
   • El flujo ahora solo enviará los campos name y email, reduciendo la cantidad de datos que se procesan y mejorando la privacidad.

Componentes Relacionados

• Data – Representa la estructura de datos que se pasa entre componentes.
• Message – Permite combinar texto y datos; el componente convierte automáticamente un mensaje en un objeto Data.
• Filter Data – Similar, pero permite filtrar por condiciones más complejas (por ejemplo, valores que cumplan una expresión).
• Transform Data – Aplica transformaciones a los campos (formateo, cálculo, etc.).

Consejos y Mejores Prácticas

• Usa comodines con precaución: * es útil para incluir varios campos, pero puede traer más datos de los que necesitas.
• Mantén la lista de claves corta: Un filtro más específico reduce la carga de procesamiento y mejora la claridad del flujo.
• Verifica la salida: Conecta la salida a un componente de visualización (por ejemplo, una tabla) para comprobar que solo aparecen los campos deseados.
• Combina con otros filtros: Si necesitas filtrar por valores además de por claves, usa Filter Data después de Extract Data.

Consideraciones de Seguridad

• El componente trabaja únicamente con los datos que ya están en el flujo; no realiza llamadas a servicios externos ni expone información fuera del entorno de Nappai.
• Asegúrate de que los datos sensibles (contraseñas, tokens, etc.) no se incluyan en la lista de claves a extraer, a menos que el flujo los maneje de forma segura (por ejemplo, en un componente de cifrado).