1. 内置节点
专属集成平台
  • 快速开始
    • 集成平台概览
  • 身份与用户管理
    • 用户管理
      • 用户与组织架构管理
    • 角色管理
      • 角色管理配置说明
    • 属性管理
      • 属性管理配置说明
      • IDAAS 扩展物理字段使用说明
    • 上游身份数据集成
      • 通讯录身份集成概述
      • 集成连接器配置指南
        • 通讯录集成-泛微
        • 通讯录集成-飞书
        • 通讯录集成-企业微信
        • 通讯录集成-AD
        • 通讯录集成-睿人事
        • 通讯录集成-北森
        • 通讯录集成-SCIM
        • 通讯录集成-用友EHR
        • 通讯录集成-Azure AD
        • 通讯录集成-致远
        • 通讯录集成-LDAP
        • 通讯录集成-数据库
        • 通讯录集成-钉钉
          • 基础说明
          • 钉钉集成连接器如何配置属性映射
      • 通过连接流实现身份集成
        • 在连接流画布中完成身份集成配置
      • 身份集成常见问题
        • 常见问题 & 排错指南
    • 下游身份数据同步
      • 通讯录同步概述
      • 同步连接器配置指南
        • 通讯录同步-企业微信
        • 通讯录同步-AD
        • 通讯录同步-用友U8C
        • 通讯录同步-钉钉
          • 基础说明
          • 如何配置部门职位扩展字段
      • 通过连接流实现身份同步
        • 使用连接流实现身份下游同步
      • 身份同步常见问题
        • 常见问题 & 排错指南
        • 使用代理网关进行身份同步
  • 认证源管理
    • 认证源基础说明
      • 认证源选型说明
      • 认证源管理概述
    • 认证源配置指南
      • 基础协议配置
        • 认证源-CAS协议
        • 认证源-OIDC协议
        • 认证源-OAuth2协议
      • 三方认证源配置手册
        • 认证源-钉钉
        • 认证源-AD
        • 认证源-飞书
        • 认证源-LDAP
        • 认证源-微信
        • 认证源-微信公众号
        • 认证源-Google Workspace
        • 认证源-AD Azure
        • 认证源-美云智数
        • 认证源-企业微信
  • 应用管理
    • 基础说明
      • 应用管理概述
      • 应用创建与配置
    • 应用单点登录
      • 单点登录概述
      • 单点登录配置
      • 单点登出配置
      • 授权范围配置
      • 自定义集成单点登录配置说明
      • 应用密码代填
      • 应用网关
      • 单点登录配置指南
        • 单点登录-OIDC
        • 单点登录-SAML协议
        • 单点登录-OAuth2
        • 单点登录-CAS协议
        • 单点登录-钉钉SSO
        • 单点登录-分贝通
        • 单点登录-用友NCC
        • 单点登录-宜搭
        • 单点登录-泛微OA
        • 单点登录-致远OA
        • 单点登录-金蝶云星空
        • 单点登录-中国电子云邮箱
        • 单点登录-阿里云控制台(RAM)
        • 单点登录-纷享销客应用
        • 单点登录-纷享销客待办
        • 单点登录-Exchange
        • Exchange-双入口配置指南
    • 应用授权管理
      • 应用授权概述
      • 基于组织架构和用户授权
      • 基于角色授权(RBAC)
      • 基于用户属性授权(ABAC)
      • 用户自主申请应用(OA审批授权)权限
    • 应用分发
      • 企业应用分发
      • ABM应用分发
    • 使用应用调用集成平台 OPENAPI
      • M2M接口授权
      • 接口调用权限配置说明
  • 连接中心
    • 产品概述
      • 什么是 AI 连接流
      • AI 连接流的典型使用场景
    • 基础功能
      • 流程运行日志
      • 功能概览
      • 如何创建 AI 工作流
      • 授权凭证管理
      • 错误处理
    • 节点说明
      • 节点基础类型说明
      • 数据处理节点
        • 文本处理节点
        • 数组处理
        • 数据集合节点
      • 文件处理节点
        • 「Base64 转 URL」动作说明
        • 「PPT分页切割」动作说明
      • 应用节点
        • Teambition
        • 金蝶云 K3Cloud
      • 内置节点
        • 子流程调用
        • 缓存处理
        • 分支节点
        • 循环执行
        • MYSQL 触发动作说明
        • 数字签名
        • Webhook触发
        • 缓存列表处理
        • 条件分支
        • FTP
        • 延时节点
        • 模型子节点
        • MCP SERVER 工具
        • 邮件发送
        • 存储子节点
        • 工具子节点
        • HTTP 请求
        • 变量节点
        • 加解密节点
        • 返回变量
      • 运维管理节点
        • 数据校验节点
      • AI节点
        • 构建你的第一个 AI Agent
        • AI 浏览器操作节点
        • AI Agent节点使用指南
        • AI 消息对话节点 & 组件嵌入
  • 审计日志
    • 管理员行为日志
    • 用户变更日志
    • 接口调用日志
    • 用户行为日志
    • 消息发送日志
  • 权限中心
    • 管理员账号管理
    • 管理员角色管理
  • 品牌设置
    • 登录页设置
      • 登录页面配置
      • 登录页CSS自定义页面样式
      • CSS定制页面内容:样式修改指南及故障排除
    • 短信设置
      • 短信模板配置
      • 短信服务使用及签名修改使用指南
      • 短信服务-自定义连接流配置
      • 阿里云短信网关配置指引
    • 邮件设置
      • 邮件模板配置
      • 通过自定义连接流发送邮件
      • SMTP 配置与测试支持文档
    • 企业消息设置
      • 企业消息配置
      • 企业消息(钉钉_飞书)配置
    • 分发页面设置
      • 分发页面设置
  • 平台设置
    • 功能概述
    • 授权管理
    • 代理网关
    • 授权信息
    • 登录策略配置
      • 弱密码检测功能说明
      • 登录流程配置
      • 自动登录功能配置
    • MFA 配置
      • MFA基础配置
      • 使用连接流自定义 MFA 策略
    • 运维日志
      • 运维日志下载
  • 最佳实践
    • AD-LDAP接入指南
    • 第三方平台应用创建指南
      • 钉钉
        • 钉钉全套集成指南
        • 创建钉钉开放平台应用
      • 飞书
        • 飞书全套集成指南
        • 创建飞书开放平台应用
      • 企微
        • 企业微信全套集成指南
        • 创建企业微信开放平台应用
  • 开放接口
    • 鉴权认证
      • 获取access_token(请求体方式)
      • 获取access_token(Basic认证方式)
    • 用户管理
      • 查询用户
      • 创建用户
      • 根据多个条件过滤并查询用户信息
      • 根据用户帐号获取用户信息
      • 修改用户
      • 启用/禁用用户
      • 删除用户
      • 修改用户密码
    • 组织部门
      • 获取组/部门的列表
      • 创建组/部门
      • 根据组/部门ID获取组/部门的信息
      • 修改组/部门
      • 删除组/部门
      • 根据组/部门ID获取下级组/部门信息
      • 过滤部门信息
    • 角色管理
      • 创建角色
      • 获取单个角色详情
      • 修改角色
      • 删除角色
      • 查询角色列表
      • 根据应用ID和用户ID获取角色列表
      • 查看角色所对应的用户列表
      • 给多个用户添加静态角色
      • 删除用户静态角色
      • 获取用户的角色信息
    • 连接中心
      • Webhook启动连接流
    • 事件通知
      • 连接器事件通知
  1. 内置节点

