自訂程式碼批次處理多個二進位檔案的 Base64 編碼 - n8n 工作流程

開發人員：需要將多個檔案上傳到嚴格要求 Base64 編碼的 API。
n8n 使用者：需要超越標準 n8n 節點的高階二進位檔案操作。
自動化專家：正在尋找用於檔案轉換任務的可靠 n8n 範本。
所有有興趣利用 n8n Code 節點處理資料能力的人員。

這個專用的 n8n 工作流程範本解決了一個常見的整合難題：處理包含多個二進位檔案的壓縮封存檔，並將它們轉換為供 API 消費的 Base64 字串。雖然標準的 n8n 節點可以很好地處理單一檔案的 Base64 編碼，但批次處理需要自訂邏輯。此 n8n 工作流程提供了一個可靠的解決方案，結合了檔案下載、解壓縮，以及一個精心設計的 n8n 節點來執行 JavaScript，以迭代已解壓縮的二進位資料並執行必要的編碼。如果您經常處理壓縮資料並需要有效率地轉換內容，這個 n8n 範本是您工具箱中不可或缺的。

整個流程由一個簡單的手動 n8n 觸發器啟動，使其易於測試和部署。

1. 開始：'當點擊「執行工作流程」' (When clicking ‘Execute workflow’) 的 n8n 觸發器開始自動化運行。


2. 下載：HTTP Request n8n 節點下載一個包含待處理檔案的範例 ZIP 檔案。


3. 解壓縮：接著的 Compression (Unzip) n8n 節點會自動處理已下載的二進位檔案，展開內容，並為 ZIP 中找到的每個檔案輸出一個獨立的項目，每個項目都有其自己的二進位資料屬性。


4. 編碼 (自訂程式碼)：核心功能位於 'Encode to base64' Code n8n 節點中。此節點使用自訂 JavaScript 來迭代由 Unzip n8n 節點產生的多個二進位項目。對於每一項，它使用內建的 this.helpers.getBinaryDataBuffer 函式安全地擷取檔案資料作為緩衝區 (buffer)。然後將此緩衝區轉換為 Base64 字串，並將輸出結構化地整理好，以供後續的 n8n 節點使用，提供檔案路徑和編碼後的資料。

若要開始使用這個強大的 n8n 工作流程範本，請遵循以下步驟：

1. 匯入：複製提供的 JSON 資料，然後前往您的 n8n 實例。


2. 點擊「新增」(New)，然後選擇「從 JSON 匯入」(Import from JSON) 並貼上程式碼。


3. 無需憑證：此特定的 n8n 工作流程不需要外部憑證，因為它使用的是公開網址和內建的 n8n 節點（HTTP Request、Code、Manual Trigger）。


4. 執行：點擊「執行工作流程」(Execute Workflow) 的 n8n 觸發器按鈕，立即測試該流程。


5. 自訂：修改 'Download n8n demo website zip' n8n 節點，將其指向您的特定 ZIP 檔案來源 URL，以便根據您的需求調整 n8n 工作流程。如果您的目標 API 需要不同的輸出結構，請相應地調整 Code n8n 節點中的 JavaScript。

此 n8n 工作流程依賴三個主要的 n8n 節點來實現檔案處理和轉換：

當點擊「執行工作流程」(When clicking ‘Execute workflow’) (Manual Trigger n8n Trigger)
功能：作為此隨選 n8n 工作流程的起點。
關鍵設定：無需設定；它作為一個簡單的手動 n8n 觸發器。

下載 n8n 範例網站 zip (Download n8n demo website zip) (HTTP Request n8n Node)
功能：從遠端 GitHub 儲存庫下載來源 ZIP 檔案。這提供了處理所需的二進位資料。
關鍵設定：URL 設定為 https://github.com/n8n-io/n8n-demo-website/archive/refs/heads/main.zip。回應格式 (Response format) 至關重要，設定為 file 以將資料當作二進位處理。

解壓縮 (Unzip) (Compression n8n Node)
功能：解壓縮已下載的 ZIP 檔案。這至關重要，因為它會將單一輸入項目（ZIP 檔）轉換為多個輸出項目（ZIP 中的各個檔案），為下一個 n8n 節點的批次處理做好準備。
關鍵設定：使用解壓縮的預設設定。

編碼為 base64 (Encode to base64) (Code n8n Node)
功能：遍歷由 Unzip n8n 節點產生的所有二進位檔案。它使用自訂 JavaScript 和 n8n 輔助函式 (this.helpers.getBinaryDataBuffer) 來擷取每個檔案的原始緩衝區，然後將該緩衝區轉換為 Base64 字串，並將結果彙編成結構化的 JSON 陣列。
關鍵設定：包含用於 Base64 編碼的自訂邏輯，確保在 n8n 工作流程中的單一步驟內有效處理多個二進位檔案。