FTP

FTP アクション グループを使用して、ファイルをアップロードおよびダウンロードし、FTP サーバー上のディレクトリを操作します。

FTP 接続を確立するには、FTP 接続を開く アクションを使用します。 次の例では、ホスト、ポート、資格情報が指定されています。 さらに、設定されたタイムアウトにより、接続が時間どおりに確立されない場合、アクションは失敗します。

FTP からファイルをダウンロード アクションを使用してファイルをダウンロードします。 次の例は、使用中の接続変数と選択された保存先フォルダーを示しています。 リモート ファイルも指定され、同じ場所にある既存のファイルを上書きするように設定されています。

ファイルとリモートの場所を指定して、ファイルを FTP にアップロード アクションを使用し、ファイルをアップロードします。

FTP 接続を開く

このアクションを実行すると、リモート FTP サーバーへの特定の接続が確立され、後で使用できるようにその接続が変数として保存されます。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Host	いいえ	テキスト値		ここに FTP サーバーのアドレスを入力します。
Port	はい	数値	21	ここに FTP サーバーのポートを入力します。
Active mode	N/A	ブール値	無効	接続のモードを指定
Username	いいえ	テキスト値		使用する FTP アカウントのユーザー名を指定
パスワード	はい	直接暗号化された入力またはテキスト値		使用する FTP アカウントのパスワードを指定
タイムアウト	はい	数値	10	接続の確立を待機する時間 (秒) を設定します。この時間内に接続が確立されない場合には、アクションは失敗します

生成された変数

引数	タイプ	説明設定
FTPConnection	FTP 接続	FTP 接続

例外

例外	内容
ログイン失敗エラー	ログインが失敗したことを示します
つながりエラー	接続に問題があることを示します

FTP ディレクトリの一覧表示

このアクションを実行すると、FTP 接続の現在のディレクトリに含まれるサブディレクトリとファイルが返されます。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Connection	いいえ	FTP 接続		FTP 接続
Path	はい	Text 値		一覧表示するパス。

生成された変数

引数	タイプ	説明設定
Directories	FTP ディレクトリ のリスト	一覧表示されたディレクトリ
ファイル	FTP ファイル のリスト	一覧表示されたファイル

例外

例外	説明設定
一覧表示エラー	フォルダーの一覧表示を実行できなかったことを示します
未接続エラー	FTP サーバーの開いている接続がないことを示します
「ディレクトリが存在しません」エラー	ディレクトリが見つからなかったことを示します

Secure FTP 接続を開く

このアクションを実行すると、リモート FTP サーバーへのセキュリティで保護された特定の接続が確立され、後で使用できるようにその接続が変数として保存されます。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Host	いいえ	テキスト値		ここに FTP サーバーのアドレスを入力します。
Port	はい	数値	22	ここに FTP サーバーのポートを入力します。
Active mode	N/A	ブール値	有効	接続のモードを指定
Secure FTP Protocol	N/A	SFTP、明示的 FTPS、暗黙的 FTPS	SFTP	接続の暗号化に使う FTP プロトコルを選択
Authentication method	N/A	ユーザー名とパスワード、秘密キー、秘密キーとパスフレーズ	ユーザー名とパスワード	FTP サーバーで自分自身を認証するために使う方法を選択
User name	いいえ	テキスト値		使用する FTP アカウントのユーザー名を指定
パスワード	はい	直接暗号化された入力またはテキスト値		使用する FTP アカウントのパスワードを指定
Path to private key	いいえ	テキスト値		認証に使う秘密キーへのファイル パスを入力
秘密キーのパス フレーズ	はい	直接暗号化された入力またはテキスト値		ここに秘密キーのパスフレーズを含む変数を入力
Timeout	はい	数値	10	接続の確立を待機する時間 (秒) を設定します。この時間内に接続が確立されない場合には、アクションは失敗します

生成された変数

引数	タイプ	説明設定
SftpConnection	FTP 接続	SFTP 接続

例外

例外	内容
ログイン失敗エラー	ログインが失敗したことを示します
つながりエラー	接続に問題があることを示します

接続を閉じる

このアクションを実行すると、開いている FTP 接続が閉じられます。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
接続	いいえ	FTP 接続		FTP 接続

生成された変数

このアクションは変数を生成しません。

例外

