Excel-Berichte mit Smart-Marker-Vorlagen erstellen – Aspose.Cells Cloud API-Anleitung
Diese REST API erstellt eine Arbeitsmappe mithilfe einer Smart-Marker-Vorlage.
Workbook SmartMarker API
POST https://api.aspose.cloud/v3.0/cells/{name}/smartmarker
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Was ist ein Smart Marker?
Ein Smart Marker ist eine Platzhaltersyntax, die Datenfelder in einer XML- (oder JSON-) Datei mit Zellen einer Excel-Vorlage verknüpft. Zur Laufzeit ersetzt Aspose.Cells die Marker durch die entsprechenden Daten, sodass Sie vollständig ausgefüllte Berichte programmgesteuert generieren können.
Abfrageparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
| outPath | string | Zielpfad, in dem die generierte Arbeitsmappe gespeichert wird. |
| folder | string | Ordner, der die ursprüngliche Arbeitsmappe enthält. |
| storageName | string | Name des zu verwendenden Speicherdienstes. |
Parameter im Anforderungstext
| Parametername | Typ | Beschreibung |
|---|---|---|
| xmlFile | file | XML-Datendatei für Smart Marker, die mit der Anforderung hochgeladen wird. |
Antwort
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
Hinweise / Einschränkungen:
- Die API unterstützt Excel-Dateien mit einer Größe von bis zu 50 MB.
- Akzeptierte Formate sind ausschließlich .xlsx, .xlsm und .xlsb.
- Es gilt ein Limit von 20 Anforderungen pro Sekunde pro Konto.
HTTP-Statuscodes
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Filter erfolgreich angewendet; Antwort enthält Details zum Vorgang. |
| 400 | Bad Request | Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp). |
| 401 | Unauthorized | Ungültiges oder fehlendes JWT-Token. |
| 413 | Payload Too Large | Die hochgeladene Datei überschreitet das Größenlimit. |
| 500 | Internal Server Error | Unerwarteter Serverfehler. |
Verwendung der Workbook SmartMarker API
Spezifikation der Workbook SmartMarker API
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.
Verwendung der Aspose.Cells Cloud SDKs
Sie können das Kommandozeilentool cURL verwenden, um problemlos auf die Aspose.Cells-Webdienste zuzugreifen. Im folgenden Beispiel wird gezeigt, wie Aufrufe an die Cloud-API mit cURL durchgeführt werden.
Kurzes Einzeiler-Beispiel
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"
Fehlerbehandlung
| HTTP-Status | Beschreibung | Typische Ursache |
|---|---|---|
| 400 | Bad Request | Fehlende Vorlage, fehlerhafte XML oder ungültige Parameter. |
| 401 | Unauthorized | Ungültiges oder fehlendes Authentifizierungstoken. |
| 404 | Not Found | Die angegebene Arbeitsmappe oder Speicherposition existiert nicht. |
| 500 | Internal Server Error | Unerwarteter Serverfehler. |
Beispiel für eine Fehlerantwort (400)
{
"Code": 400,
"Message": "Die XML-Datendatei fehlt oder ist fehlerhaft."
}
Cloud SDK-Familie
Die Verwendung eines SDKs ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK übernimmt die Details auf niedriger Ebene, sodass Sie sich auf Ihre Projekt Aufgaben konzentrieren können. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.
Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mit verschiedenen SDKs aufgerufen werden: