Skapa Excel-rapporter med Smart Marker-mallar – Aspose.Cells Cloud API-guide
Denna REST API skapar en arbetsbok med hjälp av en Smart Marker-mall.
Workbook SmartMarker API
POST https://api.aspose.cloud/v3.0/cells/{name}/smartmarker
Säkerhet och autentisering
Aspose.Cells Cloud API:er är säkra och kräver JWT-tokenbaserad autentisering.
Vad är en Smart Marker?
En Smart Marker är en platsmarkör-syntax som kopplar datafält i en XML- (eller JSON-) fil till celler i en Excel-mall. Vid körning ersätter Aspose.Cells markörerna med motsvarande data, vilket gör att du kan generera helt ifyllda rapporter programmerat.
Frågeparametrar
| Parameternamn | Typ | Beskrivning |
|---|---|---|
| outPath | string | Målsökväg dit den genererade arbetsboken kommer att sparas. |
| folder | string | Mapp som innehåller den ursprungliga arbetsboken. |
| storageName | string | Namn på den lagringstjänst som ska användas. |
Parametrar för begärandetext
| Parameternamn | Typ | Beskrivning |
|---|---|---|
| xmlFile | fil | Smart Marker-XML-datafilen som laddats upp med begäran. |
Svar
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
Anteckningar / Begränsningar:
- API:et stöder Excel-filer upp till 50 MB i storlek.
- Endast formatet .xlsx, .xlsm och .xlsb accepteras.
- En hastighetsbegränsning på 20 begäranden per sekund per konto tillämpas.
HTTP-statuskoder
| Kod | Betydelse | Beskrivning |
|---|---|---|
| 200 | OK | Filter tillämpades framgångsrikt; svaret innehåller åtgärdens detaljer. |
| 400 | Felaktig begäran | Saknade eller ogiltiga parametrar (t.ex. filtyp som inte stöds). |
| 401 | Auktoriseringsfel | Ogiltig eller saknad JWT-token. |
| 413 | Payload för stor | Den uppladdade filen överskrider storleksgränsen. |
| 500 | Internt serverfel | Oväntat serverfel. |
Hur man använder Workbook SmartMarker API
Workbook SmartMarker API-specifikation
OpenAPI-specifikationen definierar ett offentligt tillgängligt programmeringsgränssnitt och låter dig utföra REST-interaktioner direkt från en webbläsare.
Använd Aspose.Cells Cloud SDK:er
Du kan använda kommandoradsverktyget cURL för enkelt att komma åt Aspose.Cells-webbtjänster. Följande exempel visar hur man gör anrop till Cloud API med cURL.
Snabb rad-exempel
curl -X POST "https://api.aspose.cloud/v3.0/cells/{name}/smartmarker?outPath={outPath}" -H "Authorization: Bearer {access_token}" -F "xmlFile=@Sample_SmartMarker_Data.xml"
Felhantering
| HTTP-status | Beskrivning | Vanlig orsak |
|---|---|---|
| 400 | Felaktig begäran | Saknad mall, felaktig XML eller ogiltiga parametrar. |
| 401 | Auktoriseringsfel | Ogiltig eller saknad autentiseringstoken. |
| 404 | Hittades inte | Angiven arbetsbok eller lagringsplats finns inte. |
| 500 | Internt serverfel | Oväntat serverfel. |
Exempel på felaktigt svar (400)
{
"Code": 400,
"Message": "XML-datafilen saknas eller är felaktig."
}
Cloud SDK-familj
Att använda ett SDK är det bästa sättet att påskynda utvecklingen. Ett SDK hanterar detaljer på låg nivå så att du kan fokusera på dina projektuppgifter. Kolla in GitHub-lagret för en komplett lista över Aspose.Cells Cloud SDK:er.
Följande kodexempel visar hur man anropar Aspose.Cells-webbtjänster med olika SDK:er: