等待#
使用Wait节点暂停工作流的执行。当工作流暂停时,它会将执行数据卸载到数据库中。当满足恢复条件时,工作流会重新加载数据并继续执行。
操作#
等待节点可以在以下条件下恢复:
- 时间间隔后: 该节点会等待指定的时间长度。
- 在指定时间: 该节点会等待直到特定时间。
- On Webhook Call: 该节点会一直等待,直到收到HTTP调用。
- 表单提交时: 该节点会等待直到接收到表单提交。
请参考以下更详细的章节以获取更详细的说明。
时间间隔后#
等待一定的时间。
该参数包含以下两个字段:
- 等待时长: 输入需要等待的时间量。
- Wait Unit: Select the unit of measure for the Wait Amount. Choose from:
- 秒
- 分钟
- 小时
- 天数
有关这些间隔如何工作以及使用时区的更多详细信息,请参阅基于时间的操作。
在指定时间#
等待直到特定日期和时间再继续。使用日期和时间选择器设置日期和时间。
有关使用时区的更多详情,请参阅基于时间的操作。
当Webhook被调用时#
该参数允许您的工作流在Wait节点收到HTTP调用时恢复执行。
用于在调用时恢复执行的Webhook URL是在运行时生成的。Wait节点提供了$execution.resumeUrl变量,以便您可以引用并发送这个尚未生成的URL到任何需要的地方,例如发送给第三方服务或包含在电子邮件中。
当工作流执行时,等待节点会使用$execution.resumeUrl生成恢复URL和工作流中的webhook。这个生成的URL对每次执行都是唯一的,因此您的工作流可以包含多个等待节点,当webhook URL被调用时,它将依次恢复每个等待节点。
对于这种恢复样式,请设置下面列出的更多参数。
认证#
选择是否以及如何对发送到$execution.resumeUrl的恢复webhook请求进行身份验证。选项包括:
- Basic Auth: 使用基础认证。选择或输入一个新的Basic Auth凭证来使用。
- Header Auth: 使用头部认证。选择或输入一个新的Header Auth凭证来使用。
- JWT认证: 使用JWT认证。选择或输入新的JWT认证凭据来使用。
- None: 不使用身份验证。
认证参考
有关每种认证类型的更多信息,请参阅Webhook节点 | 认证文档。
HTTP 方法#
选择webhook应使用的HTTP方法。更多信息请参考Webhook节点 | HTTP方法文档。
响应代码#
输入webhook应返回的响应代码。您可以使用常见代码或输入自定义代码。
响应#
从以下选项设置何时以及如何响应webhook:
- 立即: 节点执行后立即响应。
- When Last Node Finishes: Return the response code and the data output from the last node executed in the workflow. If you select this option, also set:
- Response Data: Select what data should be returned and what format to use. Options include:
- 所有条目: 返回最后一个节点的所有条目,以数组形式呈现。
- First Entry JSON: 返回JSON对象中最后一个节点的第一个条目的JSON数据。
- First Entry Binary: 返回二进制文件中最后一个节点的第一个条目的二进制数据。
- 无响应体: 返回时不包含响应体。
- Response Data: Select what data should be returned and what format to use. Options include:
- 使用'响应Webhook'节点: 按照响应Webhook节点中的定义进行响应。
限制等待时间#
设置工作流是否会在特定限制类型后自动恢复执行(开启)或不自动恢复(关闭)。如果开启,还需设置:
- Limit Type: Select what type of limit to enforce from these options:
- After Time Interval: Wait for a certain amount of time.
- 输入限制的时间量。
- 选择限制的时间单位。
- At Specified Time: Wait until a specific date and time to resume.
- 最大日期和时间: 使用日期和时间选择器设置节点应恢复的指定时间。
- After Time Interval: Wait for a certain amount of time.
关于Webhook调用选项#
- 二进制属性: 输入要写入接收文件数据的二进制属性名称。仅当接收到二进制数据时此选项才相关。
- 忽略机器人: 设置是否忽略来自机器人(如链接预览器和网络爬虫)的请求(开启)或不忽略(关闭)。
- IP白名单: 在此输入IP地址以限制谁(或什么)可以调用webhook URL。输入以逗号分隔的允许IP地址列表。来自白名单之外的IP访问将抛出403错误。如果留空,则所有IP地址均可调用webhook URL。
- 无响应体: 设置n8n是否应在响应中发送响应体(关闭)或阻止n8n在响应中发送响应体(开启)。
- Raw Body: 设置是否以原始格式(如JSON或XML)返回响应体(开启)或不返回(关闭)。
- 响应数据: 输入您想在响应中发送的任何自定义数据。
- 响应头信息: 在webhook响应中发送更多头部信息。参考MDN Web Docs | Response header了解更多关于响应头的内容。
- Webhook后缀: 输入要附加到恢复URL的后缀。当工作流包含多个等待节点时,这有助于为每个等待节点创建唯一的webhook URL。请注意,生成的
$resumeWebhookUrl不会自动包含此后缀,您必须在公开webhook URL前手动将其附加到URL中。
关于Webhook调用的限制#
使用On Webhook Call时需要注意一些限制:
- 工作流的部分执行会改变
$resumeWebhookUrl,因此请确保将URL发送给所需第三方的节点与Wait节点在同一执行中运行。
表单提交时#
在继续之前等待表单提交。设置以下参数:
表单标题#
输入要在表单顶部显示的标题。
表单描述#
输入表单描述以显示在标题下方。此描述可以帮助提示用户如何填写表单。
表单字段#
使用以下参数设置您希望在表单上显示的每个字段:
- 字段标签: 输入您希望在表单中显示的字段标签。
- Field Type: Select the type of field to display in the form. Choose from:
- 日期
- Dropdown List: Enter each dropdown options in the Field Options.
- 多项选择: 选择用户是否可以单选下拉选项(关闭)或多选下拉选项(开启)
- 数字
- 密码
- 文本
- 文本区域
- 必填字段: 设置用户是否必须填写此字段才能提交表单(开启),或者用户可以不填写直接提交表单(关闭)。
响应时机#
设置何时响应表单提交。可选选项:
- 表单提交时: 当此节点收到表单提交时立即响应。
- 工作流完成: 当此工作流的最后一个节点完成时响应。
- 使用'响应Webhook'节点: 当响应Webhook节点执行时进行响应。
限制等待时间#
设置工作流是否会在特定限制类型后自动恢复执行(开启)或不自动恢复(关闭)。
如果开启,还需设置: * 限制类型: 从以下选项中选择要执行的限制类型: * 时间间隔后: 等待一定时间。 * 输入限制的时间量。 * 选择限制的时间单位。 * 指定时间: 等待到特定日期和时间再继续。 * 最大日期和时间: 使用日期和时间选择器设置节点应恢复的指定时间。
表单响应选项#
- Form Response: Choose how and what you want the form to Respond With from these options:
- 表单提交后显示的文本: 用户填写完表单后,表单会显示在要显示的文本中输入的任意内容。如果想显示确认消息,请使用此选项。
- 重定向URL: 表单在用户填写完成后会将用户重定向至目标重定向URL。该URL必须有效。
- Webhook后缀: 输入要附加到恢复URL的后缀。当工作流包含多个等待节点时,这有助于为每个等待节点创建唯一的webhook URL。请注意,生成的
$resumeWebhookUrl不会自动包含此后缀,您必须在公开webhook URL前手动将其附加到URL中。
模板和示例#
基于时间的操作#
对于基于时间的恢复操作,请注意:
- 对于等待时间少于65秒的情况,工作流不会将执行数据卸载到数据库。相反,进程会继续运行,并在指定间隔时间过后恢复执行。
- 无论时区设置如何,始终使用n8n服务器时间。工作流时区设置及其任何更改都不会影响等待节点的间隔或指定时间。