将数据导入 Excel 文件并从 Excel 文件导出数据

Aspose.Cells Cloud API 支持从多种数据源导入数据，并可将 Excel 工作簿、图表及其他对象导出为多种格式，包括 XLSX、CSV、PDF、HTML、PNG 等。这使得数据管理和共享变得简单高效。

API 版本： v3.0 – 最后更新：2024‑03‑15

快速入门指南

准备请求体（payload） – 构建一个描述导入或导出选项的 JSON 正文（例如 ImportCSVDataOption、ExportOptions）。
发送请求 – 使用 curl、Postman 或 SDK 调用相应端点（POST /cells/import 或 POST /cells/export）。
处理响应 – 成功时，您将收到已处理的文件（二进制或 Base64 编码字符串）；失败时，请检查 HTTP 状态码及 JSON 正文中返回的错误信息。

前提条件

一个有效的 Aspose Cloud 账户及有效的 JWT 令牌。
目标工作簿必须存在于指定的存储位置（仅适用于基于存储的 API）。
正确设置 Content-Type 请求头（文件上传使用 multipart/form-data，JSON 正文使用 application/json）。

如何从各种数据源导入数据

将数据导入 Excel 文件涉及多个需要在过程中解决的考虑因素。能够以专业质量导入多种格式和类型的数据是 Aspose.Cells Cloud 的核心功能之一。

导入数据 API 概述

以下 API 用于将数据导入一个或多个 Excel 文件：

API	描述
POST /cells/import	不使用存储将数据导入 Excel 文件。
POST /cells/{name}/importdata	将数据导入存储在云端的 Excel 文件。

请求参数

不使用存储

参数名	类型	位置	描述
file	file	formData	待上传的文件
ImportOption	ImportOptions	body	指定导入格式（IntArray、DoubleArray、StringArray、TwoDimensionIntArray、TwoDimensionDoubleArray、TwoDimensionStringArray、BatchData、csvData、Picture）

使用存储

参数名	类型	位置	描述
name	string	path	Excel 文件名称
folder	string	query	存储中的文件夹路径
storageName	string	query	存储名称
importData	ImportOptions	body	导入数据请求体

导入数据选项参数

重要参数说明如下：

ImportBatchDataOption

参数	类型	描述
BatchData	List<CellValue>	待导入的批量数据
DestinationWorksheet	string	目标工作表名称
IsInsert	boolean	是否插入数据（true/false）
ImportDataType	string	TwoDimensionStringBatchDataArray
Source	FileSource	当 BatchData 为 null 时数据文件的位置

ImportCSVDataOption

参数	类型	描述
ConvertNumericData	boolean	是否将数字数据转换（true/false）
FirstRow	int	首行索引
FirstColumn	int	首列索引
SeparatorString	string	列分隔符
DestinationWorksheet	string	目标工作表名称
CustomParsers	List<CustomParserConfig>	自定义解析器配置
ImportDataType	string	CSVData
Source	FileSource	当 BatchData 为 null 时数据文件的位置

ImportPictureOption

参数	类型	描述
FirstRow	int	首行索引
FirstColumn	int	首列索引
IsVertical	boolean	图片是否垂直放置（true/false）
Data	string[]	图片数据（Base64 字符串数组）
DestinationWorksheet	string	目标工作表名称
IsInsert	boolean	是否插入数据（true/false）
ImportDataType	string	Picture
Source	FileSource	当 BatchData 为 null 时数据文件的位置

Import2DimensionIntArrayOption

参数	类型	描述
FirstRow	int	首行索引
FirstColumn	int	首列索引
Data	int[,]	二维整型数组
DestinationWorksheet	string	目标工作表名称
IsInsert	boolean	是否插入数据（true/false）
ImportDataType	string	TwoDimensionIntArray
Source	FileSource	当 BatchData 为 null 时数据文件的位置

Import2DimensionDoubleArrayOption

参数	类型	描述
FirstRow	int	首行索引
FirstColumn	int	首列索引
Data	double[,]	二维双精度浮点数组
DestinationWorksheet	string	目标工作表名称
IsInsert	boolean	是否插入数据（true/false）
ImportDataType	string	TwoDimensionDoubleArray
Source	FileSource	当 BatchData 为 null 时数据文件的位置

Import2DimensionStringArrayOption

