Variáveis que representam nomes de arquivos no servidor e no computador local, datas e horários

O FTPGetter fornece um conjunto de variáveis que representam nomes completos de arquivos no servidor SFTP e no computador local, data atual, datas de modificação de arquivos no servidor SFTP e no computador local, entre outros. Durante a execução da tarefa, essas variáveis contêm informações relacionadas ao arquivo que está sendo enviado ou baixado no momento. Esses valores podem ser usados como parâmetros para executar arquivos bat, scripts PowerShell, scripts shell no servidor SFTP, enviar notificações por e-mail e muito mais. Abaixo está a lista completa.

%local_file% - substitui pelo caminho completo incluindo o nome do arquivo em um disco local ou de rede, por exemplo C:\my-docs\report.txt

%local_file_path% - substitui apenas pelo caminho sem o nome do arquivo em um disco local ou de rede, por exemplo C:\my-docs\

%local_file_name% - substitui apenas pelo nome do arquivo sem o caminho em um disco local ou de rede, por exemplo report.txt

%local_file_name_only% - substitui apenas pelo nome do arquivo sem o caminho e sem a extensão em um disco local ou de rede, por exemplo report

%local_file_name_ext% - substitui apenas pela extensão do arquivo, por exemplo txt

%remote_file% - substitui pelo caminho completo incluindo o nome do arquivo disponível remotamente em um servidor de rede, por exemplo /pub/user/file.txt

%remote_file_path% - substitui apenas pelo caminho sem o nome do arquivo disponível remotamente em um servidor de rede, por exemplo /pub/user/

%remote_file_name% - substitui apenas pelo nome do arquivo sem o caminho disponível remotamente em um servidor de rede, por exemplo file.txt

%remote_file_name_only% - substitui apenas pelo nome do arquivo sem o caminho e sem a extensão disponível remotamente em um servidor de rede, por exemplo file

%remote_file_name_ext% - substitui apenas pela extensão do arquivo, por exemplo txt

%c_dd% - substitui pelo dia atual em formato de dois dígitos com zero à esquerda, de 01 a 31.

%c_mm% - substitui pelo mês atual com zero à esquerda, de 01 a 12.

%c_yyyy%, %c_yy% - ano atual em formato de 4 dígitos ou 2 dígitos, por exemplo 2026 ou 26.

%c_hh% - hora atual em formato de 24 horas com zero à esquerda, de 00 a 23.

%c_min% - minutos atuais com zero à esquerda, de 00 a 59.

%c_sec% - segundos atuais com zero à esquerda, de 00 a 59.

%y_dd% - substitui pelo dia de ontem em formato de dois dígitos com zero à esquerda, de 01 a 31.

%y_mm% - substitui pelo mês de ontem com zero à esquerda, de 01 a 12.

%y_yyyy%, %y_yy% - ano de ontem em formato de 4 dígitos ou 2 dígitos, por exemplo 2025 ou 25.

%t_dd% - substitui pelo dia de amanhã em formato de dois dígitos com zero à esquerda, de 01 a 31.

%t_mm% - substitui pelo mês de amanhã com zero à esquerda, de 01 a 12.

%t_yyyy%, %t_yy% - ano de amanhã em formato de 4 dígitos ou 2 dígitos, por exemplo 2027 ou 27.

Exemplos

Supondo que hoje seja June 07, 2026, o seguinte caminho de arquivo:

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

Será substituído por:

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

, onde 2026 representa o ano, 06 significa June e 07 representa o dia do mês.

As variáveis de substituição (%c_*****%) podem ser usadas para especificar caminhos para arquivos de origem e destino, bem como serem passadas como parâmetros para aplicações externas.

%s_dd% - data de modificação do arquivo de origem (dia): substitui pelo número do dia em formato de dois dígitos com zero à esquerda, de 01 a 31.

%s_mm% - data de modificação do arquivo de origem (mês): substitui pelo número do mês com zero à esquerda, de 01 a 12.

%s_yyyy%, %s_yy% - data de modificação do arquivo de origem (ano): substitui pelo ano em formato de 4 dígitos ou 2 dígitos, por exemplo 2026 ou 26.

%s_hh% - hora de modificação do arquivo de origem (horas): substitui pela hora em formato de 24 horas com zero à esquerda, de 00 a 23.

%s_min% - hora de modificação do arquivo de origem (minutos): substitui pelos minutos com zero à esquerda, de 00 a 59.

%s_sec% - hora de modificação do arquivo de origem (segundos): substitui pelos segundos com zero à esquerda, de 00 a 59.

Exemplos

O arquivo de origem especificado como:

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

Será acessado com substituição de variáveis pelo seguinte caminho real:

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

, onde 2026 representa o ano, 06 significa June e 07 representa o dia do mês em que o arquivo foi modificado pela última vez.

As variáveis que representam a data de modificação do arquivo de origem (%s_*****%) só podem ser usadas para especificar caminhos para arquivos de destino como parâmetros passados ao programa executado após a transferência dos arquivos.

%remote_host% - substitui pelo nome do site FTP, por exemplo ftp.example.com:21

%task_number% - substitui pelo número da tarefa atual.

%action% - substitui pela ação executada, por exemplo Download ou Upload

%result% - substitui pelo resultado da ação executada, por exemplo Success ou Failed

%list% - substitui pela lista de arquivos transferidos. Disponível apenas no corpo do e-mail quando a opção Send email AFTER all files are transferred é usada.

%list_file_name% - substitui pela lista de nomes de arquivos transferidos (sem caminhos). Disponível apenas no corpo do e-mail quando a opção Send email AFTER all files are transferred é usada.

%files_total% - substitui pelo número total de arquivos processados.

%files_success% - substitui pelo número de arquivos processados com sucesso.

%files_failed% - substitui pelo número de arquivos processados com falha.