ZIP Extract

Descripcion

Extrae el contenido de un archivo ZIP en una carpeta temporal del servidor. Retorna un array con la informacion completa de cada fichero extraido (ruta, URL de descarga, extension, tamaño). Compatible con la salida de ZIP Create, HTTP downloads o cualquier nodo que genere un archivo ZIP.

Configuracion

Campo	Tipo	Requerido	Descripcion
zipPath	text	No	Ruta al archivo ZIP. Si vacio, usa data.filePath del nodo anterior
outputFolder	text	No	Nombre de la subcarpeta de extraccion. Si vacio, genera nombre unico automatico
filterExtensions	text	No	Solo extraer ficheros con estas extensiones separadas por coma (ej: .csv,.txt). Si vacio, extrae todo

Salida

{
  "files": [
    {
      "filename": "reporte.csv",
      "filePath": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/unzip-1712345678/reporte.csv",
      "urlPath": "https://us1.floogos.com/download/cli_123/unzip-1712345678/reporte.csv",
      "relativePath": "reporte.csv",
      "extension": ".csv",
      "size_bytes": 15230
    },
    {
      "filename": "datos.json",
      "filePath": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/unzip-1712345678/datos.json",
      "urlPath": "https://us1.floogos.com/download/cli_123/unzip-1712345678/datos.json",
      "relativePath": "datos.json",
      "extension": ".json",
      "size_bytes": 8420
    }
  ],
  "total_extracted": 2,
  "total_skipped": 0,
  "output_dir": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/unzip-1712345678",
  "source_zip": "/www/wwwroot/floogos/engine_us1/temporal/cli_123/archive-1712345678.zip"
}

Ejemplos de Uso

Extraer ZIP del nodo anterior

ZIP Create → ZIP Extract

{
  "outputFolder": "mis-ficheros"
}

Extraer solo CSV y TXT de un ZIP

{
  "zipPath": "{{filePath}}",
  "filterExtensions": ".csv,.txt",
  "outputFolder": "datos-importados"
}

Extraer y procesar cada fichero

HTTP Request (download ZIP) → ZIP Extract → Iterator (files) → CSV Parse

Notas

• Los directorios del ZIP se preservan como subcarpetas dentro de la carpeta de extraccion
• Los nombres de fichero se sanitizan para prevenir path traversal (../)
• Si filterExtensions esta configurado, los ficheros que no coincidan se reportan en total_skipped
• Cada fichero extraido tiene su propia urlPath para descarga directa
• El campo relativePath conserva la estructura de carpetas original del ZIP
• Los ficheros se guardan en temporal/cli_{client_id}/ del servidor

Nodos Relacionados

• ZIP Create - Comprimir ficheros en ZIP
• CSV Parse - Parsear un CSV extraido
• CSV Create - Crear archivo CSV/TXT