跳轉到主要內容
Box 端口支援從 Box 雲端儲存服務上傳和下載檔案。

​
核心功能

  • 基於 OAuth 的雲端儲存整合，支援權杖自動重新整理
  • 從連線的 Box 儲存帳戶上傳和下載，支援遞迴子目錄
  • 檔案過濾、覆蓋保護和遞迴子資料夾支援
  • 為企業網路環境提供全面代理支援
  • 可選的快取功能，確保僅下載新增或更新的檔案

​
總覽

每個 Box 端口都連線到指定的 Box 儲存帳戶。在遠端儲存中，上傳目標只允許設定為單個資料夾，下載目標可以設定為一個資料夾清單。 在 知行之橋 工作流程中，到達 Box 端口的檔案會上傳到上傳目的檔案夾；下載目的檔案夾中的檔案會被下載並進入 知行之橋 工作流程。端口支援上傳和下載過濾器，以便僅傳送和接收特定檔名和/或副檔名。 帳戶身分驗證使用 OAuth，因此端口首次連線時必須在外部站點門戶中輸入帳戶憑據。外部門戶會生成端口用於連線的 OAuth 權杖，之後端口會自動處理權杖重新整理。

​
端口配置

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

​
設定

​
授權

設定描述
端口 Id端口的靜態、唯一識別碼。
端口型別顯示端口型別及其用途的描述。
端口描述一個可選欄位，用於提供端口及其在流中的角色的自由格式描述。
首次使用時，點選連線按鈕可透過儲存服務對端口進行身分驗證。系統會將您重新導向到站點登入門戶。提供帳戶憑據後，身分驗證權杖會傳回到 知行之橋 並儲存以供重複使用。

​
上傳

上傳到遠端儲存時的相關設定。

​
下載

從遠端儲存下載時的相關設定。

​
快取

與在多次下載之間快取和比較檔案相關的設定。

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

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

When you enable caching, the file names are case-insensitive. For example, the connector cannot distinguish between TEST.TXT and test.txt.

​
進階頁面 (Advanced Tab)

​
進階設定

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

​
代理設定

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

設定描述
代理型別基於代理的防火牆使用的協議。
代理主機基於代理的防火牆的名稱或 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。正常的端口用例和功能不需要使用這些設定。

​
自動化頁面 (Automation Tab)

​
自動化設定

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

​
自動化狀態

​
效能

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

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

​
通知索引標籤

​
SLA 索引標籤

​
建立連線

要與 Box 端口建立連線，請使用設定上的連線按鈕跳轉到登入入口網站。在此門戶中輸入帳戶憑據後，它會向端口傳回身分驗證權杖。僅在端口首次連線到儲存服務時需要執行此過程。

​
上傳和下載

​
上傳

要上傳檔案，請將設定頁面中上傳部分的遠端資料夾設定為檔案應上傳到的資料夾。每個 Box 端口只上傳到單個資料夾位置。 使用覆蓋遠端檔案選項指示應覆蓋還是跳過容器中已存在的檔案。 配置完成後，放置在端口交易索引標籤中的檔案會上傳到遠端儲存。如果啟用了傳送自動化，上傳會自動進行；否則，可以從交易索引標籤傳送單個檔案。

​
下載

要下載檔案，請將設定頁面中下載部分的遠端資料夾設定為應下載檔案的資料夾。使用逗號分隔清單可指定多個資料夾。 使用檔案掩碼設定 glob 過濾器（例如 *.txt），將下載限制為匹配過濾器的檔案。要指定多個過濾器，請使用進階選項卡上的接收過濾器選項。 使用刪除指定是否從遠端儲存中移除已成功下載的檔案。 配置完成後，檔案會根據接收自動化設定下載，也可以在交易索引標籤上手動點選接收按鈕。

​
宏

​
範例