若要與單一安全檔案傳輸協定 (SFTP) 伺服器互動作為連鎖的一部分,請新增包含 SFTP 連線指令的步驟。
註: 若要使用此連接器,您的組織需要存取自己的 SFTP 伺服器。Workiva 不也不 主持或提供 SFTP 伺服器。
要啟用這些命令,IT 管理員首先需要設定 SFTP 連線 。
刪除
若要刪除 SFTP 伺服器上的檔案和資料夾,請使用Delete 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 檔案 |
輸入要刪除的檔案和資料夾。若要匹配多個檔案和資料夾,請使用通配符* 。 |
| 跳過資料夾 |
若要忽略符合指定檔案的資料夾,請勾選此方塊。 |
| RECURSIVE |
若要刪除指定的資料夾及其全部內容,請勾選此方塊。 |
输出
| 輸出 |
輸出類型 |
| 已刪除的檔案 |
JSON |
| 已刪除的資料夾 |
JSON |
| 刪除所有項目 |
JSON |
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 2 |
錯誤 |
任務失敗 |
| 6 |
錯誤 |
標記為刪除的目錄未設定為跳過,且未設定遞歸 |
下載檔案
要從 SFTP 伺服器下載檔案,請使用Download File 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 檔案 |
輸入要從 SFTP 伺服器擷取的檔案名稱。 註記: 如果在群組迭代中使用此指令,請使用指令迭代器的Remote Files Iteration 變數來識別檔案。 |
| 平行下載 |
若要啟用平行下載,例如下載大型檔案,請勾選此方塊。 |
| 線程數 |
如果您選擇Parallel Download ,請選擇要並行執行的線程數。如果不確定,請保留預設值 3。 |
输出
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 2 |
錯誤 |
任務失敗 |
取得
若要從 SFTP 伺服器擷取檔案,請使用Get 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 檔案 |
輸入要擷取的檔案。若要匹配多個檔案,請使用通配符* 。 |
| 目的地 |
輸入檔案的目的地。若要擷取多個檔案,請輸入目錄。 |
输出
| 輸出 |
輸出類型 |
| 擷取的檔案 |
JSON |
| 擷取的檔案 (文字) |
字串 |
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 2 |
錯誤 |
任務失敗 |
| 6 |
錯誤 |
沒有跳過目錄和標記刪除,也沒有設定遞歸 |
列出目錄
要列出 SFTP 伺服器上目錄中的檔案,請使用List Directory 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 目錄 |
輸入要列出內容的目錄。若要列出目錄中的多個檔案和資料夾,請使用通配符* 。 注意: 如果使用此命令為稍後的「下載檔案」迭代命令列出檔案,請包含要下載的檔案名稱。如果名稱隨每次迭代而變更,例如根據日期或時間戳記,請包含通配符符號* 。 |
| 詳細級別 |
選擇要顯示檔案和資料夾的詳細程度:
- 簡短 ,僅顯示檔案和資料夾的名稱
- 完整, 顯示名稱和其他資訊,包括所有權和權限
|
输出
| 輸出 |
輸出類型 |
| 遠端檔案 |
JSON |
| 遠端檔案詳細資料 |
JSON (檔案) 自 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 伺服器上建立的目錄。 |
| RECURSIVE |
若要建立目錄的整個路徑(如果不存在),請勾選此方塊。 |
輸出
無
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 2 |
錯誤 |
任務失敗 |
| 4 |
錯誤 |
建立指定目錄錯誤 |
| 6 |
成功 |
目錄已存在 |
移動
要在 SFTP 伺服器上移動檔案,請使用Move 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 檔案 |
輸入要移動的檔案。若要匹配多個檔案和資料夾,請使用通配符* 。 |
| 目的地 |
輸入檔案的目的地。若要移動多個檔案,請輸入目錄。 |
输出
| 輸出 |
輸出類型 |
| 已移動的檔案 |
JSON |
| 已移除的檔案 (文字) |
字串 |
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 2 |
錯誤 |
任務失敗 |
| 4 |
錯誤 |
移動多個檔案時,目的地必須是現有目錄 |
| 5 |
錯誤 |
沒有找到指定來源檔案的檔案 |
Put
若要上傳檔案到 SFTP 伺服器,請使用Put 指令。
摘要資訊
| 摘要資訊 |
詳細資訊 |
| 檔案 |
輸入要上傳的檔案。若要匹配多個檔案和資料夾,請使用通配符* 。 |
| 目的地 |
輸入檔案的目的地。若要上傳多個檔案,請輸入目錄。 |
输出
| 輸出 |
輸出類型 |
| 遠端檔案 |
JSON |
| 遠端檔案(文字) |
字串 |
退出代碼
| 代碼 |
類型 |
詳細資訊 |
| 0 |
成功 |
成功 |
| 2 |
錯誤 |
任務失敗 |
| 6 |
錯誤 |
目錄未被跳過和標記為刪除,但遞歸未設定 |