CSV Parce

Descripción

Este modulo lee un archivo CSV desde el sistema de archivos y lo convierte en un array de objetos JSON. Soporta configuración personalizada de separadores de columnas y filas, codificación del archivo y uso de la primera fila como cabecera. También detecta y parsea automáticamente contenido JSON embebido dentro de celdas CSV. Es ideal para importar datos desde archivos CSV generados por otros sistemas, hojas de calculo o exportaciones de bases de datos.

Configuración

Parámetros

Parámetro	Tipo	Requerido	Descripción
filePath	string	Si	Ruta completa al archivo CSV a leer. Soporta variables dinámicas {{variable}}.
col_separator	string	No	Separador de columnas. Por defecto ,.
row_separator	string	No	Separador de filas. Valores: line break (por defecto), o cualquier caracter personalizado.
codification	string	No	Codificación del archivo. Por defecto utf8.
header_first_row	boolean	No	Si es true, usa la primera fila como nombres de columna. Por defecto false.
col_header	string	No	Títulos personalizados para las columnas.
dataKey	string	No	Si se especifica, el resultado se envuelve en un objeto con esta clave.

Salida

{
  "nextModule": "siguiente_modulo",
  "data": [
    { "nombre": "Juan", "edad": "30", "ciudad": "Madrid" },
    { "nombre": "Ana", "edad": "25", "ciudad": "Barcelona" }
  ],
  "_meta_": {
    "filename": "/ruta/al/archivo.csv",
    "rows": 2
  }
}

Ejemplo de Uso

Caso básico

{
  "filePath": "/data/clientes.csv",
  "col_separator": ",",
  "header_first_row": true,
  "codification": "utf8"
}

Notas

• Soporta variables dinámicas {{variable}} en el parámetro filePath
• Si header_first_row es false, las columnas se nombran como col_1, col_2, etc.
• Detecta y parsea automáticamente objetos JSON embebidos dentro de celdas
• Las comillas dobles y retornos de carro se limpian automáticamente
• Las líneas vacias se ignoran durante el procesamiento

Nodos Relacionados

• csvcreate (operación inversa: JSON a CSV)
• dataTransform (transformar datos después de importar)
• dataMapping (mapear campos del CSV importado)