Build Excel Reports with Smart Marker Templates

This REST API creates a workbook using a Smart Marker template.

REST API

API	Type	Description	Swagger Link
/cells/{name}/smartmarker	POST	Create a new Excel workbook from a Smart Marker template file	PostWorkbookGetSmartMarkerResult

What is a Smart Marker?

A Smart Marker is a placeholder syntax that maps data fields in an XML (or JSON) file to cells in an Excel template. At runtime Aspose.Cells replaces the markers with the corresponding data, allowing you to generate fully populated reports programmatically.

Query Parameters

Parameter Name	Type	Description
outPath	string	Destination path where the generated workbook will be saved.
folder	string	Folder containing the original workbook.
storageName	string	Name of the storage service to use.

Request Body Parameter

Parameter Name	Type	Description
xmlFile	file	Smart Marker XML data file uploaded with the request.

The OpenAPI Specification defines a publicly accessible programming interface and lets you carry out REST interactions directly from a web browser.

You can use 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.

Request

curl -X POST "https://api.aspose.cloud/v3.0/cells/newworkbook_14.xlsx/smartmarker?outPath=GeneratedReport.xlsx" \
    -H "accept: multipart/form-data" \
    -H "x-aspose-client: Containerize.Swagger" \
    -F "xmlFile=@Sample_SmartMarker_Data.xml"

Response

HTTP/1.1 200 OK
Content-Type: application/json

{
  "status": "OK",
  "message": "Workbook generated successfully.",
  "downloadUrl": "https://api.aspose.cloud/v3.0/storage/file/GeneratedReport.xlsx"
}

Error Handling

HTTP Status	Description	Typical Cause
400	Bad Request	Missing template, malformed XML, or invalid parameters.
401	Unauthorized	Invalid or missing authentication token.
404	Not Found	Specified workbook or storage location does not exist.
500	Internal Server Error	Unexpected server‑side failure.

Cloud SDK Family

Using an SDK is the best way to speed up development. An SDK handles low‑level details so you can 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:

How to Create an Excel Workbook with a Template File