Arbeitsblattseite exportieren – Aspose.Cells Cloud API Referenz

Das Exportieren einer bestimmten Arbeitsblattseite ist nützlich, wenn Sie ein druckfähiges Snapshot eines Berichts, ein Diagrammbild oder einen Daten-Auszug benötigen, ohne die gesamte Arbeitsmappe herunterladen zu müssen. Dieser Endpunkt ermöglicht es Ihnen, eine einzelne Seite im Format abzurufen, das am besten für Ihren weiteren Workflow geeignet ist.

Die GET /cells/{name}/worksheets/{sheetName}-API ermöglicht die Konvertierung einer bestimmten Seite eines Arbeitsblatts in verschiedene Dateiformate. Unterstützte Formate: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT, PDF, OTS, XPS, DIF, PNG, JPEG, GIF, BMP, WMF, TIFF, EMF, NUMBERS, FODS.

REST API

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht es Ihnen, REST-Interaktionen direkt aus einem Webbrowser durchzuführen.

Voraussetzungen – Sie benötigen ein gültiges JWT-Authentifizierungstoken sowie die Arbeitsmappe, die sich in einem Cloud-Ordner befindet, den Sie mit dem Parameter folder angeben.

Sie können das cURL-Befehlszeilentool verwenden, um problemlos auf die Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie ein Aufruf an die Cloud-API mit cURL durchgeführt wird.

Anfrage

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1?format=png&verticalResolution=100&horizontalResolution=90&pageIndex=1&folder=DotnetFiles" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Antwort

Antwort – Der Dienst gibt die angeforderte Seite im gewählten Format zurück. Bei Bildformaten (png, jpeg, gif usw.) enthält der Antworttext die binäre Bilddatei; bei Dokumentformaten (pdf, xls, csv usw.) enthält der Antworttext den Dateiinhalt. Ein erfolgreicher Aufruf gibt HTTP 200 zurück.

Beispiel einer PNG-Antwort (gekürzter Base64-Auszug):

iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABG0lEQVR42mNkYGBg+M+ABbJw
...

Parameter

Parameter	Typ	Beschreibung	Standardwert
`format`	string	Ausgabedateiformat (z. B. `pdf`, `png`, `csv`).	`pdf`
`verticalResolution`	integer	Vertikale DPI des gerenderten Bildes.	`100`
`horizontalResolution`	integer	Horizontale DPI des gerenderten Bildes.	`100`
`pageIndex`	integer	Nullbasiertes Index der zu exportierenden Arbeitsblattseite (`0` = erste Seite).	`0`
`folder`	string	Cloud-Speicherordner, in dem sich die Quell-Arbeitsmappe befindet.	—

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ültiger oder fehlender JWT-Token.
413	Payload Too Large	Die hochgeladene Datei überschreitet das Größenlimit.
500	Internal Server Error	Unerwarteter Serverfehler.

Mögliche Fehler

401 Unauthorized – Ungültiger oder fehlender JWT-Token.
404 Not Found – Die angegebene Arbeitsmappe oder das angegebene Arbeitsblatt existiert nicht.
400 Bad Request – Ungültiger Parameterwert (z. B. nicht unterstütztes format).
500 Internal Server Error – Unerwartetes serverseitiges Problem.

Cloud SDK-Familie

Die Verwendung eines SDK ist die beste Möglichkeit, die Entwicklung zu beschleunigen. Ein SDK übernimmt die Low-Level-Details, 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 Aspose.Cells-Webdienste mit verschiedenen SDKs aufgerufen werden:

Bereich einer Arbeitsmappe in PNG, PDF, CSV exportieren – Aspose.Cells Cloud API