チェーンの一部として単一のセキュアファイル転送プロトコル（SFTP）サーバーと対話するには、SFTP 接続コマンドを含むステップを追加します。
メモ： このコネクターを使用するには、組織が独自の SFTP サーバーにアクセスする必要があります。Workivaは、SFTPサーバーをホストまたは提供していません。
これらのコマンドを有効にするには、まずIT管理者がSFTP接続を構成する 。
削除
SFTP サーバー上のファイルやフォルダを削除するには、Delete コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ファイル |
削除するファイルとフォルダを入力します。複数のファイルやフォルダにマッチさせるには、ワイルドカード文字*を使います。 |
| フォルダをスキップする |
指定したファイルと一致するフォルダを無視するには、このボックスにチェックを入れます。 |
| 再帰的 |
指定したフォルダとそのコンテンツ全体を削除済みにするには、このボックスをチェックします。 |
出力
| 出力 |
出力タイプ |
| 削除済ファイル |
JSON |
| 削除済フォルダ |
JSON |
| 全アイテム削除済 |
JSON |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
タスク失敗 |
| 6 |
エラー |
削除済のマークが付けられたディレクトリがスキップされるように設定されておらず、再帰的が設定されず |
ファイルをダウンロード
SFTP サーバーからファイルをダウンロードするには、Download File コマンドを使用する。
プロパティ
| プロパティ |
詳細 |
| ファイル |
SFTPサーバーから取得するファイルの名称を入力します。 注： グループ反復でこのコマンドを使用する場合は、コマンド・イテレータのリモートファイル反復変数を使ってファイルを識別します。 |
| パラレルダウンロード |
大容量ファイルなどの並行ダウンロードを有効にするには、このボックスをチェックします。 |
| スレッド数 |
Parallel Download を選択した場合は、並列実行するスレッド数を選択する。わからない場合は、デフォルト値の3のままにしてください。 |
出力
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
タスク失敗 |
インテリジェントで、
SFTP サーバーからファイルを取得するには、Get コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ファイル |
取得するファイルを入力します。複数のファイルにマッチさせるには、ワイルドカード文字*を使用します。 |
| リンク先 |
ファイルのリンク先を入力します。複数のファイルを検索するには、ディレクトリを入力します。 |
出力
| 出力 |
出力タイプ |
| 取得ファイル |
JSON |
| 取得ファイル (テキスト) |
文字列 |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
タスク失敗 |
| 6 |
エラー |
ディレクトリはスキップされず、削除済マークもつかず、再帰も設定されなかった。 |
リスト・ディレクトリ
SFTP サーバーのディレクトリ内のファイルを一覧表示するには、List Directory コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ディレクトリ |
リストアップするコンテンツのあるディレクトリを入力します。ディレクトリ内の複数のファイルやフォルダを一覧表示するには、ワイルドカード文字* を使用します。 メモ: このコマンドを、後のイテレータ・ダウンロード・ファイル・コマンドのためにファイルをリストアップするために使用する場合は、ダウンロードするファイルの名称を含む。日付やタイムスタンプに基づくなど、イテレータごとに名称が変更される場合は、ワイルドカード文字* を含む。 |
| 詳細レベル |
ファイルとフォルダの詳細表示レベルを選択します：
- 短い, ファイルとフォルダの名称のみ。
- フル 、名称と所有権および権限を含む追加情報。
|
出力
| 出力 |
出力タイプ |
| リモートファイル |
JSON |
| リモートファイルの詳細 |
JSON (file)
2025 年 9 月 11 日より有効。次のフィールドを持つファイルの JSON 配列を含みます：
- modifiedTime = SFTPファイルの最終更新時間
- mode = ファイルモード
- remoteFile = リモートファイルへのパス（これは他の出力と一致します。）
- accessedTime = SFTP ファイルが最後に使用された時間
サンプル：
[{"modifiedTime": "Wed Sep 10 03:15:15 UTC 2025", "size": "60", "mode":"-rwxrwxr-x", "remoteFile":"/tmp/somefile.txt", "accessedTime": "Wed Sep 10 03:15:15 UTC 2025"},{"modifiedTime": "Wed Sep 10 02:37:36 UTC 2025", "size": "60", "mode": "drwxrwxr-x", "remoteFile":"/tmp/someDir", "accessedTime": "Wed Sep 10 02:37:36 UTC 2025"}].
|
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
タスク失敗 |
| 5 |
エラー |
指定されたディレクトリが検出されません |
ディレクトリを作成する
SFTPサーバーに新規ディレクトリを作成するには、Make Directory コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ディレクトリ |
SFTPサーバー上に作成するディレクトリを入力します。 |
| 再帰的 |
ディレクトリが存在しない場合、そのパス全体を作成するには、このボックスにチェックを入れる。 |
出力
なし
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
タスク失敗 |
| 4 |
エラー |
指定したディレクトリの作成エラー |
| 6 |
成功 |
ディレクトリはすでに存在する |
移動
SFTPサーバー上のファイルを移動するには、Move コマンドを使用します。
プロパティ
| プロパティ |
詳細 |
| ファイル |
移動するファイルを入力します。複数のファイルやフォルダにマッチさせるには、ワイルドカード文字*を使います。 |
| リンク先 |
ファイルのリンク先を入力します。複数のファイルを移動完了するには、ディレクトリを入力します。 |
出力
| 出力 |
出力タイプ |
| 移動したファイル |
JSON |
| 移動したファイル（テキスト） |
文字列 |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
タスク失敗 |
| 4 |
エラー |
複数のファイルを移動完了する場合、リンク先は既存のディレクトリである必要があります。 |
| 5 |
エラー |
指定されたソースファイルを含むファイルが見つかりません。 |
置く
SFTPサーバーにファイルをアップロードするには、Put コマンドを使用する。
プロパティ
| プロパティ |
詳細 |
| ファイル |
アップロードするファイルを入力します。複数のファイルやフォルダにマッチさせるには、ワイルドカード文字*を使います。 |
| リンク先 |
ファイルのリンク先を入力します。複数のファイルをアップロードするには、ディレクトリを入力します。 |
出力
| 出力 |
出力タイプ |
| リモートファイル |
JSON |
| リモートファイル（テキスト） |
文字列 |
閉じるコード
| コード |
タイプ |
詳細 |
| 0 |
成功 |
成功 |
| 2 |
エラー |
タスク失敗 |
| 6 |
エラー |
ディレクトリはスキップされず、削除済マークも付けられなかったが、再帰は設定されていなかった。 |