遍历循环

“遍历循环”活动遍历数组，并为每个数组元素执行一组定义的步骤。使用“遍历循环”活动处理包含对象数组的 API 响应，例如需要单独处理的用户、订单或记录列表。

如何聚合数组中的数据

“遍历循环”活动的一个常见用例是使用“脚本”活动将来自多个 API 调用的数据聚合到结构化数组中。

“遍历循环”活动自动收集其“正文”流程中最后一个活动的输出，并将其编译到其输出中可用的数组中。

使用“遍历循环”活动

要将“遍历循环”活动添加到工作流，请执行以下操作：

1. 在 API 工作流设计器画布上，选择加号 (+) 图标。系统将显示“添加活动”菜单。
2. 选择“循环” ，然后选择 “遍历循环” 。
3. 在“属性”面板中，配置以下字段：
   • 输入—使用“表达式编辑器”指定要迭代的数组。通常，此数组来自先前的 API 响应。
   • 项目名称— 为数组元素分配引用名称（默认为currentItem ）。在迭代期间使用此引用访问每个项目。
4. 在“遍历循环”的“主体”中，添加活动以处理数组项目。
5. 根据需要向Then和Else分支添加活动。
6. 调试工作流以执行活动并生成输出字段以供以后使用。

“遍历”活动示例

以下示例将遍历员工对象的数组，组合每个员工的名字和姓氏，并在结构化响应中返回汇总结果。

打开“调试配置”窗口，然后粘贴并保存以下 JSON 语法：

{
    "employees": [
        {
            "first_name": "Bobbie",
            "last_name": "Draper",
            "position": "administration",
            "email": "[e-mail]"
        },
                {
            "first_name": "James",
            "last_name": "Holden",
            "position": "manager",
            "email": "[e-mail]"
        }
    ]
}

1. 在 API 工作流设计器画布上，添加 “遍历循环”活动。
2. 按如下方式配置“遍历循环”字段：
   • 输入— 使用表达式编辑器从运行配置引用employees数组：

     $workflow.input.employees
     

   • 项目名称— 为数组元素分配引用名称（默认为currentItem ）。在迭代期间使用此引用访问每个项目。
3. 在“遍历循环”的“主体”中，添加“脚本”活动。
4. 对于“脚本”活动，使用表达式编辑器创建一个 JSON，将first_name和last_name属性组合到一个对象中：

   return {
       "name": $currentItem.first_name + " " + $currentItem.last_name
   }
   

5. 保存配置。
6. 在工作流的末尾添加“响应”活动。
7. 按如下方式配置响应：
   • “类型” — 成功
   • 详细信息— 打开“表达式编辑器”，写入以下内容:

     $context.outputs.For_Each_2
     

     此步骤在工作流开头添加验证，以在处理之前确认存在有效事务。
8. 调试工作流以执行活动。
9. 请查看“输出”面板，以审核响应。