Share via


FTP

FTP アクション グループを使用して、ファイルをアップロードおよびダウンロードし、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 サーバー上に存在しないことを示します
ファイルのダウンロード不可エラー ファイルをダウンロードできなかったことを示します
ディレクトリの削除エラー ディレクトリを削除できなかったことを示します
同期失敗エラー 予期しないエラーによって同期プロセスが失敗したことを示します。