Variables que representan nombres de archivos en el servidor y en el ordenador local, fechas y horas

FTPGetter proporciona un conjunto de variables que representan nombres completos de archivos en el servidor SFTP y en el ordenador local, la fecha actual, fechas de modificación de archivos en el servidor SFTP y en el ordenador local, y más. Durante la ejecución de la tarea, estas variables contienen información relacionada con el archivo que se está cargando o descargando actualmente. Estos valores pueden utilizarse como parámetros para ejecutar archivos bat, scripts de PowerShell, scripts shell en el servidor SFTP, enviar notificaciones por correo electrónico y más. A continuación se muestra la lista completa.

%local_file% - se sustituye por una ruta completa que incluye el nombre del archivo en un disco local o de red, por ejemplo C:\my-docs\report.txt

%local_file_path% - se sustituye solo por la ruta sin el nombre del archivo en un disco local o de red, por ejemplo C:\my-docs\

%local_file_name% - se sustituye solo por el nombre del archivo sin la ruta en un disco local o de red, por ejemplo report.txt

%local_file_name_only% - se sustituye solo por el nombre del archivo sin la ruta ni la extensión en un disco local o de red, por ejemplo report

%local_file_name_ext% - se sustituye solo por la extensión del archivo, por ejemplo txt

%remote_file% - se sustituye por una ruta completa que incluye el nombre del archivo disponible remotamente en un servidor de red, por ejemplo /pub/user/file.txt

%remote_file_path% - se sustituye solo por la ruta sin el nombre del archivo disponible remotamente en un servidor de red, por ejemplo /pub/user/

%remote_file_name% - se sustituye solo por el nombre del archivo sin la ruta disponible remotamente en un servidor de red, por ejemplo file.txt

%remote_file_name_only% - se sustituye solo por el nombre del archivo sin la ruta ni la extensión disponible remotamente en un servidor de red, por ejemplo file

%remote_file_name_ext% - se sustituye solo por la extensión del archivo, por ejemplo txt

%c_dd% - se sustituye por el día actual en formato de dos dígitos con cero inicial, de 01 a 31.

%c_mm% - se sustituye por el mes actual con cero inicial, de 01 a 12.

%c_yyyy%, %c_yy% - año actual en formato de 4 o 2 dígitos, por ejemplo 2026 o 26.

%c_hh% - hora actual en formato de 24 horas con cero inicial, de 00 a 23.

%c_min% - minutos actuales con cero inicial, de 00 a 59.

%c_sec% - segundos actuales con cero inicial, de 00 a 59.

%y_dd% - se sustituye por el día de ayer en formato de dos dígitos con cero inicial, de 01 a 31.

%y_mm% - se sustituye por el mes de ayer con cero inicial, de 01 a 12.

%y_yyyy%, %y_yy% - año de ayer en formato de 4 o 2 dígitos, por ejemplo 2025 o 25.

%t_dd% - se sustituye por el día de mañana en formato de dos dígitos con cero inicial, de 01 a 31.

%t_mm% - se sustituye por el mes de mañana con cero inicial, de 01 a 12.

%t_yyyy%, %t_yy% - año de mañana en formato de 4 o 2 dígitos, por ejemplo 2027 o 27.

Ejemplos

Suponiendo que hoy es June 07, 2026, la siguiente ruta de archivo:

/pub/user/reports/%c_yyyy%-%c_mm%-%c_dd%/file.txt

Será sustituida por:

/pub/user/reports/2026-06-07/file.txt

, donde 2026 representa el año, 06 significa June y 07 es el día del mes.

Las variables de sustitución (%c_*****%) pueden utilizarse para especificar rutas de archivos de origen y destino, así como para pasarse como parámetros a aplicaciones externas.

%s_dd% - fecha de modificación del archivo fuente (día): se sustituye por el número del día en formato de dos dígitos con cero inicial, de 01 a 31.

%s_mm% - fecha de modificación del archivo fuente (mes): se sustituye por el número del mes con cero inicial, de 01 a 12.

%s_yyyy%, %s_yy% - fecha de modificación del archivo fuente (año): se sustituye por el año en formato de 4 o 2 dígitos, por ejemplo 2026 o 26.

%s_hh% - hora de modificación del archivo fuente (horas): se sustituye por la hora en formato de 24 horas con cero inicial, de 00 a 23.

%s_min% - hora de modificación del archivo fuente (minutos): se sustituye por los minutos con cero inicial, de 00 a 59.

%s_sec% - hora de modificación del archivo fuente (segundos): se sustituye por los segundos con cero inicial, de 00 a 59.

Ejemplos

El archivo fuente especificado como:

/pub/user/reports/%s_yyyy%-%s_mm%-%s_dd%/file.txt

Será accedido con sustitución de variables mediante la siguiente ruta real:

/pub/user/reports/2026-06-07/file.txt

, donde 2026 representa el año, 06 significa June y 07 es el día del mes en que el archivo fue modificado por última vez.

Las variables que representan la fecha de modificación del archivo fuente (%s_*****%) solo pueden utilizarse para especificar rutas de archivos de destino como parámetros especificados para el programa que se ejecuta después de transferir los archivos.

%remote_host% - se sustituye por el nombre del sitio FTP, por ejemplo ftp.example.com:21

%task_number% - se sustituye por el número de tarea actual.

%action% - se sustituye por la acción realizada, por ejemplo Download o Upload

%result% - se sustituye por el resultado de la acción realizada, por ejemplo Success o Failed

%list% - se sustituye por la lista de archivos transferidos. Disponible únicamente en el cuerpo del correo electrónico cuando se utiliza la opción Send email AFTER all files are transferred.

%list_file_name% - se sustituye por la lista de nombres de archivos transferidos (sin rutas). Disponible únicamente en el cuerpo del correo electrónico cuando se utiliza la opción Send email AFTER all files are transferred.

%files_total% - se sustituye por el número total de archivos procesados.

%files_success% - se sustituye por el número de archivos procesados correctamente.

%files_failed% - se sustituye por el número de archivos procesados con error.