Saltearse al contenido
Nappai Documentation

CSV to Data List

CSV to Data List es un componente sencillo que toma datos en formato CSV y los transforma en una lista de objetos Data. Esta lista puede ser utilizada en cualquier flujo de trabajo dentro de Nappai para alimentar otros componentes, realizar análisis o generar reportes.

¿Cómo funciona?

El componente acepta exactamente una de tres formas de entrada:

  1. CSV File – Subes un archivo con extensión .csv.
  2. CSV File Path – Escribes la ruta absoluta o relativa a un archivo .csv en tu sistema.
  3. CSV String – Pegas directamente el contenido CSV en un cuadro de texto multilinea.

Internamente, el componente lee el contenido del CSV (ya sea desde el archivo, la ruta o la cadena), lo carga en un pandas.DataFrame y luego convierte cada fila en un objeto Data. Si el CSV está vacío o contiene errores de formato, el componente devuelve un mensaje de estado indicando el problema.

Entradas

CSV File

Upload a CSV file to convert to a list of Data objects
Sube un archivo con extensión .csv que contenga los datos que deseas procesar.

CSV File Path

Provide the path to the CSV file as pure text
Escribe la ruta completa o relativa al archivo .csv que quieres leer.

CSV String

Paste a CSV string directly to convert to a list of Data objects
Pega el contenido CSV directamente en el cuadro de texto para convertirlo en una lista de objetos.

Salidas

Data List
Tipo de datos: Data (método: load_csv_to_data)
Una lista de objetos Data, donde cada objeto representa una fila del CSV. Esta salida puede conectarse a cualquier componente que acepte una lista de datos.

Ejemplo de Uso

  1. Escenario: Tienes un archivo clientes.csv con columnas nombre, email y telefono.
  2. Pasos:
    • Arrastra el componente CSV to Data List al flujo de trabajo.
    • Haz clic en el campo CSV File y selecciona clientes.csv.
    • Ejecuta el flujo.
  3. Resultado: La salida Data List contiene un objeto Data por cada cliente, listo para ser usado por componentes posteriores (por ejemplo, un componente que envíe correos electrónicos a cada cliente).

Componentes Relacionados

  • Data – Representa la estructura básica de un registro dentro de Nappai.
  • Data List to CSV – Convierte una lista de Data de vuelta a un archivo CSV.
  • Filter Data – Permite filtrar la lista de Data según criterios específicos.

Consejos y Mejores Prácticas

  • Verifica la extensión: Asegúrate de que el archivo tenga la extensión .csv para evitar errores de validación.
  • Revisa el delimitador: Si tu CSV usa un delimitador distinto a la coma (por ejemplo, punto y coma), ajusta la configuración de pandas.read_csv en el código si es necesario.
  • Comprueba la integridad: Si el CSV está vacío, el componente mostrará un mensaje de estado; revisa el contenido antes de procesarlo.
  • Evita datos sensibles: No subas archivos que contengan información confidencial sin cifrar o anonimizar.

Consideraciones de Seguridad

  • Acceso a archivos: El componente solo lee archivos que el usuario sube o que especifica explícitamente; no permite rutas arbitrarias que puedan acceder a directorios sensibles del servidor.
  • Validación de entrada: Se comprueba la extensión .csv y se captura cualquier error de análisis para evitar la ejecución de código malicioso dentro del CSV.
  • Manejo de errores: Los errores se reportan claramente en el estado del componente, lo que facilita la depuración sin exponer información interna del sistema.