資料怎麼流動
n8n 的基本單位是 item(項目):一筆 JSON 物件。一個節點輸出 10 筆 item,下一節點預設就會處理 10 次。這和「整個陣列當一個變數」的寫法不一樣,也是新手最常卡住的地方。
先看這三個檢視
每個節點輸出都有 Table、JSON、Schema:
- Table:掃欄位名稱與值。
- JSON:看巢狀結構與陣列。
- Schema:看型別(字串、數字、陣列)。
對應欄位時,拖的是「目前這筆 item」上的路徑,例如 email 或 user.name。
一筆變多筆、多筆變一筆
- Split Out:把陣列拆成多筆 item(例如一列逗號分隔的 URL)。
- Aggregate / Edit Fields:把多筆收成一個陣列。
- Loop Over Items:批次大小設 1,就能一筆一筆打外部 API,避免一次送太多。
HTTP Request 若回傳檔案,輸出會出現 binary 分頁,Table 可能是空的。這時要用檔案類節點(壓縮、讀寫磁碟),不要再用一般 JSON 欄位去對。
Pin 與除錯
Pin 會把這次測試的輸出釘在節點上,之後 Test 直接用釘住的資料。生產環境(已啟用)仍會真的執行,不會用 Pin。從失敗的 execution 把資料載回編輯器,等於官方 Advanced 課講的除錯流程。
對照閱讀:表達式與憑證、官方 Data structure
建議先看
官方 Beginner 第 4 集專門講 n8n 如何處理資料;Advanced 第 1 集接著講分支執行順序、Switch、Split 與 Merge。