n8n Form Trigger 节点#

使用 n8n Form trigger 在用户提交表单时启动工作流，获取表单的输入数据。该节点为您生成表单网页供使用。

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

构建和测试工作流#

在构建或测试工作流时，使用 Test URL。使用测试 URL 确保您可以在编辑器 UI 中查看传入数据，这对调试很有用。

有两种测试方法：

选择 Test Step。n8n 打开表单。当您提交表单时，n8n 运行该节点，但不运行工作流的其余部分。
选择 Test Workflow。n8n 打开表单。当您提交表单时，n8n 运行工作流。

生产工作流#

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

使用生产 URL 时，确保您已保存并激活工作流。使用生产 URL 时，通过 Form trigger 流动的数据在编辑器 UI 中不可见。

使用查询参数设置默认选择#

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

仅适用于生产环境

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

使用查询参数时，需要对使用特殊字符的字段名称或值进行百分号编码。这确保 n8n 使用给定字段的初始值。您可以使用 URL Encode/Decode 等工具使用百分号编码格式化查询参数。

例如，假设您有一个具有以下属性的表单：

生产 URL：https://my-account.n8n.cloud/form/my-form
字段：
- name：Jane Doe
- email：[email protected]

使用查询参数和百分号编码，您可以使用以下 URL 将初始字段值设置为上述数据：

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

这里，百分号编码将 @ 符号（@）替换为字符串 %40，将空格字符（）替换为字符串 %20。这将为这些字段设置初始值，无论它们出现在表单的哪个页面上。

节点参数#

这些是主要的节点配置字段：

Authentication 身份验证#

Basic Auth
None

使用基本身份验证#

要配置此凭据，您需要：

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

Form URLs 表单 URL#

Form Trigger 节点有两个 URL：Test URL 和 Production URL。n8n 在节点面板顶部显示 URL。选择 Test URL 或 Production URL 切换 n8n 显示的 URL。

测试 URL：如果工作流未激活，当您选择执行步骤或执行工作流时，n8n 注册一个测试网络钩子。当您调用 URL 时，n8n 在工作流中显示数据。
生产 URL：当您激活工作流时，n8n 注册一个生产网络钩子。使用生产 URL 时，n8n 不会在工作流中显示数据。您仍然可以查看生产执行的工作流数据。在工作流中选择执行选项卡，然后选择您要查看的工作流执行。

表单路径#

为表单设置自定义路径。

表单标题#

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

表单描述#

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

表单元素#

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

每个字段都有以下设置：

字段标签：输入在输入字段上方显示的标签。
元素类型：从复选框、自定义 HTML、日期、下拉列表、电子邮件、文件、隐藏字段、数字、密码、单选按钮、文本或文本区域中选择。
- 选择复选框以在表单中包含复选框元素。默认情况下，表单用户可以选择的复选框数量没有限制。您可以通过为限制选择选项指定值为确切数字、范围或无限制来设置限制。
- 选择自定义 HTML 以插入任意 HTML。
  - 您可以包含链接、图像、视频等元素。您不能包含 <script>、<style> 或 <input> 元素。
  - 默认情况下，自定义 HTML 字段不包含在节点输出中。要在输出中包含自定义 HTML 内容，请填写关联的元素名称字段。
- 选择日期以在表单中包含日期选择器。有关格式化日期的更多信息，请参考使用 Luxon 处理日期和时间。
- 选择下拉列表 > 添加字段选项以添加多个选项。默认情况下，下拉列表是单选的。要使其支持多选，请开启多选。
- 选择单选按钮以在表单中包含单选按钮元素。
- 选择隐藏字段以包含不在表单上显示的表单元素。您可以使用字段值参数设置默认值，或使用查询参数传递字段的值。
必填字段：开启以要求用户在表单上完成此字段。

Respond When#

Choose when n8n sends a response to the form submission. You can respond when:

Form Is Submitted 表单已提交：用户提交表单后立即向其发送响应。
Workflow Finishes 工作流完成：如果您希望工作流完成执行后再向用户发送响应，请使用此选项。如果工作流出错，它会向用户发送响应，告诉他们提交表单时出现问题。

节点选项#

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

Append n8n Attribution 附加 n8n 归属: 关闭以隐藏表单底部的 Form automated with n8n 属性。
Button Label 按钮标签: 用于表单提交按钮的标签。n8n 将 Button Label 按钮标签 显示为提交按钮的名称。
Form Path 表单路径: 表单 URL 的最后一段，用于测试和生产。替换自动生成的 UUID 作为最终组件。
Ignore Bots 忽略机器人: 打开以忽略来自机器人的请求，如链接预览器和网络爬虫。
Use Workflow Timezone 使用工作流时区: 打开以使用工作流设置中的时区而不是 UTC（默认）。这会影响节点输出中 submittedAt 时间戳的值。
Custom Form Styling 自定义表单样式: 使用 CSS 覆盖公共表单界面的默认样式。该字段预填充默认样式，因此您只需更改所需的内容。