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. 内置节点

分支节点

概述#

多分支条件选择节点,支持基于复杂条件判断选择不同的执行分支。与简单的条件节点不同,Switch节点可以定义多个分支条件,按顺序匹配第一个满足条件的分支执行。

功能特性#

多分支选择:支持定义多个条件分支
顺序匹配:按分支顺序匹配,第一个满足条件的执行
默认分支:无匹配条件时执行默认分支
复杂条件:支持AND/OR组合的复杂条件逻辑
动态分支:支持运行时动态添加分支
执行追踪:记录分支选择和执行结果

节点结构#

SwitchParam#

branches:分支列表(List<SwitchItem>)

SwitchItem#

id:分支ID
name:分支名称
orList:条件组列表(List<ConditionGroup>)

ConditionGroup#

andList:条件项列表(List<ConditionItem>)

ConditionItem#

query:条件变量
operator:操作符
value:比较值

配置方法#

1. 基本Switch配置#

{
  "branches": [
    {
      "id": "branch1",
      "name": "VIP用户",
      "orList": [
        {
          "andList": [
            {
              "query": "${user.level}",
              "operator": "eq",
              "value": "VIP"
            }
          ]
        }
      ]
    },
    {
      "id": "branch2", 
      "name": "普通用户",
      "orList": [
        {
          "andList": [
            {
              "query": "${user.level}",
              "operator": "eq", 
              "value": "NORMAL"
            }
          ]
        }
      ]
    }
  ]
}

2. 复杂条件分支#

{
  "branches": [
    {
      "id": "high_priority",
      "name": "高优先级",
      "orList": [
        {
          "andList": [
            {
              "query": "${order.amount}",
              "operator": "gt",
              "value": 1000
            },
            {
              "query": "${user.vipLevel}",
              "operator": "ge", 
              "value": 3
            }
          ]
        }
      ]
    },
    {
      "id": "medium_priority",
      "name": "中优先级",
      "orList": [
        {
          "andList": [
            {
              "query": "${order.amount}",
              "operator": "gt",
              "value": 500
            }
          ]
        }
      ]
    },
    {
      "id": "low_priority",
      "name": "低优先级",
      "orList": [
        {
          "andList": [
            {
              "query": "${order.amount}",
              "operator": "le",
              "value": 500
            }
          ]
        }
      ]
    }
  ]
}

3. 多条件OR分支#

{
  "branches": [
    {
      "id": "urgent",
      "name": "紧急处理",
      "orList": [
        {
          "andList": [
            {
              "query": "${task.priority}",
              "operator": "eq",
              "value": "URGENT"
            }
          ]
        },
        {
          "andList": [
            {
              "query": "${task.dueDate}",
              "operator": "lt",
              "value": "${currentDate}"
            }
          ]
        }
      ]
    }
  ]
}

执行逻辑#

分支匹配过程#

1.
按branches数组顺序遍历每个SwitchItem
2.
对每个分支执行orList中的条件判断
3.
如果任一ConditionGroup的条件满足,则匹配成功
4.
返回第一个匹配的分支,停止后续匹配

条件求值#

AND逻辑:ConditionGroup内所有ConditionItem都必须为true
OR逻辑:多个ConditionGroup中任一为true即匹配
变量替换:支持${variable}语法引用流程变量

默认分支#

如果所有分支条件都不满足:
{
  "id": "default-branch",
  "name": "default"
}

输出结果#

成功匹配输出#

{
  "id": "branch1",
  "name": "VIP用户",
  "orList": [...]
}

默认分支输出#

{
  "id": "default-branch",
  "name": "default"
}

应用场景#

1. 用户分级处理#

根据用户等级选择不同的处理流程:
VIP用户:快速通道
普通用户:标准流程
新用户:引导流程

2. 订单分拣#

根据订单金额和类型选择处理方式:
大额订单:人工审核
中等订单:自动处理
小额订单:批量处理

3. 任务优先级调度#

根据任务紧急程度分配处理资源:
紧急任务:立即处理
重要任务:优先队列
普通任务:普通队列

4. 业务规则引擎#

基于多个业务条件选择执行路径:
组合条件判断
多重分支选择
动态规则配置

高级功能#

动态分支配置#

支持运行时动态添加分支:
{
  "dynamicBranches": [
    {
      "condition": "${config.enableBranchA}",
      "branch": {
        "id": "branchA",
        "name": "动态分支A",
        "orList": [...]
      }
    }
  ]
}

分支权重#

为分支添加权重,支持负载均衡:
{
  "weightedBranches": [
    {
      "branch": "branch1",
      "weight": 0.7
    },
    {
      "branch": "branch2", 
      "weight": 0.3
    }
  ]
}

条件缓存#

缓存常用条件判断结果,提高性能:
{
  "cacheConditions": true,
  "cacheTimeout": 300
}

性能优化#

条件求值优化#

短路求值:条件判断提前终止
结果缓存:相同条件避免重复计算
并行求值:独立条件可并发处理

分支顺序优化#

将最可能匹配的分支放在前面
定期分析分支命中率并调整顺序
使用索引优化大量分支的查找

最佳实践#

1. 分支设计原则#

分支条件互斥,避免重叠
按匹配概率排序分支
为每个分支设置明确的业务含义

2. 条件设计优化#

使用简单条件提高性能
避免深层嵌套的复杂条件
合理使用变量引用

3. 默认分支处理#

始终定义默认分支处理异常情况
默认分支应有明确的处理逻辑
记录默认分支的触发情况用于分析

4. 维护和监控#

定期检查分支条件的有效性
监控各分支的命中率
记录分支选择的统计信息

调试和监控#

分支选择日志#

记录每个分支的条件求值过程
输出匹配的分支信息
记录条件求值的耗时

性能指标#

分支命中率统计
条件求值平均时间
默认分支触发频率

常见问题#

Q: 分支的匹配顺序是怎样的?#

A: 按branches数组的顺序从上到下匹配,第一个满足条件的branch会被选择执行。建议将最常用的分支放在前面以提高性能。

Q: 如果多个分支条件都满足会怎样?#

A: 只会执行第一个匹配的分支,后续满足条件的branch会被忽略。这是Switch语句的标准行为,确保执行路径的确定性。

Q: 如何处理分支条件中的变量不存在的情况?#

A: 如果条件中引用的变量不存在,该条件会被视为false。建议在使用前通过VarAction节点确保变量已定义,或在条件中使用安全引用。

Q: 支持嵌套条件吗?#

A: 支持。每个ConditionGroup可以包含多个ConditionItem(AND关系),多个ConditionGroup之间是OR关系。可以构建复杂的嵌套条件逻辑。

Q: 默认分支什么时候会执行?#

A: 当所有配置的分支条件都不满足时,会执行默认分支。默认分支总是存在,即使没有明确配置,也会返回一个标准的default分支对象。
修改于 2026-05-07 01:44:57
上一页
缓存处理
下一页
循环执行
Built with