Konvertieren einer Excel-Datei in verschiedene Formate
Bevor Sie diesen Endpunkt aufrufen, stellen Sie sicher, dass Sie ein gültiges JWT-Token besitzen und sich die Quelldatei in einem unterstützten Speicherort befindet (z. B. Aspose Cloud Storage). Geben Sie das Token im Authorization-Header an und geben Sie ggf. den Abfrageparameter storageName an.
Diese REST API konvertiert eine Excel-Datei in verschiedene Ausgabeformate.
PutConvertWorkBook API
PUT https://api.aspose.cloud/v3.0/cells/convert
Die Anfrage ist ein HTTP PUT mit multipart-Inhalt (siehe RFC 2046 oder RFC 1341).
Der erste Teil des multipart-Körpers enthält die Daten-Datei, der zweite Teil enthält die Speicheroptionen.
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
Abfrageparameter
| Parametername | Typ | Beschreibung |
|---|---|---|
format |
string | Ziel-Dateiformat (z. B. CSV, XLS, HTML, PDF, XML, TXT, TIFF, PNG, JPG, GIF, EMF, BMP, MD, Numbers, WMF, SVG usw.). |
password |
string | Passwort, das zum Öffnen der Quell-Excel-Datei erforderlich ist. |
outPath |
string | Vollständiger Pfad (einschließlich Dateiname und -erweiterung) für eine einzelne Ausgabedatei bzw. ein Ordnerpfad, wenn mehrere Dateien generiert werden. |
storageName |
string | Name des Speichers, in dem sich die Quelldatei befindet. |
checkExcelRestriction |
bool | Wenn true, werden Excel-Beschränkungen vor dem Ändern von Zellen oder zugehörigen Objekten überprüft. |
streamFormat |
string | Format des Eingabedatenstroms. |
region |
string | Auf die Arbeitsmappe angewendete regionale Einstellungen. |
pageWideFitOnPerSheet |
bool | Passt die Seitenbreite an, sodass jedes Arbeitsblatt bei der Konvertierung in PDF vollständig passt. |
pageTallFitOnPerSheet |
bool | Passt die Seitenhöhe an, sodass jedes Arbeitsblatt bei der Konvertierung in PDF vollständig passt. |
sheetName |
string | Name des Arbeitsblatts, das konvertiert werden soll. |
pageIndex |
string | Index der zu konvertierenden Seite (erfordert sheetName). |
onePagePerSheet |
bool | Wenn true, wird eine PDF-Seite pro Arbeitsblatt generiert. |
AutoRowsFit |
bool | Passt automatisch alle Zeilen in der Arbeitsmappe an. |
AutoColumnsFit |
bool | Passt automatisch die Spaltenbreiten in der Arbeitsmappe an. |
Parameter im Anforderungstext
| Parametername | Typ | Beschreibung |
|---|---|---|
datafile |
data file | Die Excel-Datei, die im ersten Teil des multipart-Körpers übergeben wird. |
SaveOptions |
object | Speicheroptionen, die im zweiten Teil des multipart-Körpers übergeben werden. |
Antwort
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream",
"Name": "file"
}
}
HTTP-Statuscodes
| Code | Bedeutung | Beschreibung |
|---|---|---|
| 200 | OK | Filter erfolgreich angewendet; die 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 PutConvertWorkBook API mit SDKs
PutConvertWorkBook API-Spezifikation
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Schnittstelle, die direkte REST-Interaktionen aus einem Webbrowser ermöglicht.
cURL-Beispiel
curl -X PUT "https://api.aspose.cloud/v3.0/cells/convert?format=html" \
-H "accept: multipart/form-data" \
-H "Content-Type: multipart/form-data" \
-H "x-aspose-client: Containerize.Swagger" \
-d '{"File":{}}'
Verwendung der Aspose.Cells Cloud SDKs
Die Verwendung eines SDKs beschleunigt die Entwicklung, da niedrigstufige Details automatisch behandelt werden, sodass Sie sich auf die Geschäftslogik konzentrieren können. Eine vollständige Liste der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.
Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webdienste mit verschiedenen SDKs aufgerufen werden: