logologo
开始
手册
开发
插件
API
English
简体中文
开始
手册
开发
插件
API
English
简体中文
logologo
工作流
概述
快速开始

触发器

概述
数据表事件
定时任务
操作前事件
操作后事件
自定义操作事件
审批
Webhook

节点

概述

人工智能

大语言模型

流程控制

条件
循环
变量
并行分支
调用工作流
流程输出
延时
结束

计算

计算
日期计算
JSON 计算
JSON 变量映射

数据操作

新增数据
更新数据
查询数据
删除数据
SQL 操作

人工处理

人工处理
审批
抄送

扩展类型

HTTP 请求
JavaScript 脚本
通知
邮件发送
响应
响应消息
变量
执行记录
版本管理
高级选项

扩展开发

概述
扩展触发器类型
扩展节点类型
API 参考
Previous PageJSON 计算
Next Page新增数据

#JSON 变量映射

该功能由商业插件 «工作流:JSON 变量映射» 提供, 请 购买 后使用

v1.6.0

#介绍

用于将上游节点结果中复杂的 JSON 结构映射为变量,以供后续节点使用。例如 SQL 操作和 HTTP 请求节点的结果,在映射后即可在后续节点中使用其中的属性值。

提示

与 JSON 计算节点不同,JSON 变量映射节点不支持自定义表达式,也不基于第三方引擎,仅用于映射 JSON 结构中的属性值,但使用更简单。

#创建节点

在工作流配置界面中,点击流程中的加号(“+”)按钮,添加“JSON 变量映射”节点:

创建节点

#节点配置

#数据源

数据源可以是上游节点的结果,也可以是流程上下文中的数据对象,通常是一个没有内置结构化的数据对象,例如 SQL 节点的结果,或者 HTTP 请求节点的结果。

数据源

#输入样例数据

通过粘贴一个样例数据,并点击解析按钮自动解析生成变量列表:

输入样例数据

自动生成的列表中如有不需要使用的变量,可以点击删除按钮删除。

提示

样例数据不是最终执行的结果,只用于辅助生成变量列表。

#路径包含数组索引

不勾选的情况下,会按照 NocoBase 工作流的变量默认处理方式映射数组内容。例如输入以下样例:

{
  "a": 1,
  "b": [
    {
      "c": 2
    },
    {
      "c": 3
    }
  ]
}

生成的变量中 b.c 将代表数组 [2, 3]。

如勾选了该选项,将会在变量路径中包含数组索引,例如 b.0.c 和 b.1.c。

20250113184056

在包含数组索引的情况下,需要确保输入数据中的数组索引是一致的,否则会导致解析出错。

#在后续节点使用

在后续节点的配置中,可以使用 JSON 变量映射节点生成的变量:

20250113203658

虽然 JSON 结构可能很复杂,但在映射之后,只需要选择对应路径的变量即可。