例外	Description
未接続エラー	FTP サーバーの開いている接続がないことを示します

作業ディレクトリの変更

このアクションを実行すると、FTP 接続用の現在の作業ディレクトリが設定されます。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
Connection	いいえ	FTP 接続		FTP 接続
Set working directory to	いいえ	Text 値		作業ディレクトリとして設定するパスを設定します

生成された変数

このアクションは変数を生成しません。

例外

例外	Description
未接続エラー	FTP サーバーの開いている接続がないことを示します
「ディレクトリが存在しません」エラー	ディレクトリが見つからなかったことを示します
作業ディレクトリの変更不可エラー	作業ディレクトリを変更できないことを示します

FTP からファイルをダウンロード

1 つまたは複数のファイルを FTP サーバーからダウンロードします。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
FTP connection	いいえ	FTP 接続		作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
Download into folder	いいえ	フォルダー		ダウンロードするファイルの保存先となるフォルダー
ダウンロードするファイル	いいえ	FTP ファイル のリスト		ダウンロードするファイル
転送の種類	N/A	自動、バイナリ、ASCII	自動	ASCII またはバイナリを入力して、単一のファイルをダウンロードする方法を指定します。 ファイルの種類が不明な場合、または複数のファイルがダウンロードされる場合は、自動を選択してオプションで指定された転送ルールに従います
If file exists	N/A	上書き、ダウンロードしない、一意の名前でダウンロードする	上書きする	ファイルが既に存在する場合の処理を指定します。 [上書きする] は、元のファイルに上書きするため、それ以降アクセスできなくなります。一意の名前でダウンロードするは、末尾にアンダースコアと連番を追加します

生成された変数

このアクションは変数を生成しません。

例外

例外	Description
未接続エラー	FTP サーバーの開いている接続がないことを示します
「リモート ファイルが存在しません」エラー	ファイルが FTP サーバー上に存在しないことを示します
「ディレクトリが存在しません」エラー	ディレクトリが見つからなかったことを示します
FTP 接続の中止エラー	FTP 接続が中止されたことを示します
ファイルのダウンロード不可エラー	ファイルをダウンロードできなかったことを示します

FTP からフォルダーをダウンロード

1 つまたは複数のフォルダーを FTP サーバーからダウンロードします。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
FTP connection	いいえ	FTP 接続		作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
Folder(s) to download	いいえ	FTP ディレクトリ のリスト		ダウンロードするフォルダーのパスまたは FTP フォルダーの名前
Download into local folder	いいえ	フォルダー		ダウンロードしようとしている FTP フォルダーの保存先の完全なパス

生成された変数

このアクションは変数を生成しません。

例外

例外	Description
未接続エラー	FTP サーバーの開いている接続がないことを示します
「リモート ディレクトリが存在しません」エラー	ディレクトリが FTP サーバー上に存在しないことを示します
「ディレクトリが存在しません」エラー	ディレクトリが見つからなかったことを示します
FTP 接続の中止エラー	FTP 接続が中止されたことを示します
ディレクトリのダウンロード不可エラー	ディレクトリをダウンロードできなかったことを示します

ファイルを FTP にアップロード

1 つまたは複数のファイルを FTP サーバーにアップロードします。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
FTP connection	いいえ	FTP 接続		作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
File(s) to upload	いいえ	ファイル の リスト		アップロードするファイル
Remote location	はい	テキスト値		ファイルをアップロードする場所です
Transfer type	N/A	自動、バイナリ、ASCII	自動	ASCII またはバイナリを入力して、単一のファイルをダウンロードする方法を指定します。 ファイルの種類がわからない場合、または複数のファイルをダウンロードする場合は、[自動] を選択して、オプションで指定された転送ルールに従います
If file exists	N/A	上書き、ダウンロードしない、一意の名前でダウンロードする	上書きする	ファイルが既に存在する場合の処理を指定します。 [上書きする] は、元のファイルに上書きするため、それ以降アクセスできなくなります。[一意の名前でダウンロードする] は、末尾にアンダースコアと連番を追加します

生成された変数

このアクションは変数を生成しません。

例外

例外	Description
未接続エラー	FTP サーバーの開いている接続がないことを示します
「ファイルが見つかりませんでした」エラー	ファイルが見つからなかったことを示します
FTP 接続の中止エラー	FTP 接続が中止されたことを示します
ファイルのアップロード エラー	ファイルをアップロードできなかったことを示します

