Skip to content

循环遍历项目

“循环项目”节点可帮助您在需要时循环数据。

该节点保存原始传入数据,并在每次迭代时通过循环输出返回预定义数量的数据。

当节点执行完成时,它会合并所有处理过的数据并通过done输出返回。

何时使用“循环遍历项目”节点

默认情况下,n8n 节点设计用于处理输入项列表(但也有一些例外情况,详见下文)。根据您想要实现的目标,您通常不需要在工作流程中使用“循环处理项”节点。您可以在 n8n 循环页面上了解更多关于 n8n 如何处理多个项的信息。

这些链接突出显示了“循环项目”节点可能有用的一些情况:

  • 循环直到处理完所有项目:描述“循环项目”节点与正常项目处理的区别以及何时可能想要合并此节点。
  • 节点异常:概述您可能需要使用“循环项目”节点手动构建循环逻辑的特定情况和节点。
  • 避免速率限制:演示如何批量处理 API 请求以避免其他服务的速率限制。

节点参数

批次大小

输入每次调用返回的项目数。

节点选项

重置

如果启用,节点将重置,并在每次循环时使用新初始化的当前输入数据。当您希望“循环项”节点将传入数据视为一组新数据(而非先前项的延续)时,请使用此选项。

例如,当您事先不知道需要多少页时,可以使用带有重置选项的“循环项”节点和“如果”节点来查询分页服务。循环一次查询一个页面,执行任何处理,并递增页码。循环重置确保循环将每次迭代识别为一组新数据。“如果”节点评估退出条件以决定是否执行另一次迭代。

包含有效的终止条件

对于类似上述示例的工作流,为循环添加有效的终止条件至关重要。如果终止条件始终不成立,工作流执行就会陷入无限循环。

启用后,您可以通过将参数表示形式从Fixed切换为Expression来调整重置条件。表达式求值的结果决定了节点何时重置项目处理。

模板和示例

没有任何

从两个不同的来源阅读 RSS 提要

此工作流程允许您使用“循环遍历项目”节点从两个不同的来源读取 RSS 源。您需要在工作流程中使用“循环遍历项目”节点,因为“RSS 源读取”节点仅处理其接收到的第一个项目。您也可以在 n8n.io 上找到此工作流程

本示例将逐步讲解如何构建工作流,但假设您已熟悉 n8n。要构建您的第一个工作流(包括了解如何向工作流添加节点),请参阅试用

最终的工作流程如下:

没有任何

复制上述工作流文件并粘贴到您的实例中,或者按照以下步骤手动构建它:

  1. 添加手动触发器。
  2. 添加代码节点。
  3. 将此代码复制到代码节点中:
  4. 添加循环项目节点。
  5. 配置循环项目:在“批次大小”字段中设置批次大小。
  6. 添加 RSS 提要阅读节点。
  7. 选择“测试工作流” 。这将运行工作流以将数据加载到“RSS 提要读取”节点。
  8. 配置 RSS Feed Read:从输入到URL字段的映射。您可以通过从“输入”面板拖放操作来完成此操作,也可以使用以下表达式: 。
  9. 选择测试工作流来运行工作流并查看结果数据。

检查节点是否已处理所有项目

要检查节点是否仍有项目需要处理,请使用以下表达式: 。此表达式返回一个布尔值。如果节点仍有数据需要处理,则表达式返回,否则返回。

获取节点当前运行索引

要获取节点的当前运行索引,请使用以下表达式: 。