- 將檔案從外部目錄拉入到 知行之橋 工作流程中。
- 將檔案從 知行之橋 工作流程匯出到外部目錄中。
核心功能
- 整合本地和網路檔案系統，支援 UNC 路徑
- 為受保護的網路位置提供可配置的身分驗證（僅限 .NET 版本）
- 支援 Glob 模式匹配的進階過濾功能及遞迴目錄查詢
- 支援帶暫存和重新命名操作的臨時檔案處理，確保傳輸的可靠性
- 提供可選的快取功能，確保僅下載新增或更新的檔案
概覽
每個 File 端口都需要配置磁碟路徑，該路徑決定了它將從哪個資料夾讀取檔案或向哪個資料夾寫入檔案。可以是本地磁碟路徑，也可以是網路上其它檔案位置的 UNC 路徑。 當 File 端口從配置的路徑接收到檔案時，它會將接收到的檔案傳遞給 知行之橋 工作流程中的下一個端口，不會修改檔案。這樣，File 端口可用於輪詢外部資料夾，以將檔案拉入工作流程。 當 知行之橋 工作流程中的檔案被 File 端口處理時，該檔案將被寫入到配置路徑下的資料夾中。透過這種方式，File 端口可用於將已處理的檔案放在應用程式外部的位置。 File 端口可以配置使用者名稱／密碼憑據，以提供對外部檔案路徑的存取，否則應用程式將無法存取這些路徑。這允許 知行之橋 從受保護的資料夾位置提取檔案，而不需要授予整個應用程式對受保護位置的存取權限。 File 端口中配置的路徑可以使用宏動態填充。更多資訊，請參見宏部分。端口配置
本節包含所有可配置的端口屬性。設定
端口設定
與端口核心操作相關的設定。接收
與從外部檔案路徑提取檔案相關的設定。認證
快取
與快取及多次下載之間檔案比對相關的設定。知行之橋會自動清理資源快取。此過程在每次接收週期的後臺執行，刪除遠端伺服器上已不存在的檔案對應的過期快取項目。這使得快取大小始終保持在可管理範圍內，無需任何手動操作。
預設情況下，檔案保留 30 天，但您可以在進階索引標籤的其他設定欄位中使用 ResourceCacheRetentionDays 設定來調整保留時間以適應您的環境。例如，ResourceCacheRetentionDays=15 表示檔案保留 15 天后將被刪除。
TEST.TXT 和 test.txt。進階設定
進階設定
未包含在先前類別中的設定。訊息
訊息設定確定端口如何搜尋訊息並在處理後管理它們。
注意：以下設定已棄用，預設處於隱藏狀態。只有先前已啟用這些設定或將其配置為非預設值的端口才會顯示它們。若要保留成功處理的檔案副本，請在工作流程中右鍵單擊該端口，選擇顯示成功路徑，然後將成功路徑連線到 File 端口。
| 設定 | 描述 |
|---|---|
| 儲存到已傳送資料夾（已棄用） | 將端口處理的檔案複製到 Sent 資料夾。預設停用。儲存到 Sent 資料夾中的檔案不受靜態加密保護。 |
| 已傳送資料夾方案（已棄用） | 按所選時間間隔對 Sent 資料夾中的檔案進行分組。僅在啟用儲存到已傳送資料夾時適用。 |
日誌
用於管理日誌建立和儲存的設定。
| 設定 | 描述 |
|---|---|
| 日誌級別 | 指定要記錄在端口日誌目錄中的資訊型別：
|
| 日誌資料夾結構 | 指示端口根據選定的時間間隔將日誌資料夾中的檔案分組。例如，Weekly 選項指示端口每週建立一個新的子資料夾，並將該周的所有日誌儲存在該資料夾中。空白設定告訴端口將所有日誌直接儲存在日誌資料夾中。對於處理許多交易的端口，使用子資料夾有助於保持日誌的有序性並提高效能。 |
| 保留訊息副本 | 指示端口在日誌目錄中儲存最新訊息副本的切換。請注意，端口每個子資料夾只保留一個訊息，並且端口在再次執行時會覆蓋以前儲存的訊息。 |
其他設定
特殊設定適用於特定用例。
| 設定 | 描述 |
|---|---|
| 其他設定 | 允許在以分號分隔的清單中配置隱藏的端口設定，例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用這些設定。 |
自動化
自動化設定
與端口自動處理檔案相關的設定。自動化狀態
效能
與端口資源分配相關的設定。
| 設定 | 描述 |
|---|---|
| 最大工作執行緒數 | 此端口上處理檔案時從執行緒池中消耗的最大工作執行緒數。如果設定，則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
| 最大檔案數 | 分配給端口的每個執行緒傳送的最大檔案數。如果設定，則會覆蓋 進階設定 頁面的 效能設定 部分的預設設定。 |
告警索引標籤
SLA 索引標籤
建立連線
File 端口必須具有適當的權限，才能從配置的路徑讀取／寫入。當配置的路徑是到網路上另一個伺服器的 UNC 路徑時，權限問題是主要關注的問題，但是當從本地磁碟上受保護的資料夾推送或提取檔案時，也可能出現權限問題。 如果執行 知行之橋 的使用者沒有存取該路徑的權限，請在設定索引標籤的認證部分，將使用者名稱、密碼和域欄位設定為具有相應權限的特定使用者。傳送／接收檔案
傳送檔案
File 端口將檔案從交易索引標籤傳送到路徑中指定的外部資料夾。如果在自動化索引標籤中啟用了傳送功能，檔案將自動傳送。接收檔案
File 端口從路徑中指定的外部資料夾接收檔案，並將它們放置在端口的交易索引標籤中。如果 File 端口連線到工作流程中的另一個端口，則檔案不會保留在此資料夾中，而是傳遞到下一個連線的端口。 如果在自動化索引標籤中啟用了接收功能，端口將自動輪詢外部資料夾以接收檔案。 端口將只提取與指定檔案掩碼匹配的檔案。如果啟用時間戳比對或啟用檔案大小比對已啟用，端口將快取從遠端路徑提取的檔名，並且僅接收以前未收到的檔案或自上次收到後已修改的檔案。 當一次接收操作中有多個符合條件的檔案時，端口會依最後修改時間戳記遞增順序處理這些檔案，因此較早的檔案會先進入工作流程。時間戳記相同的檔案會依一致且可預測的順序處理。延遲最終確定
預設情況下，端口在接收檔案後會立即完成該檔案，任何已設定的清理操作（例如刪除檔案（接收後））也會立即執行。如果工作流程中的後續步驟失敗，來源檔案已經不存在了。 啟用延遲最終確定接收的檔案後，端口會將每個接收到的檔案保持為待處理狀態，並等待下游的 Finalize 端口確認工作流程已成功。如果需要在處理完成之前保留來源檔案，這是使用**刪除檔案（接收後）**的建議方式。 若要使用延遲最終確定：- 在接收檔案的 File 端口上啟用延遲最終確定接收的檔案。
- 在工作流程成功路徑的末尾新增一個 Finalize 端口。
- 端口不會再次接收該檔案。
- 如果檔案到達 Finalize 端口，端口會完成該檔案並執行已設定的清理操作。
- 如果檔案在**接收待處理逾時（分）**到期之前未到達 Finalize 端口，該訊息會被標記為 Pending Timeout 錯誤，並且該檔案會被釋放以便再次接收。來源檔案不會被刪除。端口會記錄一則 Send Failure: Pending Timeout 錯誤通知。
- 如果來源檔案在接收後發生了變化，即使該檔案已最終確定，端口也不會刪除它。
子目錄訊息頭
如果遞迴子目錄設定為 True，File 端口從路徑接收檔案時：- 收到的檔案訊息將在其中繼資料中包含子目錄訊息頭。
- 這個訊息頭包含子目錄，其相對於配置的路徑。
- 這個子目錄訊息頭可以被其它支援該功能的傳送端口所識別和支援。
- 檔案將被放置在子目錄訊息頭中指定的子目錄（相對於 File 端口的路徑設定）中。
- 如果有權限，子目錄會被自動建立。