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

变量节点

概述#

变量节点是AI FLOW中的变量操作处理器,用于在流程执行过程中设置和更新变量值。通过指定变量路径和新的值,可以动态修改流程上下文中的变量,支持复杂的数据结构和嵌套路径操作。

功能特性#

变量设置:设置流程上下文中的变量值
路径支持:支持点分隔的嵌套路径访问
类型灵活:支持字符串、数字、对象等多种数据类型
动态更新:运行时动态修改变量值
错误处理:完善的异常捕获和错误信息返回

配置参数#

UpdateVar#

varPath:变量路径,支持点分隔的嵌套路径
value:要设置的新值,支持各种数据类型

变量路径格式#

简单变量:varName
嵌套对象:user.name 或 user.profile.email
数组元素:list[0] 或 users[1].name
动态路径:支持使用其他变量作为路径

使用方法#

1. 设置简单变量#

{
  "varPath": "userName",
  "value": "张三"
}
将变量 userName 设置为字符串 "张三"

2. 设置嵌套对象属性#

{
  "varPath": "user.profile.age",
  "value": 25
}
设置用户配置文件的年龄为25

3. 更新数组元素#

{
  "varPath": "userList[0].status",
  "value": "active"
}
更新用户列表第一个用户的状态

4. 设置复杂对象#

{
  "varPath": "result",
  "value": {
    "code": 200,
    "message": "success",
    "data": {
      "id": 123,
      "name": "测试数据"
    }
  }
}
设置result变量为完整的对象

5. 使用变量引用#

{
  "varPath": "processedData",
  "value": "${input.data}"
}
将输入数据赋值给processedData变量

执行逻辑#

参数解析#

1.
从节点上下文获取输入参数
2.
将参数映射为UpdateVar对象
3.
验证varPath和value的合法性

变量更新#

1.
使用MappingParser.updateMapByPath更新上下文
2.
支持嵌套路径的自动创建
3.
类型转换和值覆盖

结果输出#

1.
创建VarOutput对象
2.
设置状态码(200成功,400失败)
3.
返回更新后的值和消息

错误处理#

常见错误情况#

1.
路径不存在:尝试更新不存在的嵌套路径
2.
类型不匹配:值类型与预期不符
3.
权限不足:尝试修改只读变量
4.
内存不足:大型对象导致内存溢出

错误响应#

{
  "code": 400,
  "msg": "Variable path not found: user.profile.invalid",
  "value": null
}

高级功能#

路径表达式#

支持复杂的路径表达式:
{
  "varPath": "data[${index}].result",
  "value": "computed_value"
}

批量更新#

通过循环调用实现批量变量更新:
{
  "varPath": "batch[${loop.index}].processed",
  "value": true
}

条件更新#

结合条件节点实现条件变量更新:
Condition → VarAction (满足条件时更新)
         → VarAction (不满足时更新其他变量)

最佳实践#

1. 变量命名规范#

使用有意义的变量名
遵循驼峰命名法
避免特殊字符和空格

2. 路径设计#

合理设计嵌套层级
避免过深的路径(建议不超过5层)
使用数组索引时确保边界检查

3. 类型一致性#

保持变量类型的稳定性
避免频繁的类型转换
使用合适的数据类型

4. 错误处理#

检查变量是否存在
验证路径格式
处理异常情况

调试和监控#

变量追踪#

记录变量更新历史
输出变量值的变化
路径解析过程日志

性能指标#

变量更新耗时统计
内存使用监控
错误率分析

常见问题#

Q: 如何更新整个对象?#

A: 设置varPath为对象根路径,value为完整的对象。系统会替换整个对象。

Q: 支持数组操作吗?#

A: 支持数组元素更新,如array[0]。但不支持数组整体操作如push/pop。

Q: 变量作用域是怎样的?#

A: 变量存储在流程上下文(ContextHolder)中,整个流程生命周期内有效。子流程有独立的上下文。

Q: 如何删除变量?#

A: 设置value为null可以清空变量值。但要完全删除,需要使用专门的删除操作。

Q: 支持动态路径吗?#

A: 是的,可以使用其他变量作为路径的一部分,如data[${index}]。但需要确保变量已定义。
修改于 2026-05-07 01:44:57
上一页
HTTP 请求
下一页
加解密节点
Built with