フォルダーを FTP にアップロード

1 つまたは複数のフォルダーを FTP サーバーにアップロードします。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
FTP connection	いいえ	FTP 接続		作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
Folder(s) to upload	いいえ	フォルダー のリスト		アップロードするフォルダーです。 アップロードするフォルダーは、FTP サーバーのアクティブなディレクトリ内に既に存在していてはなりません
Remote location	いいえ	テキスト値		フォルダーをアップロードする場所

生成された変数

このアクションは変数を生成しません。

例外

例外	Description
未接続エラー	FTP サーバーの開いている接続がないことを示します
「リモート ディレクトリが存在しません」エラー	ディレクトリが FTP サーバー上に存在しないことを示します
FTP 接続の中止エラー	FTP 接続が中止されたことを示します
ディレクトリのアップロード エラー	ディレクトリをアップロードできなかったことを示します

FTP ファイルを削除

1 つまたは複数のファイルを FTP サーバーから削除します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
FTP connection	いいえ	FTP 接続		作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
削除するファイル	いいえ	FTP ファイル のリスト		削除するファイル

生成された変数

このアクションは変数を生成しません。

例外

例外	Description
未接続エラー	FTP サーバーの開いている接続がないことを示します
「ファイルが見つかりませんでした」エラー	ファイルが見つからなかったことを示します
ファイルの削除不可エラー	ファイルの削除を実行できなかったことを示します

FTP ファイルの名前を変更する

FTP サーバー上にあるファイルの名前を変更します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
FTP connection	いいえ	FTP 接続		作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
名前を変更するファイル	いいえ	FTP ファイル		名前を変更するファイル
新しいファイル名	いいえ	テキスト値		ファイルの新しい名前です。 パス付きの名前を入力すると、ファイルがその場所に移動します。 場所が存在しない場合、例外がスローされます

生成された変数

このアクションは変数を生成しません。

例外

例外	Description
未接続エラー	FTP サーバーの開いている接続がないことを示します
ファイルの名前変更不可エラー	ファイルの名前を変更できなかったことを示します
「ファイルが見つかりませんでした」エラー	ファイルが見つからなかったことを示します

FTP ディレクトリの作成

FTP サーバーにディレクトリを作成します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
FTP connection	いいえ	FTP 接続		作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
New directory	いいえ	FTP ディレクトリ		新しいディレクトリです。 パスを指定すると、新しいディレクトリにつながるすべての新しいフォルダが作成されます

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
アクセス拒否エラー	このアカウントが操作に対するアクセス権を持っていないことを示します
ファイルの存在エラー	ファイルが既に存在することを示します
ディレクトリの作成エラー	ディレクトリを作成できなかったことを示します
「ディレクトリが存在しません」エラー	ディレクトリが見つからなかったことを示します
未接続エラー	FTP サーバーの開いている接続がないことを示します

FTP ディレクトリを削除

FTP サーバーからディレクトリを削除します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
FTP connection	いいえ	FTP 接続		作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
Directory to delete	いいえ	FTP ディレクトリ		削除するフォルダーです。 フォルダ内のすべてが削除されます

生成された変数

このアクションは変数を生成しません。

例外

例外	説明設定
ディレクトリの削除エラー	ディレクトリを削除できなかったことを示します
「リモート ディレクトリが存在しません」エラー	ディレクトリが FTP サーバー上に存在しないことを示します
作業ディレクトリの変更エラー	作業ディレクトリを変更できなかったことを示します
未接続エラー	FTP サーバーの開いている接続がないことを示します

FTP コマンドの呼び出し

サーバー上で指定されたリテラル FTP コマンドを呼び出します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
FTP connection	いいえ	FTP 接続		作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
FTP command	いいえ	テキスト値		引数を指定して実行するコマンドです。 たとえば、FEAT を実行したり、CHMOD を実行したりすることができます
Valid reply code(s)	はい	テキスト値		コマンドから返される可能性のあるコードをセミコロンで区切って表示します。 FTPコマンドがここに入力されていないコードを返した場合、このアクションは例外をスローします。 単純な FTP、または FTPS 接続でのみ適用されます

生成された変数

