跳轉到主要內容
FTP 端口可與遠端 FTP 伺服器傳輸檔案。

核心功能

  • 支援 FTPS (FTP over TLS/SSL) 和傳統 FTP 檔案傳輸協議
  • 支援主動和被動模式,具備完善的防火牆相容性
  • 支援中斷點續傳功能,適用於中斷的上傳和下載任務
  • 提供進階身分驗證,包括基於憑證的用戶端身分驗證
  • 支援連線池和臨時檔案處理,確保傳輸的可靠性
  • 提供可選的快取功能,確保僅下載新增或更新的檔案

概觀

每個 FTP 端口連線上傳檔案到指定的資料夾,並從遠端 FTP 伺服器上的一組資料夾下載。 在 知行之橋 工作流程中到達 FTP 端口的檔案被上傳到上傳目的檔案夾,在下載目的檔案夾中找到的檔案被下載並輸入到 知行之橋 工作流程中。端口支援上傳和下載過濾規則,僅傳送和接收指定的檔名和/或副檔名。

端口配置

本節包含所有可配置的端口屬性。

設定

主機配置

與建立到遠端 FTP 主機的連線相關的設定。

用戶端驗證

與向 FTP 伺服器進行身分驗證相關的設定。

伺服器驗證

與驗證 FTP 伺服器身份相關的設定。

上傳

與檔案上傳到 FTP 伺服器相關的設定。

下載

與從 FTP 伺服器下載相關的設定。

快取

與快取及多次下載之間檔案比對相關的設定。

知行之橋會自動清理資源快取。此過程在每次接收週期的後臺執行,刪除遠端伺服器上已不存在的檔案對應的過期快取項目。這使得快取大小始終保持在可管理範圍內,無需任何手動操作。

預設情況下,檔案保留 30 天,但您可以在進階索引標籤的其他設定欄位中使用 ResourceCacheRetentionDays 設定來調整保留時間以適應您的環境。例如,ResourceCacheRetentionDays=15 表示檔案保留 15 天后將被刪除。

啟用快取後,檔名不區分大小寫。例如,端口無法區分 TEST.TXT 和 test.txt。

進階設定

TLS 用戶端認證

需要雙向 TLS 身分驗證時與用戶端身分驗證相關的設定。

伺服器命令

進階設定

先前類別中未包含的設定。

代理設定

這是一組用於識別連線所經代理並對其進行身分驗證的設定。預設情況下,本節使用 安全設定 頁面的 代理設定 部分中的全域設定。清除此核取方塊可為您的端口提供特定的設定。

設定描述
代理型別基於代理的防火牆使用的協議。
代理主機基於代理的防火牆的名稱或 IP 地址。
代理端口基於代理的防火牆的 TCP 端口。
代理使用者用於透過基於代理的防火牆進行身分驗證的使用者名稱。
代理密碼用於對基於代理的防火牆進行身分驗證的密碼。
身分驗證方案保留預設值 None 或選擇以下身分驗證方案之一:Basic、Digest、Proprietary 或 NTLM。

訊息

訊息設定確定端口如何搜尋訊息並在處理後管理它們。

注意:以下設定已棄用,預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本,請在工作流程中右鍵單擊該端口,選擇顯示成功路徑,然後將成功路徑連線到 File 端口。

設定描述
儲存到已傳送資料夾(已棄用)將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。
已傳送資料夾方案(已棄用)按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。

日誌

用於管理日誌建立和儲存的設定。

設定描述
日誌級別指定要記錄在端口日誌目錄中的資訊型別:
  • None - 不建立任何日誌。
  • Error - 僅當端口遇到錯誤時才建立日誌。
  • Warning - 僅當端口發出警告時才建立日誌。
  • Info - 記錄工作流程的一般資訊,包括任何錯誤和警告(如果適用)。
  • Debug - 記錄成功和失敗工作流程的詳細偵錯資訊。
  • Trace - 記錄成功和失敗工作流程的詳細跟蹤資訊。