循环执行

概述#

循环控制节点,支持多种类型的循环执行逻辑。通过配置不同的循环参数,可以实现数字范围循环、数组遍历循环和条件循环等功能,适用于批量处理、迭代计算等场景。

功能特性#

多种循环类型:支持数字、数组、条件三种循环模式
灵活控制:支持升序/降序、错误处理策略
变量管理:循环过程中维护索引和当前值变量
性能优化:支持循环上限限制和超时控制
嵌套支持:可与其他控制节点嵌套使用

循环类型#

NUMBER - 数字循环#

按指定的数字范围进行循环执行。
配置参数:
start: 循环开始值(数字表达式)
end: 循环结束值(数字表达式)
asc: 是否升序(true为升序,false为降序)
执行逻辑:
升序:从start到end(包含end)
降序:从start到end(包含end)
每次循环将当前值赋值给${loop.index}变量

ARRAY - 数组循环#

遍历数组或集合中的每个元素。
配置参数:
expression: 数组变量表达式
执行逻辑:
遍历expression指定的数组
每次循环将当前元素赋值给${loop.item}变量
索引值赋值给${loop.index}变量

CONDITION - 条件循环#

基于条件表达式控制循环执行。
配置参数:
expression: 条件表达式(每次循环前求值)
执行逻辑:
在每次循环开始前求值expression
条件为true时继续执行循环体
条件为false时跳出循环

配置参数#

LoopParam#

type:循环类型(NUMBER/ARRAY/CONDITION/INNER)
start:数字循环的开始值
end:数字循环的结束值
expression:数组变量或条件表达式
asc:是否升序(默认true)
errorExec:错误处理策略(END/CONTINUE/BREAK)

