Data to CSV

El componente Data to CSV convierte una lista de objetos de datos (Data) en un archivo CSV. Puedes elegir el nombre del archivo, el separador de campos y de filas, y decidir si los campos con caracteres especiales deben ir entre comillas. El resultado se entrega como texto CSV y también como un objeto Data que representa el archivo listo para usar en tu flujo de trabajo.

¿Cómo funciona?

El componente procesa los datos localmente, sin llamar a servicios externos.

1. Recopila los datos: Extrae todas las claves únicas de cada objeto Data y las ordena alfabéticamente.
2. Construye la cabecera: Escribe las claves como encabezados de columna.
3. Añade las filas: Por cada objeto Data, coloca los valores correspondientes a las claves ordenadas, dejando campos vacíos cuando una clave no existe en ese objeto.
4. Aplica la configuración: Usa el separador de campos y de filas que hayas indicado, y decide si se deben comillas los campos con caracteres especiales.
5. Genera dos salidas:
   • CSV Text: El texto completo del CSV.
   • File Data: Un objeto Data que contiene el CSV como archivo, con metadatos (nombre, codificación, tipo MIME).

Entradas

• File Content: Contenido de los datos que se convertirán en CSV.
• Field Separator: Separador que se usará entre columnas (por defecto ,).
• File Name: Nombre que tendrá el archivo CSV generado (por defecto data.csv).
• Quoting: Indica si se deben colocar comillas alrededor de los campos que contengan caracteres especiales.
• Row Separator: Separador que se usará entre filas (por defecto \n).

Salidas

• File Data: Objeto Data que representa el archivo CSV creado.
• CSV Text: Texto plano del CSV, útil para visualizar o copiar directamente.

Ejemplo de Uso

1. Preparar los datos
   Conecta un componente que genere una lista de objetos Data (por ejemplo, un “Data Loader” que lea registros de una base de datos).
2. Configurar el CSV
   • Deja el File Name como clientes.csv.
   • Cambia el Field Separator a ; si tu sistema usa punto y coma.
   • Activa Quoting si esperas comas dentro de los campos.
3. Ejecutar
   Al ejecutar el flujo, obtendrás dos salidas:
   • El texto CSV en CSV Text (puedes verlo en un panel de vista previa).
   • El archivo CSV en File Data, que puedes usar en un componente de “Upload File” o guardarlo en un almacenamiento externo.

Componentes Relacionados

• Data Loader – Obtiene datos de fuentes externas y los convierte en objetos Data.
• CsvReader – Lee archivos CSV y los convierte de nuevo en objetos Data.
• File Uploader – Sube archivos generados (como el CSV) a un servicio de almacenamiento.

Consejos y Mejores Prácticas

• Verifica los separadores: Si tus datos contienen comas, usa un separador diferente o activa la opción de comillas.
• Mantén la consistencia de claves: Asegúrate de que los objetos Data tengan las mismas claves para evitar columnas vacías inesperadas.
• Revisa el tamaño del CSV: Para grandes volúmenes, considera dividir el archivo en partes para evitar tiempos de procesamiento largos.
• Usa el campo “File Name” para nombrar archivos de manera descriptiva (ej. ventas_2025-01.csv).

Consideraciones de Seguridad

• El componente trabaja únicamente con datos que ya están en tu entorno; no envía información fuera de la plataforma.
• Si los datos contienen información sensible, asegúrate de que el flujo esté protegido con los permisos adecuados y que el archivo CSV no se comparta accidentalmente.
• Evita exponer el CSV en paneles públicos; utiliza controles de acceso para limitar quién puede ver o descargar el archivo.