請注意:Debug 和 Trace 級別的日誌可能會記錄敏感資訊,包括訊息內容和 SSL 憑證。儘管連線屬性(例如密碼)被遮蔽了,但在與您的組織外部共享它們之前,請檢視此級別的日誌以避免洩漏敏感資訊。
日誌資料夾結構指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如,Weekly 選項指示端口每週建立一個新的子資料夾,並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口,使用子資料夾有助於保持日誌的有序性並提高效能。
保留訊息副本指示端口在日誌目錄中儲存最新訊息副本的切換。請注意,端口每個子資料夾只保留一個訊息,並且端口在再次執行時會覆蓋以前儲存的訊息。

其他設定

特殊設定適用於特定用例。

設定描述
其他設定允許在以分號分隔的清單中配置隱藏的端口設定,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。

自動化

自動化設定

與端口自動處理檔案相關的設定。

自動化狀態

效能

與端口資源分配相關的設定。

設定描述
最大工作執行緒數此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。
最大檔案數分配給端口的每個執行緒傳送的最大檔案數。如果設定,則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。

告警索引標籤

SLA 索引標籤

建立一個連線

連線到遠端 FTP 伺服器需要以下設定:
  • 遠端主機
  • TLS 型別
  • 遠端主機端口
  • 使用者名稱
  • 密碼
在進階索引標籤下,FTP 伺服器可能還需要伺服器公開金鑰憑證和 TLS 用戶端認證。

上傳檔案

FTP 端口從交易索引標籤上傳檔案。如果端口中啟用了上傳自動化功能,檔案將自動上傳到 FTP 伺服器。 遠端目錄應設定為遠端 FTP 伺服器上應上傳檔案的資料夾。可以使用宏動態建立按日期劃分的資料夾(例如年份或月份資料夾)。登入到伺服器後,應用程式會將目錄更改到指定的資料夾。可以在進階索引標籤中設定臨時上傳副檔名、字首或路徑,以確保檔案在遠端目錄資料夾中結束之前已被完全傳輸。 如果有任何檔案無法上傳,端口會在重試間隔分鐘後嘗試傳送它們。此過程一直持續,直到達到最大重試次數設定,之後端口將引發錯誤,檔案將不再自動傳送。

下載檔案

下載的檔案顯示在端口的交易索引標籤中,或者傳遞給工作流程中的下一個端口。如果端口中啟用了下載自動化功能,檔案將自動從 FTP 伺服器上下載,並且可以透過單擊交易索引標籤中的接收檔案按鈕手動下載。 遠端目錄應設定為遠端 FTP 伺服器上的資料夾,檔案應從該資料夾下載。可以使用宏動態建立按日期劃分的資料夾(例如年份或月份資料夾)。登入到伺服器後,應用程式將目錄更改到指定的資料夾。檔案掩碼屬性過濾檔案,以便只從伺服器下載與全域模式匹配的檔名。可以在進階索引標籤中設定臨時下載副檔名或字首,以確保檔案在交易索引標籤中結束之前已被完全傳輸。 **刪除檔案(下載後)**設定可用於在成功下載檔案後刪除遠端伺服器上的檔案。 完成配置後,檔案將會根據自動下載的配置下載,或者在交易索引標籤上手動點選接收檔案按鈕。

子目錄訊息頭

如果遞迴被選擇,FTP 端口從遠端目錄接收檔案時:
  • 收到的檔案訊息將在其中繼資料中包含子目錄訊息頭。
  • 這個訊息頭包含子目錄,其相對於配置的遠端目錄。
  • 這個子目錄訊息頭可以被其它支援該功能的傳送端口所識別和支援。
當傳送檔案時,如果傳送到 FTP 端口遠端目錄的訊息中存在子目錄訊息頭:
  • 檔案將被放置在子目錄(相對於 FTP 端口遠端目錄設定)中,該子目錄在子目錄訊息頭中指定。
  • 如果有權限,子目錄會被自動建立。

宏

範例