工作流介紹
將從 CocktailDB API 收到的 JSON 資料轉換為 XML
此 N8n 工作流程範本旨在從 TheCocktailDB 公開 API 以 JSON 格式擷取隨機雞尾酒資料,並使用內建的資料轉換功能將其轉換為 XML 格式。此工作流程展示了一個簡單而實用的整合與資料轉換管道,非常適合需要將 REST API 的 JSON 回應轉換為 XML 以供需要或偏好 XML 式資料的下游系統使用的使用者。
工作流程功能
此工作流程在手動執行時啟動,發送 HTTP GET 請求以從 TheCocktailDB API 擷取隨機雞尾酒的詳細資訊,然後將返回的 JSON 回應轉換為 XML 文件。這使得現代 JSON 式 API 與使用 XML 的舊版或企業系統之間能夠實現無縫互通。
主要功能與能力
- 手動觸發執行: 工作流程僅在手動觸發時執行,適合隨需應變的資料擷取。
- HTTP 請求整合: 直接連接到即時公開的 REST API,無需驗證。
- 資料格式轉換: 使用 n8n 中的原生 XML 節點將結構化 JSON 轉換為格式正確的 XML。
- 輕量級且可重複使用: 最少的節點設定使此工作流程易於理解、修改並在較大的工作流程中重複使用。
- 無外部依賴: 僅依賴 n8n 的核心節點 — 手動觸發器、HTTP 請求和 XML — 確保跨 n8n 環境的相容性。
主要節點及其用途
-
點擊「執行」時 (手動觸發節點)
- 用途: 作為工作流程的起點。
- 功能: 等待使用者點擊 n8n 介面中的「執行工作流程」按鈕以開始處理。
- 類型:
n8n-nodes-base/manualTrigger
-
HTTP 請求節點
- 用途: 從外部 API 擷取即時雞尾酒資料。
- 功能: 向
https://www.thecocktaildb.com/api/json/v1/1/random.php發送 GET 請求,該請求以 JSON 格式返回隨機雞尾酒(例如,名稱、配料、說明、圖片)。 - 類型:
n8n-nodes-base/httpRequest - 關鍵參數: URL 設定為 CocktailDB 的隨機飲品端點。
-
XML 節點
- 用途: 將傳入的 JSON 負載轉換為 XML 格式。
- 功能: 在
"jsonToXml"模式下運行,將 HTTP 請求返回的結構化 JSON 轉換為有效的 XML 字串。 - 類型:
n8n-nodes-base/xml - 模式:
jsonToxml— 確保從 JSON 到 XML 的單向轉換。
使用案例與優勢
- 系統整合: 當與僅接受 XML 輸入的舊版系統或第三方工具整合時非常有用(例如,舊的 ERP、CMS 或 EDI 系統)。
- 資料標準化: 實現跨異質環境的資料格式標準化。
- 原型設計與測試: 非常適合開發人員測試 API 回應或建置涉及格式轉換的概念驗證整合。
- 學習工具: 對於學習 n8n 如何處理 API 調用和資料轉換的初學者來說非常棒。
- 自動化準備: 可以擴展以通過 Webhook 或排程自動觸發,並將轉換後的 XML 饋送到電子郵件、檔案儲存或訊息佇列。
工作流程邏輯步驟
-
步驟 1:工作流程啟動
- 使用者通過點擊「執行」按鈕手動執行工作流程。
- 手動觸發節點啟動並將控制權傳遞給下一個節點。
-
步驟 2:擷取雞尾酒資料
- HTTP 請求節點向
https://www.thecocktaildb.com/api/json/v1/1/random.php發送 GET 請求。 - API 以包含隨機選擇的雞尾酒詳細資訊的 JSON 物件進行回應,包括其名稱、配料、份量、說明等。
- HTTP 請求節點向
-
步驟 3:將 JSON 轉換為 XML
- JSON 回應被傳遞到 XML 節點。
- 該節點處理 JSON 結構並將其轉換為等效的 XML 表示。
- 例如,JSON 欄位如
{"strDrink": "Margarita"}將在根<root>元素(預設,除非自訂)內變為<strDrink>Margarita</strDrink>。
-
輸出
- 最終輸出是一個格式化的 XML 字串,反映了原始 JSON 資料。
- 此 XML 可用於後續節點,如 File Binary、Email 或 Webhook Responders,以進行進一步處理或傳遞。
此工作流程例證了 n8n 在處理 API 整合和資料轉換方面的強大功能,只需最少的配置,對技術和非技術使用者都易於使用。
使用方法:下載 JSON 檔案,然後在 n8n 中選擇「從檔案匯入」。