如何将本地电子表格表格数据转换为图像文件:分步指南

使用云 API 将本地 Excel 文件中的表格数据导出为 图像 文件。

支持的图像格式:

将表格转换为图像 API

使用此接口前,请确保满足以下前提条件:

  • 已通过 Aspose.Cells Cloud 身份验证获取有效的 JWT 访问令牌。
  • 若需使用 outPathoutStorageName 参数,则需具备可访问的存储账户。
  • 源工作簿(本地 Excel 文件)必须可读;若已加密,还需提供正确的密码。

Web API

PUT https://api.aspose.cloud/v4.0/cells/convert/table/image

安全与身份验证

Aspose.Cells Cloud API 安全可靠,需采用 基于 JWT 令牌的身份验证

请求参数:

参数名称 类型 路径/查询字符串/HTTP 请求体 描述
Spreadsheet 文件 FormData 上传电子表格文件。
worksheet 字符串 查询字符串 电子表格/Excel 中的工作表名称。
tableName 字符串 查询字符串 要转换的表格名称。
format 字符串 查询字符串 期望的图像文件格式(例如:png、svg)。
outPath 字符串 查询字符串 (可选)转换后图像文件的存储路径,默认为 null。
outStorageName 字符串 查询字符串 指定输出文件的存储名称。
fontsLocation 字符串 查询字符串 如有需要,可指定自定义字体路径。
region 字符串 查询字符串 电子表格区域/语言设置(例如:en-USfr-FR)。影响数字格式化、日期解析及本地化行为。
password 字符串 查询字符串 访问电子表格文件所需的密码。

响应

[
  {
    "Name": "ResponseFile",
    "DataType": {
      "Identifier": "File",
      "Reference": "Stream"
    }
  }
]

HTTP 状态码

状态码 含义 描述
200 OK(成功) 过滤器应用成功;响应包含操作详情。
400 Bad Request(错误请求) 缺少或无效参数(例如:不支持的文件类型)。
401 Unauthorized(未授权) JWT 令牌无效或缺失。
413 Payload Too Large(请求实体过大) 上传文件超出大小限制。
500 Internal Server Error(内部服务器错误) 服务器发生意外错误。

应在哪里使用将表格转换为图像 API?

  • 静态报告快照:将财务表格、计算结果或任何格式化数据转换为图像,以便嵌入 PDF 报告、PowerPoint 幻灯片或打印文档中(无需后续编辑)。
  • 演示文稿中的数据可视化:将带有条件格式或简单图表的复杂电子表格表格转换为图像,嵌入 PPTX 或 Google Slides 演示文稿中。
  • 文档与培训材料:将电子表格示例、模板或数据录入表单截取为图像,用于用户手册、教程或知识库文章。
  • 缩略图预览:为关键电子表格区域生成小尺寸图像预览,适用于文件浏览器、文档库或搜索结果中。

为何应使用将表格转换为图像 API?

  • 开发者友好:Aspose.Cells Cloud 提供多种编程语言的 SDK 库,支持快速开发,并配有详尽文档。相比构建自定义渲染方案,可显著减少开发工作量。
  • 经济高效:无需先上传整个工作簿即可转换表格数据,节省存储空间并降低费用。
  • 像素级精准还原:输出图像忠实还原 Excel 原始外观——包括单元格格式、公式(显示值)、边框、颜色及条件格式。
  • 通用兼容性:图像格式(PNG、JPEG、TIFF、BMP、SVG 等)可在任意设备或平台查看,无需专用软件,确保最佳可访问性。

如何结合 SDK 使用将表格转换为图像 API?

将表格转换为图像 API 规范

将表格转换为图像 API 规范 提供了一个公开可访问的编程接口,可直接通过网页浏览器发起 REST 请求。

您可使用 cURL 命令行工具轻松调用 Aspose.Cells Web 服务。以下示例展示了如何通过 cURL 调用云 API:

使用 Aspose.Cells Cloud SDK

使用 SDK 是最快捷的开发方式,它屏蔽了底层细节,仅需少量代码即可将电子表格表格数据转换为图像。请查阅 GitHub 仓库,获取 Aspose.Cells Cloud SDK 的完整列表。

以下代码示例展示了如何使用不同 SDK 调用 Aspose.Cells Web 服务: