要重复运行链中的命令或命令组,请设置迭代器。
注意: 要将关系数据库或外部 Web 服务的输出转换为 JSON 数组以便与迭代器一起使用,请使用 JSON 连接器的 CSV 转 JSON 命令 或JSON 变量转换。
设置迭代器
使用迭代器,您可以根据以下条件重复执行命令或组:
- 静态或动态值列表
- 数值的确切数量
- 基于是否存在某种条件
迭代器可以重复执行命令或分组:
- 静态值列表,例如区域或实体
- 动态或可变的值列表,例如来自作为工作区资源上传的文件或链中先前命令的输出。
注: 单个命令或命令组的迭代次数上限为 1000 次。
要对值列表运行迭代器:
- 在链中,选择要重复运行的命令或组,然后单击 编辑 。
- 在 迭代 选项卡上,启用 迭代器 。
- 在 选择修饰符类型中,选择列表。
- 输入迭代次数的值:
- 对于静态列表,每次迭代输入值,按 键,每次输入后按 键。
- 对于 动态 列表,请选择先前命令的输出以及要使用的值。
- 对于静态列表,每次迭代输入值,按 键,每次输入后按 键。
迭代器可以对指定数量的值重复执行命令或分组,例如链中前面某个命令输出的总页数。
步骤 1. 设置一个变量来存储数值
为了指示迭代次数,创建一个动态链变量:
- 在链中, 添加一个动态变量 来表示迭代次数,例如 计数器,初始值不设。
- 要在链运行时设置变量的初始值,请在输出迭代次数的命令之后添加 设置动态链变量 事件:
- 选择为迭代次数创建的动态变量。
- 在 值中,输入其起始值,例如 1。
步骤 2. 添加命令组
要指定要迭代的命令和迭代规则,请添加命令组:
- 在 设置动态链变量 事件之后, 添加 命令组,并在它们之间拖动链接。
- 选择组,然后单击 编辑。
- 在组的 迭代 选项卡上,启用 迭代器 。
- 在 选择修饰符类型中,选择“重复直到”。
- 单击 + 规则,选择浮点数数据类型,并指定何时停止迭代。例如,要根据先前命令的 总记录数 输出进行迭代,可以设置一条规则,当变量值大于 (>) 总记录数 输出时停止迭代。
- 将迭代命令添加到组中。
步骤 3. 添加一个事件来递增变量值
每次迭代递增变量值:
- 作为该组的最后一步,添加另一个 设置动态链变量 事件:
- 选择为迭代次数创建的动态变量。
- 在 值中,选择相同的变量。
- 要 转换值,请单击 值中的变量,然后添加 解析 数字转换。
- 添加一个值为 1 的 添加 转换,然后单击 接受。
如果值或值的确切数量未知,您可以根据是否满足特定条件进行迭代。例如,您可以重复执行命令,直到满足指定条件为止。
步骤 1. 设置条件值的变量
为了表示指示要迭代的值的条件,创建动态链变量。例如,如果一个命令提供一个布尔值键输出来指示其响应是否包含其他页面,以及一个整数偏移参数来标识每个页面,则为这些值创建变量:
- 在链中, 为每个条件添加一个动态变量 ,初始值不为空。
- 要设置链运行时变量的初始值,在输出条件值的命令之后, 添加 设置动态链变量 事件,选择动态变量,并输入它们的初始值。
例如,将布尔键的值输入为 True,将偏移值输入为 0。
步骤 2. 添加命令组
要指定要迭代的命令和迭代规则,请添加命令组:
- 在 设置动态链变量 事件之后, 添加 命令组,并在它们之间拖动链接。
- 选择组,然后单击 编辑。
- 在组的 迭代 选项卡上,启用 迭代器 。
- 在 选择修饰符类型中,选择“重复直到”。
- 单击 + 规则,并指定何时停止迭代,例如当布尔键为 False 时。
- 将迭代命令添加到组中。
步骤 3. 在每次迭代中设置变量值
作为该组的最后一步,添加另一个 设置动态链变量 事件,以便在每次迭代中设置或递增变量值。
- 要设置变量值,请将每个变量映射到先前命令的相应输出。例如,对于 Boolean 变量,选择布尔键输出;对于 Offset 变量,选择整数偏移量参数。
- 要 递增变量(例如偏移 量) ,请单击其值,然后应用 解析 数字转换和 添加转换,并将每次迭代递增 的值应用到转换中。
迭代器输出
您可以将迭代器的输出用作链中后续其他命令或事件的属性。输出取决于迭代器的修饰符——列表 或 重复直到。
| 输出 | 描述 |
|---|---|
| 命令迭代或组迭代 | 循环中处理的迭代变量值 |
| 索引 | 从零开始计数,用于指示循环中处理的迭代次数。 |
| 第一次迭代 |
一个布尔值,用于指定当前处理的迭代是否为循环中的第一次迭代。 |
| 最后一次迭代 | 仅适用于 List 迭代器,一个布尔值用于指定当前处理的迭代是否为循环中的最后一次迭代 |
| 总迭代次数 | 仅针对 List 迭代器,循环处理的迭代次数总数(从零开始计数) |
要将输出用作另一个命令或事件的属性,请分别在 命令迭代器 或 组迭代器下选择它。