How to Convert Local Spreadsheet Table Data to an Image File: Step‑by‑Step Guide
Export table data from a local Excel file to an Image file using the Cloud API.
Supported IMAGE FORMATS:
Convert Table to Image API
Before using this endpoint, ensure you have the following prerequisites:
- A valid JWT access token obtained through Aspose.Cells Cloud authentication.
- An accessible storage account if you intend to use the
outPathoroutStorageNameparameters. - The source workbook (local Excel file) must be readable and, if protected, the correct password must be supplied.
Web API
PUT https://api.aspose.cloud/v4.0/cells/convert/table/image
Security and Authentication
The Aspose.Cells Cloud APIs are secure and require JWT token-based authentication.
Request Parameters:
| Parameter Name | Type | Path/Query String/HTTP Body | Description |
|---|---|---|---|
| Spreadsheet | File | FormData | Upload the spreadsheet file. |
| worksheet | String | Query | The worksheet name of the spreadsheet/Excel. |
| tableName | String | Query | Name of the table to convert. |
| format | String | Query | Desired image file format (e.g., png, svg). |
| outPath | String | Query | (Optional) The folder path where the converted image will be stored. Defaults to null. |
| outStorageName | String | Query | Specify the output file storage name. |
| fontsLocation | String | Query | Use custom fonts if required. |
| region | String | Query | Spreadsheet region/language setting (e.g., en-US, fr-FR). Influences number formatting, date parsing, and locale‑specific behavior. |
| password | String | Query | Password required to access the spreadsheet file. |
Response
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
HTTP Status Codes
| Code | Meaning | Description |
|---|---|---|
| 200 | OK | Filter applied successfully; response contains operation details. |
| 400 | Bad Request | Missing or invalid parameters (e.g., unsupported file type). |
| 401 | Unauthorized | Invalid or missing JWT token. |
| 413 | Payload Too Large | Uploaded file exceeds size limit. |
| 500 | Internal Server Error | Unexpected server error. |
Where Should You Use the Convert Table to Image API?
- Static Report Snapshots: Convert financial tables, calculation results, or any formatted data into images for inclusion in PDF reports, PowerPoint slides, or printed documents where editing is not required.
- Data Visualization in Presentations: Turn complex spreadsheet tables—complete with conditional formatting or simple visualizations—into images that can be embedded in presentations (PPTX, Google Slides).
- Documentation & Training Materials: Capture spreadsheet examples, templates, or data‑entry forms as images for user manuals, tutorials, or knowledge‑base articles.
- Thumbnail Previews: Generate small image previews of key spreadsheet sections for file browsers, document libraries, or search results.
Why should you use the Convert Table to Image API?
- Developer‑Friendly: Aspose.Cells Cloud offers SDK libraries in multiple languages, enabling rapid development and comes with comprehensive documentation. Compared with building custom rendering solutions, this significantly reduces development workload.
- Cost‑Effective: You can convert table data without first uploading the entire workbook, saving storage space and reducing costs.
- Pixel‑Perfect Preservation: Faithfully reproduces Excel’s appearance—including cell formatting, formulas (as displayed values), borders, colors, and conditional formatting—in the output image.
- Universal Compatibility: Image formats (PNG, JPEG, TIFF, BMP, SVG, etc.) are viewable on any device or platform without specialized software, ensuring maximum accessibility.
How to Use the Convert Table to Image API with SDKs?
Convert Table to Image API Specification
The Convert Table to Image API Specification provides a publicly accessible programming interface for conducting REST interactions directly from a web browser.
You can use the cURL command‑line tool to access Aspose.Cells web services easily. The following example shows how to make calls to the Cloud API with cURL.
Use Aspose.Cells Cloud SDKs
Using the SDK is the fastest way to develop, as it abstracts away low‑level details, allowing you to convert spreadsheet table data to an image with minimal code. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.
The following code examples illustrate how to invoke Aspose.Cells web services using various SDKs: