SFTP サーバー上およびローカルコンピューター上のファイル名、日付、時刻を表す変数

FTPGetter には、SFTP サーバーおよびローカルコンピューター上の完全なファイル名、現在の日付、SFTP サーバーおよびローカルコンピューター上のファイル更新日時などを表す一連の変数が用意されています。タスク実行中、これらの変数には現在アップロードまたはダウンロード中のファイルに関連する情報が格納されます。これらの値は、bat ファイル、PowerShell スクリプト、SFTP サーバー上のシェルスクリプトの実行パラメータ、メール通知送信などに利用できます。以下はその一覧です。

%local_file% - ローカルまたはネットワークドライブ上のファイルへの完全パス（ファイル名を含む）に置換されます。例: C:\my-docs\report.txt

%local_file_path% - ローカルまたはネットワークドライブ上のファイルへのパスのみ（ファイル名を除く）に置換されます。例: C:\my-docs\

%local_file_name% - ローカルまたはネットワークドライブ上のファイル名のみ（パスなし）に置換されます。例: report.txt

%local_file_name_only% - ローカルまたはネットワークドライブ上のファイル名のみ（パスおよび拡張子なし）に置換されます。例: report

%local_file_name_ext% - ファイル拡張子のみに置換されます。例: txt

%remote_file% - ネットワークサーバー上で利用可能なファイルへの完全パス（ファイル名を含む）に置換されます。例: /pub/user/file.txt

%remote_file_path% - ネットワークサーバー上のファイルへのパスのみ（ファイル名を除く）に置換されます。例: /pub/user/

%remote_file_name% - ネットワークサーバー上のファイル名のみ（パスなし）に置換されます。例: file.txt

%remote_file_name_only% - ネットワークサーバー上のファイル名のみ（パスおよび拡張子なし）に置換されます。例: file

%remote_file_name_ext% - ファイル拡張子のみに置換されます。例: txt

%c_dd% - 現在の日付（日）を 2 桁形式（先頭ゼロ付き、01 ～ 31）で置換します。

%c_mm% - 現在の月を 2 桁形式（先頭ゼロ付き、01 ～ 12）で置換します。

%c_yyyy%, %c_yy% - 現在の年を 4 桁または 2 桁形式で置換します。例: 2026 または 26。

%c_hh% - 現在時刻（時）を 24 時間形式（先頭ゼロ付き、00 ～ 23）で置換します。

%c_min% - 現在時刻（分）を先頭ゼロ付き（00 ～ 59）で置換します。

%c_sec% - 現在時刻（秒）を先頭ゼロ付き（00 ～ 59）で置換します。

%y_dd% - 昨日の日付（日）を 2 桁形式（先頭ゼロ付き、01 ～ 31）で置換します。

%y_mm% - 昨日の月を 2 桁形式（先頭ゼロ付き、01 ～ 12）で置換します。

%y_yyyy%, %y_yy% - 昨年を 4 桁または 2 桁形式で置換します。例: 2025 または 25。

%t_dd% - 明日の日付（日）を 2 桁形式（先頭ゼロ付き、01 ～ 31）で置換します。

%t_mm% - 明日の月を 2 桁形式（先頭ゼロ付き、01 ～ 12）で置換します。

%t_yyyy%, %t_yy% - 明年を 4 桁または 2 桁形式で置換します。例: 2027 または 27。

例

今日が May 15, 2026 の場合、以下のファイルパス:

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

は次のように置換されます:

/pub/user/reports/2026-05-15/file.txt

。ここで 2026 は年、05 は May、15 は日付を表します。

置換変数 (%c_*****%) は、ソースおよび宛先ファイルのパス指定や、外部アプリケーションへ渡すパラメータとして使用できます。

%s_dd% - ソースファイル更新日（日）: 2 桁形式（先頭ゼロ付き、01 ～ 31）の日付に置換されます。

%s_mm% - ソースファイル更新日（月）: 2 桁形式（先頭ゼロ付き、01 ～ 12）の月番号に置換されます。

%s_yyyy%, %s_yy% - ソースファイル更新日（年）: 4 桁または 2 桁形式の年に置換されます。例: 2026 または 26。

%s_hh% - ソースファイル更新時刻（時）: 24 時間形式（先頭ゼロ付き、00 ～ 23）の時刻に置換されます。

%s_min% - ソースファイル更新時刻（分）: 先頭ゼロ付き（00 ～ 59）の分に置換されます。

%s_sec% - ソースファイル更新時刻（秒）: 先頭ゼロ付き（00 ～ 59）の秒に置換されます。

例

以下のように指定されたソースファイル:

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

は、変数置換後に次の実際のパスとしてアクセスされます:

/pub/user/reports/2026-05-15/file.txt

。ここで 2026 は年、05 は May、15 はファイル最終更新日の日付を表します。

ソースファイル更新日時を表す変数 (%s_*****%) は、宛先ファイルパス指定や、ファイル転送後に起動されるプログラムへのパラメータとしてのみ使用できます。

%remote_host% - FTP サイト名に置換されます。例: ftp.example.com:21

%task_number% - 現在の タスク番号 に置換されます。

%action% - 実行された操作に置換されます。例: Download または Upload

%result% - 実行結果に置換されます。例: Success または Failed

%list% - 転送されたファイル一覧に置換されます。すべてのファイル転送後にメール送信 オプション使用時のみ、メール本文内で利用可能です。

%list_file_name% - 転送されたファイル名一覧（パスなし）に置換されます。すべてのファイル転送後にメール送信 オプション使用時のみ、メール本文内で利用可能です。

%files_total% - 処理されたファイルの 総数 に置換されます。

%files_success% - 正常に処理されたファイル数に置換されます。

%files_failed% - 処理失敗したファイル数に置換されます。