循环迭代器是一个变量，用于跟踪循环中的当前迭代。 它用于控制循环执行的次数，并在每次迭代时访问列表或数组中的元素。

例如，如果您正在遍历一个项目列表，循环迭代器将帮助您逐一访问每个项目，直到循环完成。 Loop package 提供了多个迭代器条件来控制循环的迭代。
表 1. 循环迭代器
迭代器 描述
对于 CSV/TXT 中的每一行 为指定 CSV 或文本文件中的每一行重复集合 actions，并将当前行中的值分配给记录变量。 请参阅 使用对于 CSV/TXT 中的每行迭代器。
对于 Data Table 中的每一行 为指定表中的每一行重复集合 actions，并将当前行中的值分配给记录变量。 请参阅 使用对于表中的每行迭代器。
对于 SQL 查询数据集中的每一行 为指定 SQL 查询数据集中的每一行重复集合 actions，并将当前行中的值分配给记录变量。 请提供您用于建立与数据库的连接的会话名称。
对于 Dictionary 中的每个键 为指定的字典变量中的每个键重复集合 actions，并将当前键的名称分配给变量。
注： 当 bot 运行包含 字典 action 放置 > 的 action 的循环 时，bot 只会在字典中的原始项目数上迭代；它将忽略使用 放置 action 插入的项目。
对于 Dictionary 中的每个值 为指定的字典变量中的每个值重复集合 actions，并将当前值分配给变量。 由于此变量类型可以保存各种子类型（字符串、数字、布尔等），因此，如果在配置操作时快速创建变量，则变量是任何类型。
注： 当 bot 运行包含 字典 > 放置 action 的循环 action 时，bot 只会在字典中的原始项目数上迭代；它将忽略使用放置 action 插入的项目。
对于邮箱中的每封邮件 为指定邮箱中的每封电子邮件重复集合 actions。 请参阅 使用“对于邮箱中的每封邮件”迭代器。
对于工作表中的每行（Excel basic 或 Excel advanced） 为工作表中包含数据的每一行重复集合 actions，并将当前行中的值分配给记录变量。 提供您用于打开 Excel basic 或 Excel advanced 工作表的会话名称。 指定是否对所有行、指定行或指定单元格范围重复 actions。 从将当前行分配给此变量列表中选择记录变量或创建新记录变量。 请参阅 记录变量。
此迭代器检索单元格值作为字符串数据类型。 它支持 Excel 单元格格式，包括数字、百分比、货币、科学和日期。 例如，货币格式单元格的值在传递到表或记录变量时保留货币符号。
  • 必须转换值才能执行非字符串操作。
  • 在 Excel advanced 中，当您选择循环迭代器作为对于工作表中的每行时，您有一个读取选项可读取单元格的可见文本或值。

    例如，如果单元格的单元格内容为 70%，读取单元格值选项将读取值为 70，忽略 % 格式，而读取可见文本选项将读取内容为 70%。

    建议： 使用读取单元格值选项作为单元格的读取值，比读取可见文本的性能更好。

此选项不可使用全局会话选项来共享使用 Excel advanced package 的 Microsoft Excel 会话。

替代解决方案： 使用获取多个单元格 action 并将数据保存到一个可数据化的变量中，然后使用选定了数据表选项的 Loop package。
对于电子表格的表中的每一行

(Apple Numbers)
  • 使用以下选项之一来提供会话名称：
    • 会话名称： 输入使用打开 action操作打开电子表格所使用的会话的名称。
    • 变量： 输入您在打开 action 中添加的会话变量。
  • 指定要检索值的表名。
  • 选择以下选项之一以循环遍历：
    • 所有行： 选择此选项可提取整个表格中的所有数据，包括表格中的每一行和每一列。
    • 特定行： 选择此选项以仅从表格中的指定行提取数据。 填写以下字段：
      • 起始行： 指定要检索值的起始行号。 例如，10
      • 截止行： 指定要检索值的截止行号。 例如，40
    • 单元格范围： 选择此选项可从由起始单元格和截止单元格定义的指定矩形单元格块（例如，从 B2 到 D5）中提取数据。 填写以下字段：
      • 起始单元格： 指定要检索值的起始单元格地址。 例如，A1
      • 截止单元格： 指定要检索值的截止单元格地址。 例如，C20
  • 从值类型选项中进行选择，以读取单元格的可见文本或值：
    • 可见文本
    • 单元格值

    例如，如果单元格的单元格内容为 70%，单元格值选项将读取值为 70，忽略 % 格式，而可见文本选项将读取内容为 70%。

  • 在将当前值分配给此变量字段中，选择一个录制变量或创建一个变量来保存输出。 此外，您可以通过提供键及其映射的变量，将输出存储在多个变量中。
