n8n 表單觸發(Form Trigger)(17):用表單啟動工作流程——測試/生產、預填參數與驗證一次到位

想用一個可分享的網頁表單,直接把資料送進自動化流程?n8n 表單觸發節點(Form Trigger)能在使用者提交時啟動工作流程並帶入輸入值;如果表單要分頁,還能接續 n8n Form 節點擴充頁面。


開發時,用 Test URL 在編輯器中即時看到傳入資料(方便除錯);上線後改用 Production URL記得儲存並啟用工作流程,資料改到 Executions 內查看。

你也能以查詢參數預填欄位(僅限生產模式,且需百分比編碼),並用 Basic Auth 保護表單端點。Form Path/Title/Description 可自訂品牌化呈現(Description 支援 \n 換行)。

online form interface with submit button in a workflow automation context

n8n 表單觸發節點(n8n Form Trigger node)

使用 n8n 表單觸發節點在用戶提交表單時啟動工作流程,從表單獲取輸入數據。該節點為您生成表單網頁供使用。

您可以使用 n8n 表單節點添加更多頁面來繼續表單。

構建和測試工作流程

在構建或測試工作流程時,使用測試 URL(Test URL)。使用測試 URL 可確保您可以在編輯器 UI 中查看傳入數據,這對調試很有用。

測試方法一

選擇「執行步驟」(Execute Step)。n8n 打開表單。當您提交表單時,n8n 運行節點,但不運行工作流程的其餘部分。

測試方法二

選擇「執行工作流程」(Execute Workflow)。n8n 打開表單。當您提交表單時,n8n 運行工作流程。

生產工作流程

當您的工作流程準備就緒時,切換到使用生產 URL(Production URL)。然後,您可以激活工作流程,當用戶提交表單時,n8n 會自動運行它。

使用生產 URL 時,請確保您已保存並激活工作流程。使用生產 URL 時,流經表單觸發器的數據在編輯器 UI 中不可見。

使用查詢參數設置默認選擇

您可以通過使用查詢參數(query parameters)與 n8n 表單觸發器提供的初始 URL 來設置字段的初始值。表單中的每個頁面都會接收發送到 n8n 表單觸發器 URL 的相同查詢參數。

查詢參數僅在生產模式下使用表單時可用。n8n 在測試模式下不會從查詢參數填充字段值。

使用查詢參數時,對使用特殊字符的任何字段名稱或值進行百分比編碼(percent-encode)。這確保 n8n 使用給定字段的初始值。

testing interface showing form preview and execution options

查詢參數示例

假設您有一個具有以下屬性的表單:

  • 生產 URL:https://my-account.n8n.cloud/form/my-form
  • 字段:
    • name: Jane Doe
    • email: jane.doe@example.com

使用查詢參數和百分比編碼,您可以使用以下 URL 將初始字段值設置為上述數據:

https://my-account.n8n.cloud/form/my-form?email=jane.doe%40example.com&name=Jane%20Doe

在這裡,百分比編碼將 at 符號 (@) 替換為字符串 %40,將空格字符 ( ) 替換為字符串 %20。無論這些字段出現在表單的哪個頁面上,這都將設置這些字段的初始值。

authentication settings interface for form configuration

表單觸發節點參數 – 身份驗證(Authentication)

基本身份驗證(Basic Auth)

要配置此憑據,您需要:

  • 用戶名(Username):您用於訪問 HTTP 請求目標的應用程序或服務的用戶名
  • 密碼(Password):與該用戶名相匹配的密碼

無(None)

不使用任何身份驗證方法

表單觸發節點參數 – 表單 URL

表單觸發節點有兩個 URL:測試 URL(Test URL)生產 URL(Production URL)。n8n 在節點面板頂部顯示 URL。選擇「測試 URL」或「生產 URL」以切換 n8n 顯示的 URL。

測試 URL

當您選擇「執行步驟」或「執行工作流程」時,如果工作流程未激活,n8n 會註冊測試 webhook。當您調用 URL 時,n8n 在工作流程中顯示數據。

生產 URL

當您激活工作流程時,n8n 會註冊生產 webhook。使用生產 URL 時,n8n 不會在工作流程中顯示數據。您仍然可以查看生產執行的工作流程數據。選擇工作流程中的「執行」選項卡,然後選擇要查看的工作流程執行。

表單觸發節點參數 – 基本設置

表單路徑(Form Path)

為表單設置自定義 slug。

表單標題(Form Title)

輸入表單的標題。n8n 將表單標題顯示為網頁標題和表單上的主要 h1 標題。

表單描述(Form Description)

輸入表單的描述。n8n 將表單描述顯示為表單上主要 h1 標題下方的副標題。使用 \n 或添加換行符。

總結

  • 開發 & 測試
    • Test URL
      • Execute Step:只跑節點、方便看 payload。
      • Execute Workflow:整條流程一起跑。
  • 上線 & 觀測
    • 切換 Production URL啟用工作流程;資料在 Executions 檢視。
    • 需要權限保護就選 Basic Auth(Username/Password)。
  • 預填欄位(僅生產模式)
    • 以查詢參數預設值:...?email=jane.doe%40example.com&name=Jane%20Doe
    • 百分比編碼特殊字元;多頁表單會共用同一組查詢參數。
  • 表單設定重點
    • 自訂 Form Path(slug)、Form Title(頁標題 / h1)、Form Description(副標,支援換行)。
    • 表單要分頁?在後續串接 n8n Form 節點
  • 實務心法
    • 線上表單建議加入基本防濫用設計(身分驗證/節流/伺服端驗證)。
    • 若需「提交後等待核准/回覆」的長流程,改用 Wait → On Form Submitted 中段暫停再續跑。
    • 異常時先檢查:是否啟用、是否打到正確 Production URL、slug 是否唯一、執行紀錄是否有錯。

把 Form Trigger 放在入口,你就能用一個 URL 收集資料、直接觸發自動化,從測試到上線一路順暢。

發佈留言

發佈留言必須填寫的電子郵件地址不會公開。 必填欄位標示為 *

返回頂端