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

核心功能

  • 具有存取金鑰 (Access Key) 和 SAS 權杖 (SAS Token) 身分驗證的雲端儲存整合
  • 具有上傳/下載能力的基於容器的檔案組織
  • 用於選擇性操作的檔案過濾和掩碼
  • 針對上傳檔案的覆蓋保護和刪除管理
  • 可選的快取功能,確保僅下載新增或更新的檔案
  • 向 After Send 事件公開已上傳 Blob 的遠端路徑,並將其作為訊息標頭提供

概覽

Azure Blob 端口可連線到指定的 Microsoft Azure 儲存帳戶。在遠端儲存中,將單個容器設定為上傳目標,並將容器清單設定為下載目標。 在 知行之橋 工作流程中到達 Azure Blob 端口的檔案會被上傳到上傳目標容器,下載目標容器中的檔案會被下載並進入 知行之橋 工作流程。端口支援上傳和下載過濾器,以便僅傳送和接收特定檔名和/或副檔名。

端口配置

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

設定

授權

用於存取 Azure Blob 服務的 Azure 帳戶相關設定。

傳送

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

接收

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

快取

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

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

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

啟用快取時,檔名不區分大小寫。例如,端口無法區分 TEST.TXT 和 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 索引標籤

建立連線

建立與 Azure Blob 服務的連線需要 Azure 帳戶憑據:
  • 帳號
  • AccessKey
使用測試連線按鈕驗證提供的帳戶資訊是否有效。

傳送和接收

傳送

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

After Send 事件

上傳成功後,端口會將已上傳 Blob 的位置作為以下輸入提供給 After Send 事件: 該值由容器名稱加上 Blob 名稱組成,例如 /mycontainer/folder/example.xml。路徑一律以單一正斜線開頭,並使用正斜線作為分隔符號。容器名稱中的所有前導或尾端斜線都會被移除,容器名稱中的宏也會被解析。路徑不會進行 URL 編碼,因此空格、括號等字元會依其在檔名中的原樣顯示。 RemotePath 僅在 After Send 事件中可用。由於上傳尚未發生,Before Send 事件中不存在該輸入。 以下指令碼將每個已上傳 Blob 的遠端路徑寫入應用程式日誌:

RemotePath 標頭

上傳成功後,端口還會在輸出訊息中新增 RemotePath 標頭。該標頭包含的值與 After Send 事件接收到的值相同,您可以在訊息詳細資料的其他標頭下檢視。 由於該標頭是訊息的一部分,連接在成功路徑上的下游端口可以讀取它。若要顯示成功路徑,請在工作流程中以滑鼠右鍵按一下 Azure Blob 端口,然後選擇顯示成功路徑。下游端口可以使用該標頭記錄 Blob 的儲存位置或據此執行操作,而無需根據端口設定重新建構路徑。例如,成功路徑上的 Script 端口可以將該路徑傳遞給稍後擷取該檔案的後端處理程序。
RemotePath 輸入和標頭僅在上傳成功後設定。如果上傳失敗,則不會設定。

接收

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

宏

範例