n8n 表单触发器节点#

使用n8n表单触发器在用户提交表单时启动工作流，并获取表单中的输入数据。该节点会为您生成可用的表单网页。

您可以使用n8n Form节点添加更多页面来继续表单。

构建和测试工作流#

在构建或测试工作流时，请使用测试URL。使用测试URL可确保您能在编辑器界面查看传入数据，这对调试非常有用。

有两种测试方式：

选择测试步骤。n8n将打开表单。提交表单时，n8n会运行该节点，但不会运行工作流的其余部分。
选择测试工作流。n8n将打开表单。当您提交表单时，n8n会运行该工作流。

生产工作流#

当您的工作流准备就绪后，切换到使用生产环境URL。随后您可以激活工作流，当用户提交表单时n8n会自动运行它。

在使用生产环境URL时，请确保已保存并激活工作流。通过表单触发器流动的数据在编辑器界面中不可见（使用生产环境URL时）。

通过查询参数设置默认选项#

您可以通过使用n8n表单触发器提供的初始URL中的查询参数来设置字段的初始值。表单中的每个页面都会接收到发送给n8n表单触发器URL的相同查询参数。

仅限生产环境使用

查询参数仅在生产模式下使用表单时可用。n8n在测试模式下不会从查询参数填充字段值。

使用查询参数时，对包含特殊字符的字段名或值进行百分号编码。这能确保n8n使用这些字段的初始值。您可以使用URL编码/解码等工具通过百分号编码来格式化查询参数。

举个例子，假设你有一个包含以下属性的表单：

生产环境URL: https://my-account.n8n.cloud/form/my-form
Fields:
- 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。无论这些字段出现在表单的哪个页面，这都将设置它们的初始值。

节点参数#

以下是主要的节点配置字段：

认证#

基础认证
无

使用基础认证#

要配置此凭证，您需要：

用于访问HTTP请求目标应用或服务的用户名。
与该用户名对应的密码。

表单URL#

表单触发器节点有两个URL：测试URL和生产URL。n8n会在节点面板顶部显示这些URL。选择测试URL或生产URL可切换n8n显示的URL。

测试URL: 当您选择测试步骤或测试工作流时（如果工作流未激活），n8n会注册一个测试webhook。当您调用该URL时，n8n会在工作流中显示数据。
生产环境URL: 当您激活工作流时，n8n会注册一个生产环境webhook。使用生产环境URL时，n8n不会在工作流中显示数据。您仍可以查看生产环境执行的工作流数据。在工作流中选择执行记录标签页，然后选择您想要查看的工作流执行记录。

表单路径#

为表单设置自定义短链接。

表单标题#

输入您的表单标题。n8n会将表单标题显示为网页标题和表单上的主h1标题。

表单描述#

输入表单的描述。n8n会将表单描述显示为表单主标题h1下方的副标题。使用\n或来添加换行。

表单元素#

为您的表单创建问题字段。选择添加表单元素来添加新字段。

每个字段都有以下设置：

字段标签: 输入显示在输入框上方的标签。
Element Type: Choose from Custom HTML, Date, Dropdown List, Email, File, Hidden Field, Number, Password, Text, or Textarea.
- Select Custom HTML to insert arbitrary HTML.
  - 您可以包含链接、图片、视频等元素。但不能包含
  - By default, Custom HTML fields aren't included in the node output. To include the Custom HTML content in the output, fill out the associated Element Name field.
- 选择日期可在表单中添加日期选择器。有关日期格式的更多信息，请参阅使用Luxon处理日期和时间。
- 选择下拉列表 > 添加字段选项来添加多个选项。默认情况下，下拉列表是单选模式。要启用多选功能，请开启多选选项。
- 选择隐藏字段可在表单中包含一个不显示的表单元素。您可以使用字段值参数设置默认值，或通过查询参数为该字段传递值。
必填字段: 开启后，用户必须在表单中填写此字段。

响应时机#

选择n8n何时发送对表单提交的响应。您可以在以下情况下响应：

表单提交时: 用户提交表单后立即发送响应。
工作流完成: 如果您希望在工作流完成执行后再向用户发送响应，请使用此选项。如果工作流出错，它会向用户发送响应，告知他们提交表单时出现问题。

节点选项#

选择添加选项以查看更多配置选项：

附加n8n标识: 关闭此选项可隐藏表单底部的由n8n自动生成标识。
Form Response: Choose how to respond when the user submits the form.
- 响应方式 > 表单提交文本: 向用户显示一条消息。
- 响应方式 > 重定向URL: 将用户引导至新页面。
忽略机器人: 开启后将忽略来自链接预览器和网络爬虫等机器人的请求。
使用工作流时区: 开启后使用工作流设置中的时区而非UTC(默认)。这会影响节点输出中submittedAt时间戳的值。