使用循环步骤

循环步骤允许您在循环中执行一系列步骤。

配置环路步长

要将循环添加到您的工作流程：

1. 给循环一个名称和描述。
2. 选择要使用的循环类型。
   • “重复”循环遍历有限的项目集合，并为每个项目执行循环。
   • “重复直到”循环以特定的时间间隔执行配置次数的循环
3. 配置循环类型详细信息。
   • 对于“重复”循环，选择哪个输入变量包含您想要迭代的数据集。
   • 为了“重复直到”循环，首先定义要运行循环的次数，然后配置“重复延迟”或每个循环执行之间的时间间隔的长度。然后选择时间的时间单位，以便为您提供的长度超出几秒钟，分钟或数小时。
4. 点击保存步骤和进入循环．这将带您到一个新的工作流构建器画布，它只显示您的循环步骤。
5. 添加要迭代的步骤，就像向主工作流添加步骤一样。
   • 在循环中，你的输入变量将包括[<循环名称>]。[项目]美元默认情况下。您可以根据需要从工作流的先前步骤中添加更多输入，但是从每个循环迭代访问变量的步骤需要$项目默认的变量。
6. 如果需要，添加一个Break Loop Step，它的作用类似于过滤步骤如果满足过滤条件，则退出循环。如果没有断开循环步骤，则循环将继续执行，直到它完成“重复”集合或“重复”的“重复”的“重复”执行。
7. 要从循环内部收集数据以跟随循环后的步骤，请在配置面板的第二页上添加循环输出。要了解有关设置环路输出的更多信息，请阅读以下部分。

循环数据的访问

有几种方法可以访问循环数据。

在重复循环中访问项目

选择“重复”循环类型，循环中的步骤在您选择的输入数组中运行的每个项目。

循环操作的当前数组项存储在$item变量中，以便在循环中使用。要访问当前迭代的数据，请使用[循环名]。[$item]作为需要当前迭代数组项的步骤的变量。

如果您的输入是一个对象数组，则具有键的附加数据，请使用(“循环名称”)。(美元项目)。(关键的名字)格式以访问对象数据。

在将来的步骤中访问循环输出变量

在循环之外，您可以使用循环输出变量，就像您的任何步骤变量一样。单击循环下游的另一步上的[+]，选择“循环步骤”，然后单击“输出变量”名称将其添加到表达式中。

使用断裂输出

当您使用Break Loop步骤时，您可以使用["Loop Name"]以一种更简单的方式引用上一次运行迭代的内容。(项目美元)变量。您只能使用["Loop Name"]。[$item]在循环后的步骤中，如果你使用Break loop步骤退出循环。

定义循环输出

对于所有循环类型，访问循环结果以便以后使用的最佳方法是定义循环输出变量。

从循环内部

从循环之外

将鼠标悬停在循环步骤图标上，然后单击编辑（铅笔）图标。

添加循环输出

在右侧面板中配置循环后，您可以在面板的第二页上添加输出。您必须在循环中至少有一个步骤来定义输出。

单击“添加输出”以设置您可以从此循环访问的数据。

您可以添加最多10个输出变量，让您组合并从每次迭代或运行循环中收集数据。例如，输出变量可能会计算找到匹配的所有迭代，或者将由特定操作生成的输出拉到新阵列中以供以后使用。

这允许您将循环的所有迭代放在一起摘要表单，以便您可以在将来的步骤中轻松使用。

循环输出类型

有4种类型的循环输出，每个循环输出都为您提供了不同的组合和处理能力。

大批

阵列输出类型使输出变量成为新的项目数组，它可以包括来自循环中的任何数据，并且可以可选地筛选为匹配指定表达式的循环迭代的条目。

• 要包含在数组中的值：输入来自循环迭代的数据的表达式将添加到数组（必填）
• 只包括如果……可选地，您可以输入一个表达式，该表达式的求值必须为true，以便在输出数组中包含该条目(可选)。

布尔基

布尔输出类型在每个循环迭代中评估一个条件，并确定整个循环的单个布尔（true或false）输出值，如果所有迭代匹配或任何迭代匹配。

• 如果......输出为true：在匹配表达式匹配的任何迭代中，选择变量是否为真，或匹配给出的表达式的所有迭代（必需）
• 匹配表达式：定义在每次迭代（必填）上匹配的条件

总和

Sum输出类型允许您在循环迭代中对数字相加。结果值将是每个循环迭代(必需)的所有值的总和。

• 要相加的数值：选择一个值（必须是数字类型）以加入循环的每个迭代。

数数

Count输出类型允许对循环的匹配迭代进行计数。结果值将是匹配给定表达式的循环迭代次数。

• 计数循环运行匹配...：将为每个循环迭代评估的表达式（true或false）。如果表达式为迭代为true，则变量将递增一个。如果它是假的，它不会递增。

循环$项目示例用例

考虑一个安全过程，用于为用户提供一个构建用户名的组织，该组织在@jdoe for Jane Doe等姓名格式上构建用户名，并为不同需求的同一员工构建额外的别名帐户（如@ jdoe1，@jadoe等））。首先需要检查每个别名是否每个别名都针对配置的用户数据来查找未配置的用户数据，然后在您的首选目录工具中提供别名。

在InsightConnect中，您可以将用户查找放在循环中，以返回Jane Doe用户名列表作为字符串数组。要访问当前迭代的循环中的输入数据，称为“checkusername”，您将使用[“checkusername”。[$项]在输入字段中查找。要在找到未驱动的用户名时退出循环，您将使用当前迭代的查找结果的条件添加“中断循环”步骤假冒

在循环跟随的步骤中，您可以使用相同的发现唯一用户名引用[循环名称]。[$项目]可变格式。这对于可能为发现的用户名执行别名或执行其他操作的步骤是有用的。