How to Create an Excel Workbook with a Template File
This REST API creates a workbook from a template file. It generates a new Excel workbook based on the supplied template and data.
REST API
| API | Type | Description | Swagger Link |
|---|---|---|---|
/cells/{name} |
PUT | Create a new Excel workbook from a template file | PutWorkbookCreate |
Query Parameters
Query Parameters – key‑value pairs that control workbook creation.
| Parameter Name | Type | Description |
|---|---|---|
templateFile |
string | Name of the template file stored in the cloud. |
dataFile |
string | Name of the data file (e.g., XML, JSON) used to populate the template. |
isWriteOver |
boolean | Flag indicating whether to overwrite an existing file. Pass true or false without quotes. |
folder |
string | Folder path where the original workbook resides. |
storageName |
string | Name of the storage service. |
Request Body Parameter
Request Body – contains the data file for Smart‑Marker placeholders.
| Parameter Name | Type | Description |
|---|---|---|
data |
file | File containing the data for the smart‑marker template (XML or JSON). |
Smart‑marker: a placeholder syntax that Aspose.Cells replaces with values from the supplied data file.
The OpenAPI Specification defines a publicly accessible programming interface and lets you carry out 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.
Error Handling
| HTTP Status | Meaning | Example Body |
|---|---|---|
| 200 | Workbook created successfully | { "Status": "OK", "Workbook": { … } } |
| 400 | Bad request – missing/invalid parameters | { "error": "Invalid isWriteOver value." } |
| 401 | Unauthorized – invalid or missing token | { "error": "Authentication required." } |
| 404 | Not found – template or data file not found | { "error": "File not found." } |
| 500 | Internal server error | { "error": "Unexpected server error." } |
Cloud SDK Family
Using an SDK is the best way to speed up development. An SDK abstracts low‑level details, letting 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 call Aspose.Cells web services using various SDKs: