CSV Create

Descripción

Convierte un dataset en un archivo de texto delimitado (CSV, TXT, TSV, DAT) y lo guarda en el servidor con una URL de descarga. Comparte la misma configuración que el nodo CSV Parse para mantener consistencia al leer y escribir archivos.

Configuración

Campo	Tipo	Requerido	Descripción
filePath	text	No	Nombre del archivo (ej: report.csv, export.txt). Si incluye extension se respeta. Default: output
dataKey	text	No	Path al array de datos dentro del input (ej: results.items). Dejar vacío para usar todo el data
fileExtension	select	No	Extension del archivo. Solo se usa si el nombre no incluye una. Opciones: .csv, .txt, .tsv, .dat
col_separator	select	No	Separador de columnas: , (default), ;, Tab, |
row_separator	select	No	Separador de filas: line break (\n, default), crlf (\r\n para Windows)
quote	select	No	Comillas: " (default), ', Sin comillas
header_first_row	select	No	Incluir fila de cabecera con nombres de campos. Default: Si
col_header	text	No	Columnas personalizadas separadas por coma (ej: name,email,phone). Si vacío, exporta todas las keys
codification	select	No	Codificación: utf8 (default), utf8-bom (Excel), ascii, latin1

Campos Compartidos con CSV Parse

Los siguientes campos usan los mismos nombres y valores que el nodo CSV Parse, para facilitar la configuración cuando se lee y escribe el mismo formato:

Campo	CSV Create	CSV Parse
col_separator	Separador de columnas	Separador de columnas
row_separator	Separador de filas	Separador de filas
header_first_row	Incluir cabecera	Primera fila es cabecera
col_header	Columnas a exportar	Nombres de columnas
codification	Codificación de escritura	Codificación de lectura

Comportamiento de la Extension

Nombre Archivo	fileExtension	Resultado
report.csv	(cualquiera)	report-1712345678.csv — la extension del nombre tiene prioridad
export.txt	(cualquiera)	export-1712345678.txt — la extension del nombre tiene prioridad
data	.csv	data-1712345678.csv — usa la extension configurada
output	.txt	output-1712345678.txt — usa la extension configurada

Salida

{
  "filename": "report-1712345678.csv",
  "filePath": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/report-1712345678.csv",
  "urlPath": "https://us1.floogos.com/download/cli_123/report-1712345678.csv"
}

Ejemplos de Uso

CSV estándar

{
  "filePath": "reporte-ventas",
  "dataKey": ""
}

Formato europeo (punto y coma, sin comillas, UTF-8 BOM para Excel)

{
  "filePath": "reporte.csv",
  "col_separator": ";",
  "quote": "none",
  "codification": "utf8-bom"
}

Solo datos, sin cabecera

{
  "filePath": "datos.txt",
  "header_first_row": "false",
  "quote": "none",
  "col_separator": ";"
}

Exportar solo columnas especificas

{
  "filePath": "clientes.csv",
  "col_header": "name,email,phone,city",
  "col_separator": ","
}

Tab-separated con CRLF (Windows)

{
  "filePath": "export.tsv",
  "col_separator": "\t",
  "row_separator": "crlf"
}

Notas

• Extensiones soportadas: .csv, .txt, .tsv, .dat
• Siempre se agrega un timestamp al nombre del archivo para evitar sobreescrituras
• utf8-bom agrega el BOM (Byte Order Mark) para que Excel detecte correctamente UTF-8 y caracteres especiales
• Si el dato de entrada es un objeto único, se envuelve automáticamente en un array
• Los archivos se guardan en temporal/cli_{client_id}/ y se sirven via el endpoint /download/
• La salida incluye _meta_ con información del archivo generado (rows, delimiter, encoding)

Nodos Relacionados

• CsvParse - Parsear un archivo CSV a datos
• SaveToExcel - Exportar datos como Excel (.xlsx)
• Save2Json - Exportar datos como archivo JSON