Skip to content

n8n 表单触发节点

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

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

构建和测试工作流程

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

有两种测试方法：

  • 选择“测试步骤” 。n8n 打开表单。提交表单后，n8n 会运行该节点，但不会运行其余工作流。
  • 选择“测试工作流” 。n8n 打开表单。提交表单后，n8n 将运行该工作流。

生产工作流程

工作流程准备就绪后，请切换到使用生产 URL 。然后，您可以激活工作流程，并且 n8n 会在用户提交表单时自动运行该工作流程。

使用生产 URL 时，请确保已保存并激活工作流。流经表单触发器的数据在编辑器 UI 中与生产 URL 不可见。

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

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

仅用于生产

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

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

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

  • 生产网址：
  • 字段
    • ：：：
    • ​

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

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

这里，百分号编码将 at 符号 ( ) 替换为字符串，将空格字符 ( ) 替换为字符串。无论这些字段出现在表单的哪个页面上，这都会设置它们的初始值。

节点参数

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

验证

  • 基本身份验证
  • 没有任何

使用基本身份验证

要配置此凭据，您需要：

  • 您用于访问 HTTP 请求所针对的应用程序或服务的用户名。
  • 与该用户名对应的密码。

表单 URL

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

表单 URL 的屏幕截图

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

表单路径

为表单设置自定义 slug。

表单标题

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

表单描述

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

表单元素

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

每个字段都有以下设置：

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

何时回复

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

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

节点选项

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

  • 附加 n8n 属性：关闭以隐藏表单底部使用 n8n 属性自动化的表单。
  • 表单响应：选择用户提交表单时如何响应。
    • 响应方式
    • >
    • 表单提交文本
    • ：向用户显示一条消息。
    • 响应方式
    • >
    • 重定向 URL
    • ：将用户发送到新页面。
  • 忽略机器人：打开后忽略来自链接预览器和网络爬虫等机器人的请求。
  • 使用工作流时区：启用此选项可使用工作流设置中的时区，而非 UTC（默认）。这会影响节点输出中时间戳的值。

模板和示例

没有任何