Variablen zur Darstellung von Dateinamen auf dem Server und auf dem lokalen Computer, Datums- und Zeitwerten

FTPGetter stellt eine Reihe von Variablen bereit, die vollständige Dateinamen auf dem SFTP-Server und dem lokalen Computer, das aktuelle Datum, Änderungsdaten von Dateien auf dem SFTP-Server und dem lokalen Computer sowie weitere Informationen repräsentieren. Während der Aufgabenausführung enthalten diese Variablen Informationen über die Datei, die aktuell hoch- oder heruntergeladen wird. Diese Werte können als Parameter zum Ausführen von Bat-Dateien, PowerShell-Skripten, Shell-Skripten auf dem SFTP-Server, zum Versenden von E-Mail-Benachrichtigungen und mehr verwendet werden. Nachfolgend finden Sie die vollständige Liste.

%local_file% - wird durch einen vollständigen Pfad einschließlich Dateiname zu einer Datei auf einem lokalen oder Netzlaufwerk ersetzt, z. B. C:\my-docs\report.txt

%local_file_path% - wird nur durch den Pfad ohne Dateinamen zu einer Datei auf einem lokalen oder Netzlaufwerk ersetzt, z. B. C:\my-docs\

%local_file_name% - wird nur durch den Dateinamen ohne Pfad zu einer Datei auf einem lokalen oder Netzlaufwerk ersetzt, z. B. report.txt

%local_file_name_only% - wird nur durch den Dateinamen ohne Pfad und ohne Dateierweiterung ersetzt, z. B. report

%local_file_name_ext% - wird nur durch die Dateierweiterung ersetzt, z. B. txt

%remote_file% - wird durch einen vollständigen Pfad einschließlich Dateiname zu einer Datei ersetzt, die remote auf einem Netzwerkserver verfügbar ist, z. B. /pub/user/file.txt

%remote_file_path% - wird nur durch den Pfad ohne Dateinamen zu einer Datei ersetzt, die remote auf einem Netzwerkserver verfügbar ist, z. B. /pub/user/

%remote_file_name% - wird nur durch den Dateinamen ohne Pfad zu einer Datei ersetzt, die remote auf einem Netzwerkserver verfügbar ist, z. B. file.txt

%remote_file_name_only% - wird nur durch den Dateinamen ohne Pfad und ohne Dateierweiterung zu einer Datei ersetzt, die remote auf einem Netzwerkserver verfügbar ist, z. B. file

%remote_file_name_ext% - wird nur durch die Dateierweiterung ersetzt, z. B. txt

%c_dd% - wird durch den aktuellen Tag im zweistelligen Format mit führender Null ersetzt, 01 bis 31.

%c_mm% - wird durch den aktuellen Monat mit führender Null ersetzt, 01 bis 12.

%c_yyyy%, %c_yy% - aktuelles Jahr im 4-stelligen oder 2-stelligen Format, z. B. 2026 oder 26.

%c_hh% - aktuelle Uhrzeit (Stunden) im 24-Stunden-Format mit führender Null, 00 bis 23.

%c_min% - aktuelle Uhrzeit (Minuten) mit führender Null, 00 bis 59.

%c_sec% - aktuelle Uhrzeit (Sekunden) mit führender Null, 00 bis 59.

%y_dd% - wird durch den gestrigen Tag im zweistelligen Format mit führender Null ersetzt, 01 bis 31.

%y_mm% - wird durch den gestrigen Monat mit führender Null ersetzt, 01 bis 12.

%y_yyyy%, %y_yy% - gestriges Jahr im 4-stelligen oder 2-stelligen Format, z. B. 2025 oder 25.

%t_dd% - wird durch den morgigen Tag im zweistelligen Format mit führender Null ersetzt, 01 bis 31.

%t_mm% - wird durch den morgigen Monat mit führender Null ersetzt, 01 bis 12.

%t_yyyy%, %t_yy% - morgiges Jahr im 4-stelligen oder 2-stelligen Format, z. B. 2027 oder 27.

Beispiele

Angenommen, heute ist der 27. June 2026, dann wird der folgende Dateipfad:

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

Ersetzt durch:

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

, wobei 2026 das Jahr repräsentiert, 06 den Monat June bedeutet und 27 den Tag des Monats darstellt.

Die Ersetzungsvariablen (%c_*****%) können verwendet werden, um Pfade zu Quell- und Zieldateien anzugeben sowie als Parameter an externe Anwendungen übergeben zu werden.

%s_dd% - Änderungsdatum der Quelldatei (Tag): wird durch die Tagesnummer im zweistelligen Format mit führender Null ersetzt, 01 bis 31.

%s_mm% - Änderungsdatum der Quelldatei (Monat): wird durch die Monatsnummer mit führender Null ersetzt, 01 bis 12.

%s_yyyy%, %s_yy% - Änderungsdatum der Quelldatei (Jahr): wird durch das Jahr im 4-stelligen oder 2-stelligen Format ersetzt, z. B. 2026 oder 26.

%s_hh% - Änderungszeit der Quelldatei (Stunden): wird durch die Stunde im 24-Stunden-Format mit führender Null ersetzt, 00 bis 23.

%s_min% - Änderungszeit der Quelldatei (Minuten): wird durch die Minute mit führender Null ersetzt, 00 bis 59.

%s_sec% - Änderungszeit der Quelldatei (Sekunden): wird durch die Sekunde mit führender Null ersetzt, 00 bis 59.

Beispiele

Die Quelldatei, angegeben als:

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

Wird nach der Variablensubstitution mit folgendem realen Pfad verwendet:

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

, wobei 2026 das Jahr repräsentiert, 06 den Monat June bedeutet und 27 den Tag des Monats darstellt, an dem die Datei zuletzt geändert wurde.

Die Variablen, die das Änderungsdatum der Quelldatei repräsentieren (%s_*****%), können nur verwendet werden, um Pfade zu Zieldateien anzugeben oder als Parameter für Programme, die nach der Dateiübertragung gestartet werden.

%remote_host% - wird durch den Namen der FTP-Site ersetzt, z. B. ftp.example.com:21

%task_number% - wird durch die aktuelle Aufgabennummer ersetzt.

%action% - wird durch die ausgeführte Aktion ersetzt, z. B. Download oder Upload

%result% - wird durch das Ergebnis der ausgeführten Aktion ersetzt, z. B. Success oder Failed

%list% - wird durch die Liste der übertragenen Dateien ersetzt. Nur im E-Mail-Text verfügbar, wenn die Option Send email AFTER all files are transferred verwendet wird.

%list_file_name% - wird durch die Liste der übertragenen Dateinamen (ohne Pfade) ersetzt. Nur im E-Mail-Text verfügbar, wenn die Option Send email AFTER all files are transferred verwendet wird.

%files_total% - wird durch die Gesamtanzahl der verarbeiteten Dateien ersetzt.

%files_success% - wird durch die Anzahl der erfolgreich verarbeiteten Dateien ersetzt.

%files_failed% - wird durch die Anzahl der fehlgeschlagenen verarbeiteten Dateien ersetzt.