FTP
使用 FTP 動作群組上傳和下載檔案，並在 FTP 伺服器上操縱目錄。
若要建立 FTP 連線，請使用開啟 FTP 連線動作。 下列範例具有指定的主機、連接埠及認證。 此外，如果無法按時建立連接，則設定逾時會讓動作失敗。
使用從 FTP 下載檔案動作下載檔案。 以下範例顯示使用中的連線變數，和選定的目標資料夾。 已指定遠端檔案，並將其設定為覆寫相同位置中的現有檔案。
![[從 FTP 下載檔案] 動作的螢幕擷取畫面。](media/ftp/download-files-ftp-example.png)
使用將檔案上傳至 FTP 動作和指定檔案和遠端位置，來上傳檔案。
開啟 FTP 連線
這個動作會建立遠端 FTP 伺服器的特定連線，並將該連線儲存為可供日後使用的變數
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| Host |
否 |
文字值 |
|
在此輸入 FTP 伺服器位址。 |
| Port |
是 |
數值 |
21 |
在此輸入 FTP 伺服器連接埠。 |
| Active mode |
無法使用 |
布林值 |
否 |
指定連線的模式 |
| Username |
否 |
文字值 |
|
指定要使用的 FTP 帳戶使用者名稱 |
| 密碼 |
是 |
直接加密文字輸入或文字值 |
|
指定要使用的 FTP 帳戶密碼 |
| 逾時 |
是 |
數值 |
10 |
設定您想要等候伺服器建立的時間 (秒鐘)，在此時間過後，此動作即失敗 |
變數已產生
| 引數 |
類型 |
描述 |
| FTPConnection |
FTP 連線 |
FTP 連線 |
例外狀況
| 例外 |
描述 |
| 登入失敗錯誤 |
指示登入失敗 |
| 連線錯誤 |
指示連接有問題 |
列出 FTP 目錄
此動作會傳回目前 FTP 連線目錄中所包含的子目錄與檔案。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| Connection |
否 |
FTP 連線 |
|
FTP 連線 |
| Path |
是 |
文字值 |
|
您想要列出的路徑。 |
變數已產生
例外狀況
| 例外狀況 |
描述 |
| 列出錯誤 |
指示無法執行列出資料夾 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
| 目錄不存在錯誤 |
指示找不到目錄 |
開啟安全 FTP 連線
此動作會建立遠端 FTP 伺服器的特定安全連線，並將該連線儲存為可供日後使用的變數。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| Host |
否 |
文字值 |
|
在此輸入 FTP 伺服器位址。 |
| Port |
是 |
數值 |
22 |
在此輸入 FTP 伺服器連接埠。 |
| Active mode |
無法使用 |
布林值 |
是 |
指定連線的模式 |
| Secure FTP Protocol |
無法使用 |
SFTP、外顯式 FTPS、隱含式 FTPS |
SFTP |
選擇您想要用來加密連線的 FTP 通訊協定 |
| Authentication method |
無法使用 |
使用者名稱和密碼、私密金鑰、私密金鑰和複雜密碼 |
使用者名稱與密碼 |
選擇您要用來在 FTP 伺服器上驗證您自己的方法 |
| User name |
否 |
文字值 |
|
指定要使用的 FTP 帳戶使用者名稱 |
| 密碼 |
是 |
直接加密文字輸入或文字值 |
|
指定您想要使用的 FTP 帳戶密碼 |
| Path to private key |
否 |
文字值 |
|
輸入要用於驗證之私密金鑰的檔案路徑 |
| 私密金鑰複雜密碼 |
是 |
直接加密文字輸入或文字值 |
|
在此處輸入包含私密金鑰複雜密碼的變數 |
| Timeout |
是 |
數值 |
10 |
設定您想要等候伺服器建立的時間 (秒鐘)，在此時間過後，此動作即失敗 |
變數已產生
| 引數 |
類型 |
描述 |
| SftpConnection |
FTP 連線 |
SFTP 連線 |
例外狀況
| 例外 |
描述 |
| 登入失敗錯誤 |
指示登入失敗 |
| 連線錯誤 |
指示連接有問題 |
關閉連線
此動作會關閉開啟的 FTP 連線。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| 連線 |
否 |
FTP 連線 |
|
FTP 連線 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
名描述 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
變更工作目錄
此動作會設定 FTP 連線的目前工作目錄。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| Connection |
否 |
FTP 連線 |
|
FTP 連線 |
| Set working directory to |
否 |
文字值 |
|
設定要設為工作目錄的路徑 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
名描述 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
| 目錄不存在錯誤 |
指示找不到目錄 |
| 無法變更工作目錄錯誤 |
指示無法變更工作目錄 |
從 FTP 下載檔案
從 FTP 伺服器下載一或多個檔案。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| FTP connection |
否 |
FTP 連線 |
|
要使用的 FTP 連線。 這個變數必須先前已在 [開啟 FTP 連線] 動作中指定過 |
| Download into folder |
否 |
資料夾 |
|
將下載之檔案的目的地資料夾 |
| 要下載的檔案 |
否 |
FTP 檔案的清單 |
|
要下載的檔案 |
| 轉換類型 |
無法使用 |
自動、二進位、ASCII |
自動 |
輸入 ASCII 或二進位來指定下載單一檔案的方法。 如果無法確定檔案類型，或要下載多個檔案，請選擇 [自動] 以遵循選項所指定的傳輸規則 |
| If file exists |
無法使用 |
覆寫、不要下載、使用唯一名稱下載 |
覆寫 |
指定檔案已經存在時所要採取的動作。 [覆寫] 會改寫原始檔案，因此您無法再存取原始內容，而 [使用唯一名稱下載] 則會在結尾處加上底線和循序編號 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
名描述 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
| 遠端檔案不存在錯誤 |
指示檔案不存在於 FTP 伺服器中 |
| 目錄不存在錯誤 |
指示找不到目錄 |
| FTP 連線已中止錯誤 |
指示 FTP 連線已中止 |
| 無法下載檔案錯誤 |
指示無法下載檔案 |
從 FTP 下載資料夾
從 FTP 伺服器下載一或多個資料夾。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| FTP connection |
否 |
FTP 連線 |
|
要使用的 FTP 連線。 這個變數必須先前已在 [開啟 FTP 連線] 動作中指定過 |
| Folder(s) to download |
否 |
FTP 目錄的清單 |
|
資料夾路徑的名稱，或要下載的 FTP 資料夾 |
| Download into local folder |
否 |
資料夾 |
|
您正在下載的 FTP 資料夾的目的地完整路徑 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
名描述 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
| 遠端目錄不存在錯誤 |
指示目錄不存在於 FTP 伺服器中 |
| 目錄不存在錯誤 |
指示找不到目錄 |
| FTP 連線已中止錯誤 |
指示 FTP 連線已中止 |
| 無法下載目錄錯誤 |
指示無法下載目錄 |
將檔案上傳至 FTP
將一或多個檔案上傳至 FTP 伺服器。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| FTP connection |
否 |
FTP 連線 |
|
要使用的 FTP 連線。 這個變數必須先前已在 [開啟 FTP 連線] 動作中指定過 |
| File(s) to upload |
否 |
檔案的清單 |
|
要上傳的檔案 |
| Remote location |
是 |
文字值 |
|
檔案應上傳至其中的位置 |
| Transfer type |
無法使用 |
自動、二進位、ASCII |
自動 |
輸入 ASCII 或二進位來指定下載單一檔案的方法。 如果無法確定檔案會是什麼類型，或者您要下載多個檔案，請選擇 [自動] 以遵循 [選項] 所指定的傳輸規則 |
| If file exists |
無法使用 |
覆寫、不要下載、使用唯一名稱下載 |
覆寫 |
指定檔案已經存在時所要採取的動作。 [覆寫] 會改寫原始檔案，因此您無法再存取原始內容，而 [使用唯一名稱下載] 則會在結尾處加上底線和循序編號 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
名描述 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
| 找不到檔案錯誤 |
指示找不到檔案 |
| FTP 連線已中止錯誤 |
指示 FTP 連線已中止 |
| 上傳檔案錯誤 |
指示無法上傳檔案 |
將資料夾上傳至 FTP
將一或多個資料夾上傳至 FTP 伺服器。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| FTP connection |
否 |
FTP 連線 |
|
要使用的 FTP 連線。 這個變數必須先前已在 [開啟 FTP 連線] 動作中指定過 |
| Folder(s) to upload |
否 |
資料夾的清單 |
|
要上傳的資料夾。 FTP 伺服器的使用中目錄不應該出現即將上傳的資料夾 |
| Remote location |
否 |
文字值 |
|
資料夾應上傳至其中的位置 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
名描述 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
| 遠端目錄不存在錯誤 |
指示目錄不存在於 FTP 伺服器中 |
| FTP 連線已中止錯誤 |
指示 FTP 連線已中止 |
| 上傳目錄錯誤 |
指示無法上傳目錄 |
刪除 FTP 檔案
從 FTP 伺服器上刪除一或多個檔案。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| FTP connection |
否 |
FTP 連線 |
|
要使用的 FTP 連線。 這個變數必須先前已在 [開啟 FTP 連線] 動作中指定過 |
| 要刪除的檔案 |
否 |
FTP 檔案的清單 |
|
要刪除的檔案 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
名描述 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
| 找不到檔案錯誤 |
指示找不到檔案 |
| 無法刪除檔案錯誤 |
指示無法刪除檔案 |
重新命名 FTP 檔案
重新命名位在 FTP 伺服器上的檔案。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| FTP connection |
否 |
FTP 連線 |
|
要使用的 FTP 連線。 這個變數必須先前已在 [開啟 FTP 連線] 動作中指定過 |
| 要重新命名的檔案 |
否 |
FTP 檔案 |
|
要重新命名的檔案 |
| 新檔案名稱 |
否 |
文字值 |
|
檔案的新名稱。 如果輸入含有路徑的名稱，檔案也會移至該位置。 如果位置不存在，則會擲回例外狀況 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
名描述 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
| 無法重新命名檔案錯誤 |
指示無法重新命名檔案 |
| 找不到檔案錯誤 |
指示找不到檔案 |
建立 FTP 目錄
在 FTP 伺服器上建立目錄。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| FTP connection |
否 |
FTP 連線 |
|
要使用的 FTP 連線。 這個變數必須先前已在 [開啟 FTP 連線] 動作中指定過 |
| New directory |
否 |
FTP 目錄 |
|
新目錄。 如果路徑已指定，就會建立所有指向新目錄的新資料夾 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
描述 |
| 存取遭拒錯誤 |
指示這個帳戶沒有作業存取權 |
| 檔案已存在錯誤 |
指示檔案已存在 |
| 建立目錄錯誤 |
指示無法建立目錄 |
| 目錄不存在錯誤 |
指示找不到目錄 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
刪除 FTP 目錄
從 FTP 伺服器刪除目錄。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| FTP connection |
否 |
FTP 連線 |
|
要使用的 FTP 連線。 這個變數必須先前已在 [開啟 FTP 連線] 動作中指定過 |
| Directory to delete |
否 |
FTP 目錄 |
|
要刪除的資料夾。 也將刪除資料夾中的所有內容 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 |
描述 |
| 刪除目錄錯誤 |
指示無法刪除目錄 |
| 遠端目錄不存在錯誤 |
指示目錄不存在於 FTP 伺服器中 |
| 工作目錄變更錯誤 |
指示無法變更工作目錄 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
叫用 FTP 命令
在伺服器上叫用指定的常值 FTP 命令。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| FTP connection |
否 |
FTP 連線 |
|
要使用的 FTP 連線。 這個變數必須先前已在 [開啟 FTP 連線] 動作中指定過 |
| FTP command |
否 |
文字值 |
|
要搭配任何引數一起執行的命令。 例如，您可以在這裡執行 FEAT 或 CHMOD |
| Valid reply code(s) |
是 |
文字值 |
|
可能會由命令傳回的代碼 (以分號分隔)。 如果 FTP 命令傳回不是此處輸入的代碼，這個動作會擲回例外狀況。 僅適用於簡單 FTP 或 FTPS 連線 |
變數已產生
| 引數 |
類型 |
描述 |
| ReplyCode |
文字值 |
傳回的實際代碼。 僅適用於簡單 FTP 或 FTPS 連線 |
| ReplyText |
文字值 |
FTP 伺服器傳回的文字 |
例外狀況
| 例外狀況 |
名描述 |
| 叫用命令錯誤 |
指示叫用 FTP 命令時發生錯誤 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
同步處理目錄
使用指定的遠端 FTP 目錄，同步處理指定資料夾的檔案與子目錄。
| 引數 |
選用 |
接受 |
預設值 |
描述 |
| FTP connection |
否 |
FTP 連線 |
|
要使用的 FTP 連線。 這個變數必須先前已在 [開啟 FTP 連線] 動作中指定過 |
| Synchronization direction |
無法使用 |
遠端 -> 本機 (下載)、本機 -> 遠端 (上傳) |
遠端 -> 本機 (下載) |
同步處理方法的方向。 本機資料夾將同步處理至遠端目錄 (下載)，還是遠端目錄將同步處理至本機資料夾 (上傳) |
| Files to sync |
無法使用 |
所有檔案、僅限符合檔案篩選的檔案、僅限不符合檔案篩選的檔案 |
所有檔案 |
選擇您要同步處理所有檔案，或您要使用檔案篩選來包含或排除一組特定檔案 |
| 檔案篩選 |
否 |
文字值 |
* |
可控制將包含或排除哪些檔案的檔案名稱模式。 這個選項允許萬用字元，例如 ".txt"、"document?.doc"。該選項也允許使用逗號做為分隔符號進行多重篩選，例如 ".txt,*.pdf,document?" |
| Local folder |
否 |
資料夾 |
|
要同步處理的本機資料夾名稱 |
| FTP directory |
是 |
FTP 目錄 |
/ |
要同步處理之 FTP 目錄的名稱。 |
| Delete if source is absent |
無法使用 |
布林值 |
誤判為真 |
這個選項會刪除存在於目標目錄中的檔案或資料夾，而非來源目錄中的內容。 |
| Include subdirectories |
無法使用 |
布林值 |
是 |
這個選項會將子目錄包含在同步處理作業中。 |
| Time difference in hours |
是 |
數值 |
0 |
作業於不同時區中的遠端伺服器時差 (小時)。 |
| Time difference in minutes |
是 |
數值 |
0 |
作業於不同時區中的遠端伺服器時差 (分鐘)。 |
| Time difference ahead |
無法使用 |
布林值 |
是 |
指定伺服器的時區是領先或落後。 |
變數已產生
| 引數 |
類型 |
描述 |
| FtpFilesAdded |
FTP 檔案的清單 |
列出最初存在於來源中，而在同步處理作業後新增至目標之 FTP 檔案的清單。 |
| FtpFilesModified |
FTP 檔案的清單 |
列出最初同時存在於來源與目標目錄中，而在同步處理作業後新增至目標之 FTP 檔案的清單。 |
| FtpFilesDeleted |
FTP 檔案的清單 |
列出最初存在於目標目錄中，但在同步處理作業後遭到刪除之 FTP 檔案的清單。 |
| FilesAdded |
檔案的清單 |
列出最初存在於來源中，而在同步處理作業後新增至目標之檔案的清單。 |
| FilesModified |
檔案的清單 |
列出最初同時存在於來源與目標目錄中，而在同步處理作業後新增至目標之檔案的清單。 |
| FilesDeleted |
檔案的清單 |
列出最初存在於目標目錄中，但在同步處理作業後遭到刪除之檔案的清單。 |
例外狀況
| 例外狀況 |
名描述 |
| 列出錯誤 |
指示無法執行列出資料夾 |
| 未連接錯誤 |
指示沒有開啟的 FTP 伺服器連線 |
| 找不到檔案錯誤 |
指示找不到檔案 |
| FTP 連線已中止錯誤 |
指示 FTP 連線已中止 |
| 上傳檔案錯誤 |
指示無法上傳檔案 |
| 遠端檔案不存在錯誤 |
指示檔案不存在於 FTP 伺服器中 |
| 無法下載檔案錯誤 |
指示無法下載檔案 |
| 刪除目錄錯誤 |
指示無法刪除目錄 |
| 同步處理失敗錯誤 |
指示同步處理因發生意外錯誤而失敗。 |