File Rename

Descripción

Renombra uno o varios ficheros generados por nodos anteriores (CSV Create, Save to Excel, ZIP Create, etc). Soporta renombrado individual o en lote con contador automático, variables dinámicas y control de extension.

Configuración

Campo	Tipo	Requerido	Descripción
files	textarea	No	Ruta(s) a los ficheros. Si vacío, usa data.filePath del nodo anterior
namePattern	text	Si	Patron para el nuevo nombre. Variables: {{filename}}, {{counter}}, {{index}}, {{total}}, {{campo}}
counterStart	text	No	Número inicial del contador. Default: 1
counterPad	select	No	Digitos del contador: 1, 2, 3, 4 o 5. Default: 3 (001, 002…)
keepExtension	select	No	Mantener extension original. Default: Si
newExtension	text	No	Nueva extension (solo si keepExtension=No)

Variables del Patron

Variable	Descripción	Ejemplo
{{filename}}	Nombre original sin extension	report-1712345678
{{counter}}	Contador con padding (001, 002…)	001
{{index}}	Índice base 0 (0, 1, 2…)	0
{{total}}	Total de ficheros	5
{{campo}}	Cualquier campo del data	{{order_number}}

Salida

Un solo fichero

{
  "filename": "dat-001.csv",
  "filePath": "/temporal/cli_123/dat-001.csv",
  "urlPath": "https://us1.floogos.com/download/cli_123/dat-001.csv",
  "original": "report-1712345678.csv"
}

Múltiples ficheros

{
  "files": [
    { "original": "file1.csv", "renamed": "dat-001.csv", "filePath": "...", "urlPath": "...", "counter": "001", "index": 0 },
    { "original": "file2.csv", "renamed": "dat-002.csv", "filePath": "...", "urlPath": "...", "counter": "002", "index": 1 }
  ],
  "total_renamed": 2,
  "total_errors": 0
}

Ejemplos de Uso

Renombrar con contador secuencial

Iterator (genera archivos) → File Rename

{
  "namePattern": "DTO-{{counter}}",
  "counterStart": "61",
  "counterPad": "5"
}

Resultado: DTO-00061.csv, DTO-00062.csv, DTO-00063.csv

Renombrar con datos del flujo

{
  "namePattern": "{{order_number}}-factura",
  "keepExtension": "true"
}

Resultado: PT14684-factura.pdf

Renombrar y cambiar extension

{
  "namePattern": "export-{{counter}}",
  "keepExtension": "false",
  "newExtension": ".txt"
}

Resultado: export-001.txt, export-002.txt

Renombrar salida de CSV Create

CSV Create → File Rename

{
  "namePattern": "reporte-ventas-{{$datetime}}"
}

Notas

• Mantiene la extension original por defecto (.csv, .xlsx, .pdf, etc)
• Caracteres no validos en nombres (< > : " / \ | ? *) se reemplazan por _
• Si un fichero no existe, se reporta en errors pero no detiene el proceso
• Un solo fichero retorna formato plano { filename, filePath, urlPath } compatible con otros nodos
• El contador se reinicia en cada ejecución del nodo (no es persistente entre ejecuciones)

Nodos Relacionados

• CSV Create - Crear archivos CSV/TXT
• ZIP Create - Comprimir ficheros
• SaveToExcel - Crear archivos Excel