错误处理策略#

END#

行为:循环执行出错时,立即结束整个流程
适用场景:错误必须被处理,不能容忍任何异常

CONTINUE#

行为:循环执行出错时,跳过当前迭代,继续下一轮循环
适用场景:允许部分失败,继续处理其他数据

BREAK#

行为:循环执行出错时,跳出循环,执行后续节点
适用场景:遇到错误时提前结束循环但继续流程

使用方法#

1. 数字范围循环#

{
  "type": "NUMBER",
  "start": "1",
  "end": "10",
  "asc": true,
  "errorExec": "CONTINUE"
}
执行10次循环,${loop.index}依次为1,2,3,...,10

2. 数组遍历循环#

{
  "type": "ARRAY",
  "expression": "${userList}",
  "errorExec": "CONTINUE"
}
遍历${userList}数组,${loop.item}为当前元素,${loop.index}为索引

3. 条件循环#

{
  "type": "CONDITION",
  "expression": "${count} < 100",
  "errorExec": "END"
}
当${count} < 100时继续循环

4. 动态范围循环#

{
  "type": "NUMBER",
  "start": "${startIndex}",
  "end": "${endIndex}",
  "asc": "${isAsc}"
}
使用变量动态指定循环范围和方向

循环变量#

内置变量#

${loop.index}:当前循环索引(从1开始)
${loop.item}:当前循环项(数组循环时)
${loop.count}:已执行循环次数
${loop.total}:总循环次数(预估,可能不准确)

变量生命周期#

循环开始时初始化
每次迭代更新
循环结束后清除

执行流程#

循环初始化#

1.
解析循环参数
2.
初始化循环变量
3.
检查循环条件

循环执行#

1.
检查循环条件是否满足
2.
更新循环变量
3.
执行循环体节点
4.
处理执行结果
5.
根据errorExec处理异常
6.
准备下一轮迭代

循环结束#

1.
清除循环变量
2.
执行循环结束逻辑
3.
继续执行后续节点

高级功能#

嵌套循环#

Loop节点支持嵌套使用:
外层Loop (NUMBER: 1-3)
├── 内层Loop (ARRAY: 处理每组数据)
│   ├── 数据处理节点
│   └── 条件判断节点
└── 结果汇总节点

循环控制#

通过特殊变量控制循环:
设置${loop.break}为true可跳出循环
设置${loop.continue}为true可跳过当前迭代

性能监控#

循环执行时间统计
每次迭代耗时监控
错误率统计

性能优化#

循环上限#

默认最大循环次数10000次
可通过配置调整上限
超过上限强制结束循环

超时控制#

单次迭代超时时间(默认5分钟)
总循环超时时间(默认1小时)

内存管理#

大数组循环的分批处理
循环变量的及时清理

最佳实践#

1. 选择合适的循环类型#

数据批量处理:使用ARRAY循环
范围计算:使用NUMBER循环
条件迭代:使用CONDITION循环

2. 设置合理的错误处理#

关键业务:使用END策略确保数据一致性
非关键业务:使用CONTINUE策略提高容错性
异常检测:使用BREAK策略快速响应问题

3. 控制循环规模#

避免无限循环(CONDITION类型)
合理设置循环上限
分批处理大数据集

4. 变量管理#

使用有意义的变量名
及时清理不需要的变量
避免变量名冲突

调试和监控#

循环执行日志#

每次迭代的开始和结束
变量值变化记录
异常信息详细记录

性能指标#

平均迭代耗时
循环完成率
错误分布统计

常见问题#

Q: 如何跳出循环?#

A: 在循环体内设置${loop.break} = true,系统会在当前迭代结束后跳出循环。注意这只在循环体执行完成后才生效。

Q: 支持的最大循环次数是多少?#

A: 默认最大10000次,可通过系统配置调整。如需更大规模,建议使用分批处理或外部调度。

Q: 循环变量什么时候更新?#

A: 每次迭代开始前更新。${loop.index}在迭代开始时更新,${loop.item}在数组循环时同时更新。

Q: 如何处理循环中的异常?#

A: 通过errorExec参数控制:
END:异常时结束流程
CONTINUE:跳过异常迭代,继续下一轮
BREAK:跳出循环,继续后续节点

Q: 支持多层嵌套循环吗?#

A: 支持,但建议不超过3层。深层嵌套会增加复杂度,建议使用函数式编程或外部处理简化逻辑。
修改于 2026-05-07 01:44:57
上一页
分支节点
下一页
MYSQL 触发动作说明
Built with