导出 Excel 图表 – 文档
Contents
[
Hide
]
将 Excel 工作簿中的图表对象导出为各种图像和文档格式,是报表制作与发布过程中常见的需求。Aspose.Cells Cloud 提供了一个简单的 REST 接口,可直接将图表转换为 PNG、JPEG、PDF、SVG、TIFF、EMF、WMF 等常用格式。
您可以将图表导出为以下格式:PNG、GIF、JPEG、BMP、SVG、TIFF、EMF、WMF 和 PDF。
前置条件:
- 拥有有效订阅的 Aspose.Cells Cloud 账户。
- 通过身份验证流程获取的 OAuth 2.0 Bearer 令牌(JWT)。
- 待上传的工作簿文件(文件大小需 < 50 MB)。
REST API
POST https://api.aspose.cloud/v3.0/cells/export
安全与身份验证
Aspose.Cells Cloud API 是安全的,需要使用 基于 JWT 令牌的身份验证。
请求参数
| 参数名称 | 类型 | 路径 / 查询字符串 / HTTP 请求体 | 是否必填 | 描述 |
|---|---|---|---|---|
| file | 文件 | formData | 是 | 待上传的文件 |
| objectType | 字符串 | query | 是 | 要导出的对象类型。导出图表时使用 chart;其他可能值包括 worksheet、picture 等 |
| format | 字符串 | query | 是 | 目标输出格式。支持的值:png、jpeg、gif、bmp、svg、tiff、emf、wmf、pdf |
响应示例
{
"Files": [
{
"Filename": "Book1_xlsx_Sheet4_Charts_0.tif",
"FileSize": 10040,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet4_Charts_1.tif",
"FileSize": 12978,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet4_Charts_2.tif",
"FileSize": 7002,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet4_Charts_3.tif",
"FileSize": 11532,
"FileContent": "-----Base64String--------"
},
{
"Filename": "Book1_xlsx_Sheet6_Charts_0.tif",
"FileSize": 8270,
"FileContent": "-----Base64String--------"
},
{
"Filename": "myDocument_xlsx_Sheet3_Charts_0.tif",
"FileSize": 42570,
"FileContent": "-----Base64String--------"
},
{
"Filename": "myDocument_xlsx_Sheet3_Charts_1.tif",
"FileSize": 12102,
"FileContent": "-----Base64String--------"
},
{
"Filename": "myDocument_xlsx_Sheet3_Charts_2.tif",
"FileSize": 8290,
"FileContent": "-----Base64String--------"
}
]
}
HTTP 状态码说明
| 状态码 | 含义 | 描述 |
|---|---|---|
| 200 | OK(成功) | 操作成功应用;响应包含操作详情。 |
| 400 | Bad Request(请求错误) | 参数缺失或无效(例如:不支持的文件类型)。 |
| 401 | Unauthorized(未授权) | JWT 令牌无效或缺失。 |
| 413 | Payload Too Large(请求体过大) | 上传文件超过大小限制。 |
| 500 | Internal Server Error(服务器内部错误) | 发生了意外的服务器错误。 |
如何使用 PostExport API 与 SDK
PostExport API 规范
OpenAPI 规范 定义了一个公开可访问的编程接口,使您能直接通过网页浏览器发起 REST 调用。
所有请求必须在 Authorization 请求头中包含有效的 OAuth 2.0 Bearer 令牌。以下示例展示了如何使用 cURL 调用该 API 并以 multipart/form-data 方式上传工作簿文件:
curl -X POST "https://api.aspose.cloud/v3.0/cells/export?objectType=chart&format=tiff" \
-H "Authorization: Bearer {access_token}" \
-H "Accept: multipart/form-data" \
-H "Content-Type: multipart/form-data" \
-H "x-aspose-client: Containerize.Swagger" \
-F "File=@/path/to/your/workbook.xlsx"
使用 Aspose.Cells Cloud SDK
使用 SDK 是加快开发速度的最佳方式。SDK 会处理底层细节,让您专注于项目核心任务。请查阅 GitHub 仓库,获取 Aspose.Cells Cloud SDK 的完整列表。
以下代码示例展示了如何使用不同 SDK 调用 Aspose.Cells Web 服务: