Excel From Summary

Descripcion

Este modulo genera un archivo CSV a partir de un array de resumen (data.summary) que tipicamente contiene resultados de procesamiento batch o iteraciones. Cada elemento del summary se aplana extrayendo el indice, estado y los campos del registro. Los campos anidados del registro se serializan como JSON string. El archivo resultante se guarda en la carpeta temporal del servidor y queda disponible para uso posterior en el workflow (envio por correo, subida FTP, etc.). Es util para generar reportes de resultados de procesamiento masivo.

Configuracion

Parametro	Tipo	Requerido	Descripcion
credentials_id	string	No	ID de credenciales (reservado para uso futuro).
protocol	string	No	Protocolo (reservado para uso futuro). Por defecto sftp.
localPath	string	No	Ruta local (reservado para uso futuro).
remotePath	string	No	Ruta remota (reservado para uso futuro). Por defecto /.

Salida

{
  "nextModule": "siguiente_modulo",
  "data": {
    "summary": [ "..." ],
    "excel": {
      "filename": "summary_1711234567890.csv",
      "path": "/ruta/temporal/summary_1711234567890.csv"
    }
  }
}

Ejemplo de Uso

Caso basico

Los datos de entrada deben contener un array summary:

{
  "summary": [
    { "index": 0, "status": "success", "record": { "id": 1, "name": "Item A" } },
    { "index": 1, "status": "error", "record": { "id": 2, "name": "Item B" } }
  ]
}

Notas

• Requiere que data.summary sea un array, de lo contrario retorna error
• Cada registro se aplana con prefijo record. para los campos del registro
• Los objetos anidados dentro del registro se serializan a JSON string
• El archivo se guarda en la carpeta temporal/ del proceso actual
• El nombre del archivo incluye un timestamp para evitar colisiones
• Utiliza la libreria json2csv para generar el CSV
• Los datos originales se preservan en la salida junto con la referencia al archivo generado

Nodos Relacionados

• CSV Create - Crear CSV desde cualquier dataset
• Iterador - Generar el summary procesando registros
• File Transfers - Subir el archivo generado a FTP/SFTP