Machen Sie die Tabellenkalkulationskonvertierung zu einem Einzeiler: Ein vollständiger Leitfaden zur Aspose.Cells Cloud Convert API (.NET / Python / Java)

Keine lokale Excel-Installation. Kein Konversionsserver zu warten. Wandeln Sie XLSX → PDF, Excel → CSV/JSON/Bilder/HTML in einfache REST‑Aufrufe um — und haben Sie Ihren ersten “Cloud-Tabellenkonverter” in etwa drei Minuten einsatzbereit.

“Konvertieren Sie diese Tabelle in ein anderes Format” ist eine der häufigsten Anforderungen in der täglichen Entwicklung:

• Finanz‑ und Rechtsteams wollen einen schreibgeschützten, manipulationssicheren PDF‑Bericht anstelle einer .xlsx, die jeder bearbeiten kann;
• Daten‑Teams 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 rendern;
• Portale benötigen saubere HTML / HTML‑Table‑Snippets zum Einbetten;
• Jemand muss einen Haufen .xls / .xlsx / .csv / .ods‑Dateien in ein Format normalisieren.

Die altmodischen Antworten — eine lokale Excel‑Installation mit Makros oder eine schwere COM‑Komponente auf Ihrem eigenen Server — sind schwer zu skalieren und plattformübergreifend zu erhalten. 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‑Mikroservice 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 sich der Formatkonvertierung / Export widmet. Er kapselt die engine-level, hochpräzise Konvertierung in drei Sätze von HTTP-APIs:

Implementierungshinweis: 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 eines gesamten Arbeitsbuchs kann der Controller ein einzelnes Element exportieren:

• Ein bestimmtes Arbeitsblatt → PDF / Bild / CSV / JSON / HTML
• Ein bestimmter Zellbereich (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 ein ganzes 50 MB‑Arbeitsbuch 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:

Kurz gesagt: spreadsheet-to-spreadsheet Konvertierungen jeder Art, plus die gesamte Familie von spreadsheet → PDF / Bild / Webdaten‑Ausgaben — alles hinter einer einzigen 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 ein Client Secret zu erhalten (die SDKs tauschen diese automatisch gegen ein JWT aus — kein Bedarf, Auth‑Header selbst zu erstellen).
2. Installieren Sie das SDK für Ihre bevorzugte Sprache:

<!-- .NET -->
<PackageReference Include="Aspose.Cells-Cloud" Version="25.x" />

# Python
pip install asposecellscloud

<!-- Java (Maven) — note: NOT on Maven Central, so the Aspose repo below is required -->
<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 reines REST, sodass cURL genauso gut funktioniert (siehe unten).

4. Szenario 1: Eine lokale Excel-Datei online konvertieren (die Überschrift 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. Es wird nichts im Cloud-Speicher persistiert und es bleibt keine Upload‑Kopie zurück — perfekt für “konvertiere das einfach für mich”-Momente.

① cURL

# 1) First, get a token
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

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",   // local file path
    format: "pdf");                          // target: pdf / csv / json / png ...

using Stream result = cellsApi.ConvertSpreadsheet(request); // converted file stream
using var outFile = File.Create("C:/invoices/Book1.pdf");
result.CopyTo(outFile);

// Even simpler: point the SDK at an output path and let it write the file
// cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf");

Benötigen Sie einen Batch-Job? Legen Sie dies in eine Schleife über ein Verzeichnis und Sie erhalten “konvertieren Sie den gesamten Ordner XLSX → PDF”.

③ Python

from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import ConvertSpreadsheetRequest
import os

instance = CellsApi(
    os.getenv('CellsCloudClientId'),
    os.getenv('CellsCloudClientSecret'))

# Local XLSX -> PDF, result written locally
instance.convert_spreadsheet(
    ConvertSpreadsheetRequest("Book1.xlsx", "pdf"),
    local_outpath="Book1.pdf")

# Other formats: just change the parameter — json / csv / xlsx / png ...

④ 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");   // local file path
        req.setFormat("pdf");                           // target: pdf / csv / json / png ...

File out = api.convertSpreadsheet(req);         // converted result as a File
        out.renameTo(new File("C:/invoices/Book1.pdf"));
        System.out.println("Converted: " + out.getAbsolutePath());
    }
}

Vier Sprachen, eine Aktion: Geben Sie einen Pfad + einen Formatparameter an → erhalten Sie die Zieldatei zurück. Das ist der gesamte Verkaufspunkt der Convert API — keine Excel‑Abhängigkeit auf der Aufruferseite, keine Vorlagen, keine COM‑Komponenten.

5. Szenario 2: Konvertieren einer in der Cloud gespeicherten Datei direkt

Wenn sich eine Datei bereits im Aspose Cloud Storage (oder Ihrem Objektspeicher) befindet, 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:

# cloud Book1.xlsx -> PDF, downloaded locally
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