对于文件夹中的每个文件 为指定文件夹中的每个文件重复 actions 组，并将当前文件的属性分配给包含两个键的字典变量：name 键包含文件名，extension 键包含文件扩展名。

要打开不同扩展名的文件，请使用变量选项来指定文件夹路径、文件名和文件扩展名。 首先，为文件夹路径创建一个变量 $sFolder$。 然后，对于文件夹路径中的文件，创建两个变量，一个用于文件名 $name$，另一个用于文件扩展名 $extension$。 要打开文件，请将变量合并为字符串，如 $sFolder$\$name$.$extension$。 为了使扩展名适用于不同的文件类型和不同的打开选项，您可以添加条件逻辑。
对于文件夹中的每个文件夹 为指定文件夹中的每个文件夹重复集合 actions，并将当前文件夹名称分配给字符串变量。

使用包含所有子文件夹选项递归遍历文件夹中的每个子文件夹，包括隐藏文件夹。
对于列表中的每一项 为指定列表中的每个项目重复集合 actions，并将当前项目分配给变量。 指定是否对列表中的所有项目重复 action 还是只对列表中的项目范围重复。 由于此变量类型可以保留各种子类型（字符串、数字、布尔值等），因此，如果在配置 action 时快速创建变量，则变量是“任何”类型。
注： 列表中的索引从零开始。 例如，要重复从列表第三个位置到第六个位置的项目 action，请在相应的字段中指定 2 和 5。
n 次 以指定次数重复容器中的 actions。 您可以将迭代计数分配给数字变量。
对于记录中的每个值 对指定记录中的每个值重复 actions，并将当前值分配给变量。 由于此变量类型可以保存各种子类型（字符串、数字、布尔等），因此，如果在配置操作时快速创建变量，则变量是任何类型。
对于日历中的每个会议 使用此选项可为指定日历中的每个会议重复集合 actions。 请参阅 在循环中使用 Microsoft 365 Calendar 操作。
对于工作表 (Microsoft 365 Excel) 中的每一行 对工作表中包含数据的每行重复集合 actions。
  • 提供您用来打开工作表的会话名称。
  • 指定是否对所有行或特定行重复 actions。
  • 您可以将当前行中的值分配给记录变量。
对于邮箱 (Apple Mail) 中的每封邮件 请参阅 使用适合 Apple Mail 的“对于邮箱中的每封邮件”迭代器
对于邮箱 (Microsoft 365 Outlook) 中的每封邮件 为 Microsoft 365 Outlook 收件箱中的每封电子邮件重复集合 actions。
  • 提供您在连接 action 中使用的会话名称。
  • 指定要使用迭代器的电子邮件的状态。 例如，要在尚未阅读的电子邮件上使用它，请选择未读。
  • 通过在排序电子邮件字段中选择以下选项之一，设置您希望电子邮件排序的顺序：
    • 最新优先： 当 Microsoft 365 Outlook package 版本更新到 1.6.1 或更高版本时，现有和新的自动化将启用此设置，并且邮箱中的所有电子邮件默认按 LIFO 方法排序。
    • 最旧优先： 此设置启用邮箱中电子邮件的先进先出 (FIFO) 排序方法。 此设置适用于所有可以使用循环迭代器执行的 Microsoft 365 Outlook actions，例如：
      • 更改状态
      • 删除
      • 转发
      • 回复
      • 保存附件
      • 保存电子邮件
  • 将消息格式设置为 HTML 或纯文本。
  • 选择特定的时区。
Microsoft Outlook (macOS) - 对于邮箱中的每封邮件 请参阅 将循环迭代器用于 Microsoft Outlook (macOS)。
对于用户 (Microsoft Teams) 的每次聊天 请参阅 使用“对于用户的每个聊天”迭代器
对于团队 (Microsoft Teams) 中的每个频道 请参阅 使用“对于团队中的每个频道”迭代器
对于频道 (Microsoft Teams) 中的每条消息 请参阅 使用“对于频道中的每条消息”迭代器
对于聊天 (Microsoft Teams) 中的每条消息 请参阅 使用“对于聊天中的每条消息”迭代器
对于每个团队 (Microsoft Teams) 请参阅 使用“对于每个团队”迭代器
对于队列 (Workload) 中的每个工作项 为队列中的每个工作项重复集合 actions，并将工作项分配给记录变量。 记录变量返回三个固定的关键值，即 workitemId、workitemValues 和 workitemMetadata。 请参阅 使用“对于队列中的每个工作项”迭代器
对于 XML 数据集中的每个节点 为 XML 数据集中的每个节点重复集合 actions，并将当前节点分配给字符串变量。 请提供您用于打开 XML 文件的会话名称。