Excel From Summary

Descripción

Este modulo genera un archivo CSV a partir de un array de resumen (data.summary) que típicamente contiene resultados de procesamiento batch o iteraciones. Cada elemento del summary se aplana extrayendo el índice, 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 (envío por correo, subida FTP, etc.). Es útil para generar reportes de resultados de procesamiento masivo.

Configuración

Parámetro	Tipo	Requerido	Descripción
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 básico

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