將 Zammad 資料匯出為結構化的 Excel 檔案 - n8n 工作流程

需要定期備份或遷移 Zammad 資料的系統管理員。
需要稽核或回報 Zammad 使用者、角色和群組分配情況的資料分析師。
想找能展示複雜資料處理和多路徑運算的實用 n8n 範本的 n8n 使用者。
需要使用自動化的 n8n 節點組合來擷取設定資料的開發人員。

管理 Zammad 資料，特別是為了稽核或大量報表製作時，通常需要匯出重要的物件，例如使用者和角色。這個完整的 n8n 工作流程提供單一的自動化執行路徑，解決了繁瑣的手動匯出問題。它會同時擷取四種主要資料類型——使用者、組織、角色和群組——並使用專用的 Zammad n8n 節點連線和靈活的 HTTP 請求。

這個 n8n 範本的核心價值在於其平行處理能力和資料標準化。在擷取原始資料後，專用的「Set」n8n 節點操作會清理並標準化每種物件類型的輸出（例如，為使用者對應群組 ID 並合併角色 ID）。最後，乾淨的資料流會直接轉換成獨立、可立即使用的 XLSX 檔案，展現了檔案轉換 n8n 節點的有效應用。

此 n8n 工作流程從「Manual Trigger」n8n 觸發器開始，允許依需求執行。

1. 變數設定： 流程首先使用一個「Set」n8n 節點（'Basic Variables'）來定義 zammadbaseurl 和 zammadapikey。這些變數對於後續的 HTTP Request 節點至關重要。


2. 平行資料擷取： n8n 工作流程會分成四個平行分支來擷取資料：

1. 資料結構化： 四個專用的「Set」n8n 節點操作（例如，'Zammad Univeral User Object'）用來標準化擷取到的 JSON 資料。舉例來說，User Set 節點會將 role IDs 和 group IDs 的陣列整合成乾淨的字串欄位，讓資料更適合在試算表中查看。


2. 流程控制： 使用佔位符的「If」n8n 節點閘門，確保在繼續操作前資料確實存在。此 n8n 範本中包含這些節點是為了方便自訂，讓使用者可以實作特定的篩選條件（例如，只匯出啟用中的使用者）。


3. 檔案轉換： 最後，四個「Convert to File」n8n 節點操作會將每個結構化的資料流轉換成對應的 XLSX 檔案（ZammadUsers.xslx、ZammadOrganizations.xlsx 等），利用這個高效率的 n8n 工作流程結構完成完整自動化。

若要部署此 n8n 工作流程，請遵循以下步驟：

1. 匯入： 複製提供的 JSON 代碼，並在您的 n8n 實例中，使用「New」選單並選擇「Import from JSON」直接匯入。


2. Zammad 憑證設定： 此 n8n 工作流程使用兩種方式連接 Zammad：

1. 測試： 使用「Test workflow」按鈕執行 n8n 工作流程。產生的 XLSX 檔案將在最後的「Convert to Excel」n8n 節點步驟的輸出中可見。

Manual Trigger (n8n 觸發器)： 手動啟動整個資料匯出流程。
Basic Variables (Set n8n 節點)： HTTP 請求的必要設定。它會將 Zammad 的基礎 URL 和 API 金鑰安全地注入為流程變數（zammadbaseurl, zammadapikey），供後續的 HTTP Request n8n 節點步驟使用。
Get all Users / Get all Organizations (Zammad n8n 節點)： 使用專用的 Zammad 憑證，透過 getAll 操作擷取所選資源的所有項目。
Get all Roles / Get all Groups (HTTP Request n8n 節點)： 使用動態 URL 和持有者令牌 (Bearer Token) 身份驗證來獲取角色和群組資料，並從 Basic Variables n8n 節點設定中讀取數值。
Zammad Univeral User Object (Set n8n 節點)： 轉換原始使用者資料。關鍵設定包含使用 JSON 表達式 ={{ $json.roleids.join() }} 將 roleids 和 groupids 陣列對應到以逗號分隔的字串中。
Filter X if needed (If n8n 節點)： 用作標準的流程控制閘門。目前設定為檢查輸入物件是否存在，作為直通 (passthrough)，但已準備好進行自訂篩選邏輯。

• Convert to Excel X (Convert to File n8n 節點)： 此 n8n 工作流程的最後動作。它會接收標準化的 JSON 陣列並輸出為 XLSX 檔案，指定如 ZammadUsers.xslx 和 Zammad_Roles.xlsx 等唯一檔案名稱。