json_JsonToTable函数
函数名:json_Json转表格 / json_JsonToTable
函数功能
将JSON格式数据转换为Excel表格结构,支持从文件路径或直接文本输入读取,可配置是否包含字段标题行。
参数规范
| 参数名 | 类型 | 必填 | 示例 | 特殊说明 |
|---|---|---|---|---|
jsonInput | String | 是 | "C:\\data.json" | 支持文件路径或原始JSON文本 |
includeHeaders | Boolean | 否 | FALSE | 默认为TRUE显示字段名 |
支持的JSON格式
1. 标准对象数组格式(推荐)
json
[
{"id": 1, "name": "产品A", "price": 99.9},
{"id": 2, "name": "产品B", "price": 199.9}
]2. 简单嵌套格式(仅支持1层嵌套)
json
[
{"id": 1001, "details": "颜色:红,尺寸:XL"},
{"id": 1002, "details": "颜色:蓝,尺寸:M"}
]使用案例
基础转换案例
输入JSON:
json
[{"员工编号":"E1001","姓名":"张三","部门":"技术部"},{"员工编号":"E1002","姓名":"李四","部门":"市场部"}]公式演示:
excel
=json_JsonToTable(A1)输出效果:
| 员工编号 | 姓名 | 部门 |
|---|---|---|
| E1001 | 张三 | 技术部 |
| E1002 | 李四 | 市场部 |
技术说明
类型转换规则
| JSON类型 | Excel转换结果 |
|---|---|
| string | 文本 |
| number | 数值 |
| boolean | TRUE/FALSE |
| object | 转换为字符串格式 |
| null | 空单元格 |
异常处理
| 错误场景 | 返回值 |
|---|---|
| JSON格式错误 | 错误:无效的JSON数据 |
| 文件读取失败 | 返回异常信息 |
| 空数组输入 | 返回单行错误提示 |
重要限制说明
- ✖ 不支持嵌套对象/数组结构(如:
{"a":{"b":1}}) - ✖ 不支持多层JSON结构(超过1层嵌套)
- ✖ 不支持直接解析数组类型的值(如:
{"tags":["A","B"]}) - ✖ 单个JSON文件大小超过1MB可能导致解析失败
注:如需处理复杂嵌套JSON,建议先使用预处理工具将数据展平,或联系开发人员获取专业版解析工具