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 输入表格;键盘用户可将焦点移至表格并使用方向键。

组件目录中的 Load JSON 输入
名称类型必填接受的输入类型说明
json_filefile否未列出JSON 文件源;此文件字段接受的连接类型未列出。
json_pathstr否MessageJSON 文件路径源,接受 Message。路径位置和访问规则未说明。
json_stringstr否MessageJSON 文本源,接受 Message。下方示例数组使用此字段。

输出

Load JSON 导出的输出端口
显示名称名称类型
JSONdataJSON

唯一的端口显示名称为 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