引数	タイプ	説明設定
ReplyCode	Text 値	返された実際のコードです。 単純な FTP、または FTPS 接続でのみ適用されます
ReplyText	テキスト値	FTP サーバーによって返されるテキスト

例外

例外	Description
コマンドの呼び出しエラー	FTP コマンドの呼び出し中にエラーが発生したことを示します
未接続エラー	FTP サーバーの開いている接続がないことを示します

ディレクトリの同期

指定したフォルダーのファイルとサブディレクトリを特定のリモート FTP ディレクトリと同期します。

入力パラメーター

引数	オプション	受入	Default Value	説明設定
FTP connection	いいえ	FTP 接続		作業を行う FTP 接続です。 この変数は、Open FTP 接続アクションで事前に指定されている必要があります
Synchronization direction	N/A	リモート -> ローカル (ダウンロード)、ローカル -> リモート (アップロード)	リモート -> ローカル (ダウンロード)	同期化メソッドの方向です。 ローカル フォルダーをリモート ディレクトリに同期させるか (DOWNLOAD)、リモート ディレクトリをローカル フォルダに同期させるか (UPLOAD) を選択します
Files to sync	N/A	すべてのファイル、ファイル フィルターに一致するファイルのみ、ファイル フィルターに一致しないファイルのみ	すべてのファイル	すべてのファイルを同期するか、ファイル フィルターを使って特定のファイルのセットを追加または除外するかを選択します
File filter	いいえ	テキスト値	*	どのファイルを含め、除外するかを制御するファイル名パターン。 このオプションでは、".txt" , "document?.doc" などのワイルドカードを使用することができます。このオプションでは、コマを区切り文字として使用して複数のフィルタを設定することもできます (例 : ".txt,*.pdf,document?")。
Local folder	いいえ	フォルダー		同期するローカル フォルダーの名前
FTP directory	はい	FTP ディレクトリ	/	同期する FTP ディレクトリの名前
Delete if source is absent	N/A	ブール値	False	このオプションを選択すると、ソースではなくターゲット ディレクトリに存在するファイルまたはフォルダーが削除されます。
Include subdirectories	N/A	ブール値	有効	このオプションを選択すると、同期プロセスにサブディレクトリが含められます。
Time difference in hours	はい	数値	0	リモート サーバーが別のタイム ゾーンで稼働している場合の時差 (時間単位) です。
Time difference in minutes	はい	数値	0	リモート サーバーが別のタイム ゾーンで稼働している場合の時差 (分単位) です。
Time difference ahead	N/A	ブール値	有効	サーバーのタイム ゾーンが先行しているかどうかを指定します。

生成された変数

引数	タイプ	説明設定
FtpFilesAdded	FTP ファイル のリスト	最初はソースに存在し、同期プロセス後にターゲットに追加された FTP ファイルの一覧です。
FtpFilesModified	FTP ファイル のリスト	最初はソースとターゲットの両方に存在し、同期プロセス後にターゲットに追加された FTP ファイルの一覧です。
FtpFilesDeleted	FTP ファイル のリスト	最初はターゲット ディレクトリに存在し、同期プロセス後に削除された FTP ファイルの一覧です。
FilesAdded	ファイル の リスト	最初はソースに存在し、同期プロセス後にターゲットに追加されたファイルの一覧です。
FilesModified	ファイル の リスト	最初はソースとターゲットの両方に存在し、同期プロセス後にターゲットに追加されたファイルの一覧です。
FilesDeleted	ファイル の リスト	最初はターゲット ディレクトリに存在し、同期プロセス後に削除されたファイルの一覧です。

例外

例外	Description
一覧表示エラー	フォルダーの一覧表示を実行できなかったことを示します
未接続エラー	FTP サーバーの開いている接続がないことを示します
「ファイルが見つかりませんでした」エラー	ファイルが見つからなかったことを示します
FTP 接続の中止エラー	FTP 接続が中止されたことを示します
ファイルのアップロード エラー	ファイルをアップロードできなかったことを示します
「リモート ファイルが存在しません」エラー	ファイルが FTP サーバー上に存在しないことを示します
ファイルのダウンロード不可エラー	ファイルをダウンロードできなかったことを示します
ディレクトリの削除エラー	ディレクトリを削除できなかったことを示します
同期失敗エラー	予期しないエラーによって同期プロセスが失敗したことを示します。