> Keine lokale Excel-Installation. Kein Konvertierungsserver zu warten. Verwandeln Sie XLSX → PDF, Excel → CSV/JSON/Bilder/HTML in einfache REST-Aufrufe — und haben Sie Ihren ersten “Cloud-Tabellenkalkulationskonverter” in etwa drei Minuten am Laufen. “Konvertieren Sie diese Tabellenkalkulation in ein anderes Format” ist eines der häufigsten Anforderungen in der täglichen Entwicklung: - Finanz- und Rechtsteams möchten einen schreibgeschützten, manipulationssicheren PDF-Bericht anstelle einer .xlsx, die jeder bearbeiten kann; - Datenteams müssen tabellarische Daten in nachgelagerte Systeme als CSV / JSON ziehen; - Web- und mobile Apps möchten Arbeitsblätter — und sogar Diagramme — direkt in PNG / SVG gerendert haben; - Portale benötigen saubere HTML / HTML-Tabellen-Snippets zum Einbetten; - Jemand muss eine Menge von .xls / .xlsx / .csv / .ods-Dateien in ein Format normalisieren. Die altmodischen Antworten — eine lokale Excel-Installation mit Makros oder eine schwergewichtige COM-Komponente auf Ihrem eigenen Server — sind schmerzhaft zu skalieren und schwer plattformübergreifend zu halten. Aspose.Cells Cloud ersetzt all das durch eine reine REST API: Laden Sie eine Datei hoch, erhalten Sie eine Datei im neuen Format zurück. Dieser Beitrag führt durch die drei Konvertierungs-APIs, die vom Kern ConversionController im Aspose.Cells Cloud-Microservice bereitgestellt werden (Quelle: src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs), mit ausführbaren Beispielen in cURL, C# (.NET), Python und Java. — ## 1. Was kann die Convert-Funktion tun? ConversionController ist der Controller, der der Formatkonvertierung / -export gewidmet ist. Er umschließt die motorseitige, hochpräzise Konvertierung in drei Sätze von HTTP-APIs: | # | Szenario | Typischer Endpunkt | Was es tut | | — | ———————————————————— | ———————————————— | —————————————————————————————————————————- | | 1 | Datei bereits im Cloud-Speicher → neuen Format herunterladen | GET /v4.0/cells/{name}?format=pdf | Konvertiert eine Arbeitsmappe direkt im Cloud-Speicher und streamt das Ergebnis zurück — große Dateien müssen nie zu Ihrem Computer reisen | | 2 | Lokale Datei → Online-Konvertierung (Hauptmerkmal) | PUT /v4.0/cells/convert/spreadsheet?format=pdf | Sie laden die Datei im Anforderungstext (multipart) hoch; der Server konvertiert sie und gibt die Ergebnisdatei direkt zurück | | 3 | Cloud-Datei → als neues Format speichern, zurück in den Cloud-Speicher | PUT /v4.0/cells/{name}/saveas?format=pdf | Die konvertierte Datei wird direkt zurück in den Cloud-Speicher geschrieben — ideal für automatisierte Pipelines | > Implementierungsnotiz: Die Quellrouten verwenden das Präfix v{version}/cells mit der API-Version 4.0, sodass Live-Aufrufe wie https://api.aspose.cloud/v4.0/cells/... aussehen. ### Die Granularität der Konvertierung geht weit über “die gesamte Datei” hinaus Neben der Konvertierung einer gesamten Arbeitsmappe kann der Controller ein einzelnes Element exportieren: - Ein bestimmtes Arbeitsblatt → PDF / Bild / CSV / JSON / HTML - Ein bestimmter Zellenbereich (z. B. A1:C12) → PDF / Bild / CSV / JSON / HTML - Eine bestimmte Tabelle → PDF / Bild / CSV / JSON / HTML - Ein bestimmtes Diagramm → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF So müssen Sie nie eine ganze 50 MB große Arbeitsmappe konvertieren, nur um ein Diagramm zu erhalten — konvertieren Sie nur das, was Sie benötigen, und sparen Sie Bandbreite und Rechenleistung. — ## 2. Welche Formate werden unterstützt? Basierend auf dem integrierten ExportData-Register im Controller sieht die Konvertierungsmatrix ungefähr so aus: | Typ | Formate | | —————————————– | ———————————————————————————————————————- | | Import und Export (bidirektional) | XLS, XLSX, XLSB, XLSM, CSV, TSV, ODS, TXT | | Nur Export | PDF, OTS, XPS, DIF, HTML / MHTML, JSON, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS, Markdown, DOCX, PPTX, SQL usw. | Kurz gesagt: Tabellenkalkulation-zu-Tabellenkalkulation-Konvertierungen jeder Art, plus die gesamte Familie von Tabellenkalkulation → PDF / Bild / Web-Daten-Ausgaben — alles hinter einer API-Oberfläche. — ## 3. Zwei Dinge, die Sie benötigen, bevor Sie beginnen 1. Registrieren Sie ein kostenloses Konto im Aspose Cloud Dashboard und erstellen Sie eine Anwendung, um eine Client ID und Client Secret zu erhalten (die SDKs tauschen diese automatisch gegen ein JWT aus — keine Notwendigkeit, Auth-Header selbst zu erstellen). 2. Installieren Sie das SDK für Ihre bevorzugte Sprache: xml <!-- .NET --> <PackageReference Include="Aspose.Cells-Cloud" Version="25.x" /> bash # Python pip install asposecellscloud xml <!-- Java (Maven) — Hinweis: NICHT auf Maven Central, daher ist das Aspose-Repo unten erforderlich --> <repositories> <repository> <id>AsposeJavaAPI</id> <name>Aspose Java API</name> <url>https://repository.aspose.cloud/repo/</url> </repository> </repositories> <dependency> <groupId>com.aspose</groupId> <artifactId>aspose-cells-cloud</artifactId> <version>26.8</version> </dependency> > Kein SDK erforderlich? Alles ist reine REST, daher funktioniert cURL genauso gut (siehe unten). — ## 4. Szenario 1: Konvertieren Sie eine lokale Excel-Datei online (die Haupt-Convert-API) Dies ist PUT /v4.0/cells/convert/spreadsheet — die Flaggschiff-“Convert”-API: Laden Sie Ihre lokale Datei im Anforderungstext hoch, der Server konvertiert sie und streamt die neue Datei zurück. Nichts wird im Cloud-Speicher gespeichert und keine Upload-Kopie bleibt zurück — perfekt für “konvertiere das einfach für mich”-Momente. ### ① cURL bash # 1) Zuerst ein Token erhalten curl -X POST "https://api.aspose.cloud/connect/token" \ -d "grant_type=client_credentials" \ -d "client_id=YOUR_CLIENT_ID" \ -d "client_secret=YOUR_CLIENT_SECRET" # 2) XLSX -> PDF curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet?format=pdf" \ -H "Authorization: Bearer $TOKEN" \ -F "file=@Book1.xlsx" \ -o Book1.pdf Ersetzen Sie format durch csv, json, png, xlsx… und Sie erhalten dieses Format. Ein Parameter, ein Ausgabeformat. ### ② C# / .NET csharp using Aspose.Cells.Cloud.SDK.Api; using Aspose.Cells.Cloud.SDK.Request; var cellsApi = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET"); var request = new ConvertSpreadsheetRequest( spreadsheet: "C:/invoices/Book1.xlsx", // lokaler Dateipfad format: "pdf"); // Ziel: pdf / csv / json / png ... using Stream result = cellsApi.ConvertSpreadsheet(request); // konvertierter Dateistream using var outFile = File.Create("C:/invoices/Book1.pdf"); result.CopyTo(outFile); // Noch einfacher: Zeigen Sie das SDK auf einen Ausgabepfad und lassen Sie es die Datei schreiben // cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf"); > Brauchen Sie einen Batch-Job? Legen Sie dies in eine Schleife über ein Verzeichnis und Sie haben “konvertieren Sie den gesamten Ordner XLSX → PDF”. ### ③ Python python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ConvertSpreadsheetRequest import os instance = CellsApi( os.getenv('CellsCloudClientId'), os.getenv('CellsCloudClientSecret')) # Lokale XLSX -> PDF, Ergebnis lokal geschrieben instance.convert_spreadsheet( ConvertSpreadsheetRequest("Book1.xlsx", "pdf"), local_outpath="Book1.pdf") # Andere Formate: Ändern Sie einfach den Parameter — json / csv / xlsx / png ... ### ④ Java java import com.aspose.cloud.cells.api.CellsApi; import com.aspose.cloud.cells.request.ConvertSpreadsheetRequest; import java.io.File; public class ConvertDemo { public static void main(String[] args) throws Exception { CellsApi api = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET"); ConvertSpreadsheetRequest req = new ConvertSpreadsheetRequest(); req.setSpreadsheet("C:/invoices/Book1.xlsx"); // lokaler Dateipfad req.setFormat("pdf"); // Ziel: pdf / csv / json / png ... File out = api.convertSpreadsheet(req); // konvertiertes Ergebnis als Datei out.renameTo(new File("C:/invoices/Book1.pdf")); System.out.println("Konvertiert: " + out.getAbsolutePath()); } } Vier Sprachen, eine Aktion: geben Sie einen Pfad + einen Formatparameter an → erhalten Sie die Zieldatei zurück. Das ist der ganze Verkaufsargument der Convert-API — keine Excel-Abhängigkeit auf der Anruferseite, keine Vorlagen, keine COM-Komponenten. — ## 5. Szenario 2: Konvertieren Sie eine im Cloud gespeicherte Datei direkt Wenn eine Datei bereits im Aspose Cloud Storage (oder Ihrem Objektspeicher) vorhanden ist, müssen Sie keine großen Dateien herunterladen/hochladen — die Konvertierung erfolgt in der Cloud, wodurch der Datentransfer minimiert und die Leistung bei großen Arbeitsmappen verbessert wird: bash # Cloud Book1.xlsx -> PDF, lokal heruntergeladen curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "format=pdf" \ --data-urlencode "folder=Reports" \ -o Book1.pdf python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ExportSpreadsheetAsFormatRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") # Konvertieren Sie eine im Cloud gespeicherte Arbeitsmappe direkt in PDF instance.export_spreadsheet_as_format( ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports")) Sie können auch in ein einzelnes Element eindringen — z. B. “das 3. Diagramm auf Sheet1” als PNG rendern (Cloud-Speicher-Variante): bash # Diagramm -> PNG curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/worksheets/Sheet1/charts/2" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "format=png" \ -o chart.png Granulare Cloud-Endpunkte auf einen Blick: | Ziel | Endpunkt | Beispiel format | | —————- | ——————————————————- | —————————– | | Ganze Arbeitsmappe | GET /v4.0/cells/{name} | pdf / xlsx / csv / json | | Einzelnes Arbeitsblatt | GET /v4.0/cells/{name}/worksheets/{ws} | pdf / png / svg | | Einzelner Bereich | GET /v4.0/cells/{name}/worksheets/{ws}/ranges/{range} | pdf / csv / json / html / png | | Einzelne Tabelle | GET /v4.0/cells/{name}/worksheets/{ws}/tables/{table} | pdf / csv / json / html / png | | Einzelnes Diagramm | GET /v4.0/cells/{name}/worksheets/{ws}/charts/{index} | pdf / png / jpeg / svg / tiff | — ## 6. Szenario 3: SaveAs — Schreiben Sie das Ergebnis zurück in den Cloud-Speicher Wenn Sie die konvertierte Datei wieder in den Cloud-Speicher speichern möchten (anstatt sie herunterzuladen), verwenden Sie PUT /v4.0/cells/{name}/saveas. Es ist eine natürliche Lösung für Automatisierungen wie “exportieren Sie den Bericht von heute als PDF zur Archivierung, jeden Tag”: bash curl -X PUT "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/saveas?format=pdf" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{}' python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import SaveSpreadsheetAsRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") instance.save_spreadsheet_as( SaveSpreadsheetAsRequest("Book1.xlsx", format="pdf", folder="Reports")) # Ergebnis wird direkt im Cloud-Speicher gespeichert; gibt CellsCloudResponse(Code=200, Status="OK") zurück Sie können feingranulare Speicheroptionen über den Anforderungstext SaveOptionsData übergeben und Ausgabedateiname, Ausgabespeicher, benutzerdefinierte Schriftarten, Region/Locale, Passwort usw. über Abfrageparameter steuern — mehr dazu unter Technische Details unten. — ## 7. Weitere fertige “Online-Konvertieren”-Endpunkte Neben den oben genannten Arbeitsmappenebenen-Konvertierungen stellt der Controller ein vollständiges Set von dedizierten lokalen Dateien → spezifischen Zielen-Endpunkten bereit (das gleiche Anforderungstext-Upload wie Szenario 1), die granularer und bandbreitensparender sind: | Ziel | Endpunkt (PUT, Präfix /v4.0/cells/convert/) | | ———————————————— | ——————————————————————————————————– | | Arbeitsmappe → PDF / JSON / CSV | spreadsheet/pdf, spreadsheet/json, spreadsheet/csv | | Arbeitsblatt → PDF / JSON / CSV / HTML / HTML-Tabelle | worksheet/pdf, worksheet/json, worksheet/csv, worksheet/html, worksheet/html-table | | Arbeitsblatt → Bild | worksheet/image?worksheet=Sheet1&format=png | | Bereich → PDF / CSV / HTML / JSON / Bild | range/pdf, range/csv, range/html, range/json, range/image?worksheet=..&range=A1:C12&format=png | | Tabelle → PDF / CSV / HTML / JSON / Bild | table/pdf, table/csv, table/html, table/json, table/image | | Diagramm → Bild / PDF | chart/image?worksheet=..&chartIndex=0&format=png, chart/pdf | Zum Beispiel, “exportieren Sie nur diesen Bereich als CSV für das nachgelagerte System”: bash curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/csv" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "worksheet=Sheet1" \ --data-urlencode "range=A1:C100" \ -F "file=@data.xlsx" \ -o data.csv Diese Endpunkte verwenden dasselbe Upload-im-Körper-Muster wie convert/spreadsheet. Im .NET SDK haben die Diagramm-Fälle typisierte Wrapper, die diesen v4.0-Routen zugeordnet sind — ConvertChartToImage (convert/chart/image) und ConvertChartToPdf (convert/chart/pdf). Die Varianten worksheet/*, range/* und table/* haben noch keinen v4.0-Wrapper, also rufen Sie sie genau so über reine REST auf, wie es das cURL oben tut. — ## 8. Technische Details & Fehlerbehandlung ### Konvertierungsoptionen, die es wert sind, bekannt zu sein (Abfrageparameter) - password — Öffnen von passwortgeschützten Arbeitsmappen; - fontsLocation / benutzerdefinierte Schriftartenunterstützung — Glyphen korrekt halten, wenn PDF/Bilder gerendert werden; - Automatisches Anpassen von Zeilen/Spalten und ob Zeilen-/Spaltenüberschriften gedruckt werden sollen (printHeadings), Region/Seitenlayout (region) usw.; - Auf der Ausgabeseite: outPath / outStorageName entscheiden, wo das Ergebnis im Cloud-Speicher landet. ### Fehlercodes (der Vertrag, den der Controller dokumentiert) | Status | Bedeutung | Typische Ursache | | ——- | ————– | ————————————————————- | | 400 | Ungültige Anfrage | Ungültige URL / Parameter oder ein nicht unterstütztes format | | 401 | Nicht autorisiert | Authentifizierung fehlgeschlagen oder keine gültigen Anmeldeinformationen bereitgestellt | | 404 | Nicht gefunden | Quelldatei ist im Cloud-Speicher nicht zugänglich | | 500 | Serverfehler | Der Dienst hat eine Anomalie beim Abrufen von Konvertierungsdaten festgestellt | ### Authentifizierung Alle SDKs authentifizieren sich automatisch mit OAuth 2.0 client_credentials und einem JWT; bei der Verwendung von rohem cURL rufen Sie zuerst /connect/token einmal auf (siehe Szenario 1, ① oben). — ## 9. Warum Aspose.Cells Cloud Convert? - ✅ Keine lokalen Abhängigkeiten — kein Office/Excel, keine COM. Von jeder Sprache und jeder Plattform (Linux, Container, serverlos) aufrufbar; - ✅ Hochpräzise Rendering — betrieben von der Aspose.Cells-Engine, sodass Formeln, Diagramme, Stile und Seitenumbrüche in professioneller Qualität in PDF/Bilder gerendert werden; - ✅ Cloud-nativ — Dateien können während der Konvertierung in der Cloud bleiben, um große Payloads zu vermeiden; reine Online-Konvertierungen benötigen überhaupt keinen Cloud-Speicher; - ✅ Flexible Granularität — Arbeitsmappe / Arbeitsblatt / Bereich / Tabelle / Diagramm: genau das Stück konvertieren, das Sie benötigen; - ✅ Eine Form über SDKs hinweg — die cURL-, .NET-, Python- und Java-Beispiele entsprechen 1:1, sodass Sie das Muster, das Ihnen gefällt, buchstäblich kopieren können. Jetzt starten: Registrieren Sie sich im Aspose Cloud Dashboard, erstellen Sie eine Anwendung, geben Sie Ihre Anmeldeinformationen in jeden obigen Snippet ein und führen Sie es aus — Sie haben Ihren eigenen “Cloud-Excel-Konverter” in Minuten. Fanden Sie das nützlich? Stern, Lesezeichen oder teilen Sie es — und erzählen Sie uns von Ihren eigenen Anwendungsfällen zur Tabellenkalkulationskonvertierung in den Kommentaren.