Studio Web 用户指南

适用平台：

上次更新日期 2025年9月22日

遍历循环

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

如何聚合数组中的数据

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

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

使用“遍历循环”活动

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

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

“遍历”活动示例

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

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

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

在 API 工作流设计器画布上，添加 “遍历循环”活动。
按如下方式配置“遍历循环”字段：
- 输入— 使用表达式编辑器从运行配置引用employees数组：
```
$workflow.input.employees$workflow.input.employees
```
- “项目名称” — 为数组元素分配引用名称（默认为currentItem ）。在迭代期间使用此引用访问每个项目。
在“遍历循环”的“主体” 中，添加“脚本” 活动。

对于“脚本”活动，使用“表达式编辑器”创建一个 JSON，将first_name和last_name属性组合到一个对象中：

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

保存配置。
在工作流的末尾添加“响应”活动。
按如下方式配置响应：
- “类型” — 成功
- 详细信息— 打开“表达式编辑器”，写入以下内容:
```
$context.outputs.For_Each_2$context.outputs.For_Each_2
```
此步骤在工作流开头添加验证，以在处理之前确认存在有效事务。
测试工作流以执行活动。
请查看“输出”面板，以审核响应。