参数	类型	描述
FirstRow	int	首行索引
FirstColumn	int	首列索引
Data	string[,]	二维字符串数组
DestinationWorksheet	string	目标工作表名称
IsInsert	boolean	是否插入数据（true/false）
ImportDataType	string	TwoDimensionStringArray
Source	FileSource	当 BatchData 为 null 时数据文件的位置

ImportIntegerArrayOption

参数	类型	描述
FirstRow	int	首行索引
FirstColumn	int	首列索引
IsVertical	boolean	数组是否为垂直方向（true/false）
Data	int[]	一维整型数组
DestinationWorksheet	string	目标工作表名称
IsInsert	boolean	是否插入数据（true/false）
ImportDataType	string	IntegerArray
Source	FileSource	当 BatchData 为 null 时数据文件的位置

ImportDoubleArrayOption

参数	类型	描述
FirstRow	int	首行索引
FirstColumn	int	首列索引
IsVertical	boolean	数组是否为垂直方向（true/false）
Data	double[]	一维双精度浮点数组
DestinationWorksheet	string	目标工作表名称
IsInsert	boolean	是否插入数据（true/false）
ImportDataType	string	DoubleArray
Source	FileSource	当 BatchData 为 null 时数据文件的位置

ImportStringArrayOption

参数	类型	描述
UpperLeftRow	int	左上角行索引
UpperLeftColumn	int	左上角列索引
LowerRightRow	int	右下角行索引
LowerRightColumn	int	右下角列索引
Filename	string	源文件名称
Data	string	待导入的字符串数据
DestinationWorksheet	string	目标工作表名称
IsInsert	boolean	是否插入数据（true/false）
ImportDataType	string	StringArray
Source	FileSource	当 BatchData 为 null 时数据文件的位置

CellValue

参数	类型	描述
rowIndex	int	单元格的行索引
columnIndex	int	单元格的列索引
type	string	单元格值的数据类型
value	string	单元格值
style	Style (object)	单元格样式定义

FileSource

参数	类型	描述
FileSourceType	string	InMemoryFiles、CloudFileSystem 或 RequestFiles
FilePath	string	源文件路径

如何将 Excel 对象导出为多种文件格式

若您原本以 XLS、XLSX、XLSB 或 CSV 等格式创建 Excel 文件，可能希望将其转换为其他格式以利用特定功能。例如，导出为 PDF 格式可防止内容被未授权修改，同时便于阅读和共享。

导出 Excel 对象涉及多个需要考虑的因素。Aspose.Cells Cloud 可高质量地将工作簿、图表、形状及图片导出为多种格式：

仅支持导出的格式：PDF、OTS、XPS、DIF、PNG、JPEG、BMP、SVG、TIFF、EMF、NUMBERS、FODS。
同时支持导入和导出的格式：XLS、XLSX、XLSB、CSV、TSV、XLSM、ODS、TXT。

该请求使用 multipart 内容，定义参见 [RFC 2046] 和 [RFC 1341]。第一部分包含数据文件；第二部分包含保存选项。

导出 API 概述

POST https://api.aspose.cloud/v3.0/cells/export

请求参数

参数名	类型	位置	描述
file	file	formData	待上传的文件
objectType	string	query	对象类型（`workbook`、`worksheet`、`chart`、`shape`、`picture`、`listobject`、`oleobject`）
format	string	query	目标输出文件格式（参见支持的文件格式）

OpenAPI 规范定义了一个公开可访问的编程接口，让您可直接从 Web 浏览器发起 REST 交互。

您可使用 cURL 命令行工具调用 API。以下示例展示了请求及其 JSON 响应。

请求

curl -v "https://api.aspose.cloud/v3.0/cells/export" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F 'file1=@example1.xlsx' \
  -F 'file2=@example2.xlsx'

响应

{
  "Files": [
    {
      "Filename": "example1.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "example2.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

常见 HTTP 状态码

状态码	含义	建议操作
200	成功 – 文件已导出	处理返回的文件
400	请求错误 – 缺失或无效参数	核查请求体及查询字符串
401	未授权 – JWT 令牌无效或已过期	刷新令牌后重试
404	未找到 – 指定的工作簿或工作表不存在	核查文件名称及存储路径
500	服务器内部错误 – 服务器端出现意外情况	联系 Aspose 支持并提供请求 ID

如何调用导入和导出 API

以下文章详细说明每个 API 并包含 cURL 和 SDK 示例：

合并和拆分 Excel 文件将 Excel 文件转换为其他格式或以不同方式保存