n8n 表单触发器节点#

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

您可以通过 n8n 表单节点添加更多页面来扩展表单功能。

构建和测试工作流#

在构建或测试工作流时，请使用测试 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
字段:
- 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。这将为这些字段设置初始值，无论它们出现在表单的哪个页面。

节点参数#

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

认证方式#

Basic Auth (基础认证)
None (无认证)

使用基础认证#

配置此凭据需要以下信息：

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

表单 URL#

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

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

表单路径#

为表单设置自定义 slug（URL 路径段）。

表单标题#

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

表单描述#

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

表单元素#

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

每个字段都有以下设置：

字段标签：输入显示在输入框上方的标签文字。
元素类型：可选择自定义HTML、日期、下拉列表、邮箱、文件、隐藏字段、数字、密码、文本或文本区域。
- 选择自定义HTML可插入任意HTML内容。
  - 可以包含链接、图片、视频等元素。但不能包含<script>、<style>或<input>元素。
  - 默认情况下，自定义HTML字段不会包含在节点输出中。如需在输出中包含HTML内容，请填写对应的元素名称字段。
- 选择日期可在表单中添加日期选择器。有关日期格式化的更多信息，请参考使用Luxon处理日期和时间。
- 选择下拉列表 > 添加字段选项可添加多个选项。默认情况下下拉列表是单选模式。启用多选可切换为多选模式。
- 选择隐藏字段可在表单中包含但不显示该元素。您可以通过字段值参数设置默认值，或使用查询参数传递字段值。
必填字段：启用后要求用户必须填写该字段才能提交表单。

响应时机#

选择n8n何时对表单提交作出响应。您可以选择：

表单提交时：用户提交表单后立即发送响应。
工作流完成时：如果您希望工作流执行完毕后再发送响应给用户。如果工作流出错，会向用户发送表单提交失败的响应信息。

节点选项#

点击 添加选项 查看更多配置选项：

附加 n8n 归属声明：关闭可隐藏表单底部的 由 n8n 自动生成 声明。
表单响应：选择用户提交表单后的响应方式。
- 响应方式 > 表单提交文本：向用户显示消息。
- 响应方式 > 重定向 URL：将用户跳转到新页面。
忽略机器人：开启可忽略来自链接预览器和网络爬虫等机器人的请求。
使用工作流时区：开启后使用工作流设置中的时区而非默认的 UTC 时区。这将影响节点输出中 submittedAt 时间戳的值。