n8n Form Trigger 节点#

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

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

构建和测试工作流#

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

有两种测试方法：

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

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

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

仅适用于生产环境

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

使用查询参数时，请对使用特殊字符的任何字段名称或值进行百分比编码。这确保 n8n 为给定字段使用初始值。您可以使用像 URL Encode/Decode 这样的工具来使用百分比编码格式化查询参数。

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

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

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

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

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

要配置此凭证，您需要：

Form Trigger 节点有两个 URL：测试 URL 和生产 URL。n8n 在节点面板顶部显示这些 URL。选择测试 URL 或生产 URL 来切换 n8n 显示的 URL。

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

为表单设置自定义段。

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

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

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

每个字段都有以下设置：

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