from asposecellscloud.apis.cells_api import CellsApi
from asposecellscloud.requests import ExportSpreadsheetAsFormatRequest

instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET")

# Convert a cloud-stored workbook straight to PDF
instance.export_spreadsheet_as_format(
    ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports"))

Sie können auch ein einzelnes Element untersuchen — z. B. rendern Sie „the 3rd chart on Sheet1“ als PNG (Cloud‑Storage‑Variante):

# chart -> 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:

6. Szenario 3: SaveAs — das Ergebnis zurück in den Cloud‑Speicher schreiben

Wenn Sie die konvertierte Datei zurück im Cloud‑Speicher speichern (statt sie herunterzuladen), verwenden Sie PUT /v4.0/cells/{name}/saveas. Es ist eine natürliche Lösung für Automatisierungen wie „exportiere den heutigen Bericht als PDF zur Archivierung, jeden Tag“:

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 '{}'

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"))
# Result is saved directly in cloud storage; returns CellsCloudResponse(Code=200, Status="OK")

Sie können feinkörnige Speicheroptionen über den SaveOptionsData-Anforderungstext übergeben und Ausgabedateinamen, Ausgabespeicher, benutzerdefinierte Schriftarten, Region/Locale, Passwort usw. über Abfrageparameter steuern – mehr dazu unter Engineering-Details unten.

7. Weitere vorgefertigte “online convert”-Endpunkte

Neben den oben genannten Workbook‑Level‑Konvertierungen stellt der Controller einen vollständigen Satz dedizierter local-file → specific-target‑Endpunkte bereit (derselbe Request‑Body‑Upload wie in Szenario 1), die granularer und bandbreitenschonender sind.

Zum Beispiel, “exportiere nur diesen Bereich als CSV für das nachgelagerte System”:

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‑Body‑Muster wie convert/spreadsheet. Im .NET SDK haben die Diagramm‑Fälle typisierte Wrapper, die zu diesen v4.0‑Routen abbilden — ConvertChartToImage (convert/chart/image) und ConvertChartToPdf (convert/chart/pdf). Die Varianten worksheet/*, range/* und table/* haben noch keinen v4.0‑Wrapper, daher rufen Sie sie über reines REST genau so auf, wie das obige cURL es tut.

8. Technische Details & Fehlerbehandlung

Konvertierungsoptionen, die es zu kennen gilt (Abfrageparameter)

• password — passwortgeschützte Arbeitsmappen öffnen;
• fontsLocation / custom-font support — Glyphs beim Rendern von PDF/Bildern korrekt halten;
• automatisches Anpassen von Zeilen/Spalten und ob Zeilen-/Spaltenüberschriften (printHeadings) gedruckt werden sollen, Region-/Seiteneinrichtung (region) usw.;
• Ausgabeseite: outPath / outStorageName entscheiden, wo das Ergebnis im Cloud‑Speicher landet.

Fehlercodes (der Vertrag, den der Controller dokumentiert)

Authentifizierung

Alle SDKs authentifizieren sich automatisch mit OAuth 2.0 client_credentials und einem JWT; bei Verwendung von rohem cURL rufen Sie zuerst einmal /connect/token auf (siehe Szenario 1, ① oben).

9. Warum Aspose.Cells Cloud Convert?

• ✅ Keine lokalen Abhängigkeiten — kein Office/Excel, kein COM. Aufrufbar von jeder Sprache und jeder Plattform (Linux, Container, Serverless);
• ✅ Hochpräzise Darstellung — unterstützt durch die Aspose.Cells‑Engine, sodass Formeln, Diagramme, Stile und Seitennummerierung in professioneller Qualität in PDF/Bilder gerendert werden;
• ✅ Cloud‑native — Dateien können während der Konvertierung in der Cloud bleiben, um das Übertragen großer Datenmengen zu vermeiden; reine Online‑Konvertierung benötigt überhaupt keinen Cloud‑Speicher;
• ✅ Flexible Granularität — Arbeitsmappe / Arbeitsblatt / Bereich / Tabelle / Diagramm: konvertieren Sie genau das Stück, das Sie benötigen;
• ✅ Ein einheitliches Muster über SDKs hinweg — die cURL-, .NET-, Python- und Java‑Beispiele entsprechen 1:1, sodass Sie das gewünschte Muster buchstäblich übernehmen können.

Jetzt loslegen: Registrieren Sie sich im Aspose Cloud Dashboard, erstellen Sie eine Anwendung, fügen Sie Ihre Anmeldeinformationen in ein beliebiges Snippet oben ein und führen Sie es aus — Sie haben Ihren eigenen “cloud Excel converter” in wenigen Minuten.

Nützlich gefunden? Stern setzen, Lesezeichen setzen oder teilen Sie es — und erzählen Sie uns in den Kommentaren von Ihren eigenen Anwendungsfällen zur Tabellenkalkulationskonvertierung.