Erweiterte Excel-Dateikonvertierung – Aspose.Cells Cloud API-Anleitung

Erweiterte Cloud-API für Excel-Konvertierung

Die erweiterte Konvertierungsfunktion ermöglicht es Ihnen, eine Excel-Arbeitsmappe in verschiedene Ausgabeformate (PDF, HTML, CSV usw.) zu konvertieren und dabei eine detaillierte Kontrolle über die Seitenformatierung, Speicheroptionen und Druckeinstellungen auszuüben.

Voraussetzungen / Authentifizierung
Um diesen Endpunkt nutzen zu können, müssen Sie einen Zugriffstoken von Aspose.Cells Cloud erhalten und diesen im Authorization-Header als Bearer-Token übermitteln.

API-Referenz

  • Methode: PUT
  • Endpunkt: /cells/convert
  • Parameter:
    • format (Zeichenfolge, erforderlich) – Gewünschtes Ausgabeformat (z. B. pdf, html).
    • outPath (Zeichenfolge, optional) – Pfad im Cloud-Speicher, unter dem die konvertierte Datei gespeichert wird.
    • options (Objekt, optional) – JSON-Objekt mit erweiterten Konvertierungsoptionen wie pageSetup, saveOptions und printSettings.
  • Beispiel für Anforderungstext:
    {
      "format": "pdf",
      "outPath": "output/converted.pdf",
      "options": {
        "pageSetup": {
          "orientation": "Landscape",
          "paperSize": "A4"
        },
        "saveOptions": {
          "compress": true
        },
        "printSettings": {
          "printHeadings": false
        }
      }
    }
    
  • Antwort:
    • 200 OK – Konvertierung erfolgreich; Antwort enthält den konvertierten Dateistream oder einen Verweis auf die gespeicherte Datei.
    • 400 Bad Request – Ungültige Parameter oder fehlerhafter Anforderungstext.
    • 401 Unauthorized – Authentifizierung fehlgeschlagen oder Token fehlt.
    • 500 Internal Server Error – Serverseitiger Fehler während der Konvertierung.

HTTP-Statuscodes

Code Bedeutung Beschreibung
200 OK Konvertierung erfolgreich; Antwort enthält Details zum Vorgang.
400 Bad Request Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp).
401 Unauthorized Ungültiger oder fehlender JWT-Token.
413 Payload Too Large Die hochgeladene Datei überschreitet die maximale Dateigröße.
500 Internal Server Error Unerwarteter Serverfehler.

Hinweise

  • Einige Ausgabeformate weisen spezifische Einschränkungen auf (z. B. werden bei der HTML-Konvertierung Makros nicht beibehalten). Weitere Informationen finden Sie in der formatabhängigen Dokumentation.

Die Fähigkeit, Tabellendateien aus verschiedenen Datenquellen zu laden

Festlegen der Seitenformatierung und Speicheroptionen

Cloud SDK-Familie

Die Verwendung eines SDK beschleunigt die Entwicklung, da darin niedrigere Details abstrahiert werden, sodass Sie sich auf Ihre Projektaufgaben 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 Aufrufe an Aspose.Cells-Webdienste mithilfe verschiedener SDKs durchgeführt werden: