Export range as format
Excel API : ExportRangeAsFormat
Overview
Converts the range of spreadsheet in cloud storage to the specified format.
Function Description
This method processes a range of spreadsheet directly in cloud storage, converting it to the requested output format (PDF, or Image format) without requiring the file to be downloaded to the local machine. The operation relies on valid cloud storage credentials and an accessible file path or identifier. The conversion is performed remotely, reducing data transfer and improving performance for large files. If the source file is not found, access is denied, or an error occurs during conversion, an appropriate exception will be thrown. Supported output formats are determined by the capabilities of the underlying cloud conversion service.
API Endpoint
GET http://api.aspose.cloud/v4.0/cells/{name}/worksheets/{worksheet}/ranges/{range}
The request parameters of exportRangeAsFormat API are:
| Parameter Name | Type | Path/Query String/HTTPBody | Description |
|---|---|---|---|
| name | String | Path | (Required) The name of the workbook file to be retrieved. |
| worksheet | String | Path | worksheet name |
| range | String | Path | range: A1:C12 |
| format | String | Query | (Required) The desired format (e.g., “png”, “Pdf”, “svg”). |
| folder | String | Query | (Optional) The folder path where the workbook is stored. The default is null. |
| storageName | String | Query | (Optional) The name of the storage if using custom cloud storage. Use default storage if omitted. |
| outPath | String | Query | (Optional) The folder path where the workbook is stored. The default is null. |
| outStorageName | String | Query | Output file Storage Name. |
| fontsLocation | String | Query | Use Custom fonts. |
| regoin | String | Query | The spreadsheet region setting. |
| password | String | Query | The password for opening spreadsheet file. |
Response Structure
{
File
}
Error Handling
- 400 Bad Request: Invalid url.
- 401 Unauthorized: Authentication has failed, or no credentials were provided.
- 404 Not Found: Source file not accessible.
- 500 Server Error The spreadsheet has encountered an anomaly in obtaining conversion data.
Usage Scenarios
Key Features and Benefits
- Cloud-Native Conversion: Processes spreadsheets directly in cloud storage, eliminating the need to download files to local machines.
- Format Versatility: Supports common output formats (XLSX, PDF, CSV) to meet diverse use cases (e.g., editing, sharing, data import).
- Simplified Workflow: Directly converts cloud-stored spreadsheets to needed formats without intermediate steps.
OpenAPI Specification
The OpenAPI Specification defines a publicly accessible programming interface and lets you carry out REST interactions directly from a web browser.
Excel API SDK
Using an SDK is the best way to speed up the development. An SDK takes care of low-level details and lets you focus on your project tasks. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.
The following code examples demonstrate how to make calls to Aspose.Cells web services using various SDKs: