循环节点
什么是循环节点？
循环节点是 Magic Flow 工作流中的一种流程控制节点，它允许您重复执行一系列操作，直到满足特定的条件或完成指定的次数。简单来说，循环节点就像是一个"重复执行"的指令，帮助您自动化重复性任务，提高工作效率。
图片说明： 循环节点界面包括两个主要部分：外层的"循环"组件和内部的"开始节点"。在循环组件中，您可以设置循环类型、循环条件或次数；开始节点则表示每次循环执行的起点。 
为什么需要循环节点？
在构建智能应用的过程中，循环节点解决了需要重复执行某些操作的问题，它能够：
- 批量处理数据：对列表或数组中的每个元素执行相同的操作
- 重复尝试：在特定条件满足前持续执行某项任务
- 定时执行：按照固定次数重复执行任务
- 动态工作流：根据实际情况灵活决定执行次数
- 节省工作量：避免手动复制粘贴相同的节点序列
适用场景
1. 批量数据处理
处理一组数据，如遍历客户列表发送个性化消息，或处理表格中的每一行数据。
2. 重试机制
在某些操作失败时进行重试，直到成功或达到最大尝试次数。
3. 分页请求
需要多次调用 API 获取分页数据时，通过循环控制请求次数和参数变化。
4. 定时检查
按照设定的次数或条件重复检查某个状态，如定期检查任务完成情况。
节点参数说明
基本参数
| 参数名称 | 参数类型 | 必填 | 描述 |
|---|---|---|---|
| 循环类型 | 下拉选择 | 是 | 选择循环的类型，包括"计数循环"、"循环数组"和"条件循环" |
| 循环次数 | 数值/变量 | 视类型而定 | 当选择"计数循环"时，设置循环执行的总次数 |
| 循环数组 | 变量 | 视类型而定 | 当选择"循环数组"时，指定要遍历的数组或列表 |
| 条件循环 | 表达式 | 视类型而定 | 当选择"条件循环"时，设置循环继续的条件表达式 |
| 当前索引变量名 | 文本 | 否 | 用于存储当前循环索引的变量名，默认为"loopIndex" |
| 当前元素变量名 | 文本 | 否 | 用于存储当前循环元素的变量名，默认为"loopItem" |
| 最大循环次数 | 数值 | 否 | 防止无限循环的安全限制，设置最大可执行的循环次数 |
使用说明
基本配置步骤
- 选择循环类型：
- 按次数：适用于知道确切执行次数的情况
- 遍历数组：适用于需要处理数组每个元素的情况
- 条件判断：适用于需要满足特定条件才停止的情况
- 配置循环参数：
- 按次数：设置具体循环次数，如"10"
- 遍历数组：选择或输入要遍历的数组变量
- 条件判断：设置循环条件表达式和最大循环次数
- 配置循环体：
- 在循环节点内部添加需要重复执行的节点
- 这些节点将根据循环设置重复执行
- 处理循环结果：
- 可以在循环内部使用变量保存节点保存中间结果
- 循环结束后，这些变量可供后续节点使用
注意事项
性能考量
循环节点可能导致工作流执行时间延长：
- 尽量避免设置过大的循环次数
- 对于大量数据，考虑分批处理
- 条件循环一定要设置合理的最大循环次数，防止无限循环
循环中的变量作用域
在循环中修改的变量会影响后续循环：
- 如需每次循环使用独立的变量，请在循环开始时重新初始化
- 循环内的变量修改会保留到循环结束后
循环嵌套限制
虽然技术上支持循环嵌套，但请注意：
- 嵌套循环会显著增加执行复杂度和时间
- 建议嵌套不超过 2 层，以保持工作流的可维护性
- 嵌套循环时尤其要注意设置合理的循环次数
常见问题
问题 1：循环节点执行次数超出预期怎么办？
解决方案：可能是循环条件设置不当。建议：
- 检查循环条件是否正确设置
- 确保在适当时机更新条件判断的变量
- 使用代码节点手动设置中断标记提前结束循环
问题 2：循环内的节点没有按预期执行怎么办？
解决方案：这可能有几个原因：
- 确保循环体内的节点连接正确
- 检查每个节点的条件判断是否正确
- 使用变量保存节点保存中间结果，便于调试
- 检查循环内使用的变量是否正确初始化
问题 3：如何在循环中保存每次迭代的结果？
解决方案：您可以：
- 使用数组变量收集每次循环的结果
- 在代码执行节点中将结果添加到数组
- 循环结束后，该数组将包含所有迭代的结果
javascript
// 初始化结果数组（在循环前）
context.variableSave("results", []);
// 在循环内保存每次结果
let results = context.variableGet("results", []);
results.push(someResult);
context.variableSave("results", results);最佳实践
常见搭配节点
| 节点类型 | 搭配原因 |
|---|---|
| 代码执行节点 | 处理循环中的复杂逻辑，操作数组和对象 |
| 条件分支节点 | 在循环内基于条件执行不同操作 |
| 变量保存节点 | 存储循环中的中间结果或累计值 |
| HTTP 请求节点 | 批量发送请求或分页获取数据 |
| 数据存储节点 | 保存循环处理的结果到持久存储 |