JSON 文件加载:Load JSON 组件(AI Flowi Workflow)
JSON 文件加载组件 Load JSON 在组件目录中的描述为:“将 JSON 文件、文件路径指向的 JSON,或 JSON 字符串转换为 Data 对象或 Data 对象列表。”本条目介绍三种提供 JSON 的方式,并列出一个供下一节点使用的 JSON 类型输出。
Load JSON 已在组件目录中记录;Ai Flowi 尚未对其进行生产环境测试。
作者:Ai Flowi · 发布于
组件目录参考
在 2026年10月9日 导出的 AI Flowi Workflow 1.9.2 目录中,Load JSON 的源选项和输出约定记录在 data_source.JSONtoData 下;更多组件可参阅组件目录。
输入
JSON 条目的三个输入均未标记为必填。这些元数据未说明空配置能否运行,也未规定文件、路径和字符串源之间的优先顺序。在小屏幕上,可横向滚动 JSON 输入表格;键盘用户可将焦点移至表格并使用方向键。
| 名称 | 类型 | 必填 | 接受的输入类型 | 说明 |
|---|---|---|---|---|
json_file | file | 否 | 未列出 | JSON 文件源;此文件字段接受的连接类型未列出。 |
json_path | str | 否 | Message | JSON 文件路径源,接受 Message。路径位置和访问规则未说明。 |
json_string | str | 否 | Message | JSON 文本源,接受 Message。下方示例数组使用此字段。 |
输出
| 显示名称 | 名称 | 类型 |
|---|---|---|
| JSON | data | JSON |
唯一的端口显示名称为 JSON,名称为 data。描述提到结果可以是 Data 对象或 Data 对象列表,但两者声明的连接类型均为 JSON;导出内容未展示其数据结构。
何时使用 Load JSON
如果源数据是 JSON 文件、可访问的 JSON 路径,或表示对象或列表的有效 JSON 文本,可选择 Load JSON。要处理已加载的值,请连接 JSON Operations,无需再添加一次数据导入步骤。
何时选择其他组件
对于 CSV 记录,其源字段已在 Load CSV 文档中列出。如果仅需解析对象文本,并希望使用必填的文本输入,可比较 JSON String Parser;该组件现有文档已介绍其异常处理说明。
最简配置
配置示例,并非已记录的测试
{
"json_string": "[{\"item\":\"Notebook\",\"quantity\":2},{\"item\":\"Folder\",\"quantity\":3}]"
}
将 json_string 设置为此模拟数组;不设置 json_file 和 json_path,使配置仅使用一个源。item 和 quantity 是字符串内的示例数据键。选择列表处理步骤之前,请先检查 data 输出,因为本示例未提供实际观察到的转换结果。
限制
- 文档所述范围为对象或列表,并未规定标量 JSON 的处理方式。本条目无法确认是否支持单独的数字、布尔值、null 或带引号的字符串。
- JSON 加载组件的文件大小上限、嵌套深度限制、字符编码规则和源选择优先顺序均未在导出内容中列出。
- 组件目录未提供 Load JSON 的修复选项,也未说明格式错误的 JSON 会产生什么结果。不得将其他解析组件的错误处理行为归于此组件。
- JSON 类型的端口并未规定其中包含哪些应用字段或哪些字段有效;请根据下一操作的要求检查加载的数据。
工作流用例总览已介绍如何选择更完整的自动化方案。
节点用量
可结合套餐价格和用量费用参考,为 JSON 加载工作流制定预算。
相关组件
Load CSV · JSON String Parser · JSON Operations · Select Data