Seitenlayout für ein Arbeitsblatt festlegen – Aspose.Cells Cloud API-Anleitung

Voraussetzungen: Um diese API aufzurufen, müssen Sie über ein gültiges JWT (OAuth)-Token verfügen, und die Arbeitsmappe muss sich in einem Aspose Cloud-Speicherort befinden, auf den Sie Lese-/Schreibrechte besitzen. Stellen Sie sicher, dass das Token im Authorization-Header enthalten ist und Ihr Konto über die erforderliche API-Quota verfügt.

Diese REST API legt das Seitenlayout für ein Excel-Arbeitsblatt fest.

REST API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pagesetup

Sicherheit und Authentifizierung

Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.

Anforderungsparameter

Parametername	Typ	Ort	Beschreibung
name	string	path	Dokumentname.
sheetName	string	path	Name des Arbeitsblatts.
pageSetup	object	body	Beschreibung des Seitenlayouts.
folder	string	query	Dokumentordner.
storageName	string	query	Speichername.

Beispiel-JSON-Payload für das pageSetup-Objekt

{
  "pageSetup": {
    "orientation": "Portrait",
    "paperSize": "A4",
    "fitToPagesTall": 1,
    "fitToPagesWide": 1,
    "centerHorizontally": true,
    "centerVertically": false
  }
}

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

Sie können das cURL-Befehlszeilentool verwenden, um problemlos auf Aspose.Cells-Webdienste zuzugreifen. Das folgende Beispiel zeigt, wie Sie mit cURL Aufrufe an die Cloud-API durchführen.

Anforderung

curl -v "https://api.aspose.cloud/v3.0/cells/myWorkbook.xlsx/worksheets/Tasks/pagesetup" \
-X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-H "Authorization: Bearer <jwt token>" \
-d '{
  "pageSetup": {
    "orientation": "Portrait",
    "paperSize": "A4",
    "fitToPagesTall": 1,
    "fitToPagesWide": 1,
    "centerHorizontally": true,
    "centerVertically": false
  }
}'

Antwort

Die API gibt ein JSON-Objekt zurück, das das Ergebnis des Vorgangs angibt:

{
  "Code": 200,
  "Status": "OK"
}

Mögliche Antwort-Statuscodes

Code	Bedeutung	Wenn
200	OK	Erfolgreiche Aktualisierung des Seitenlayouts
400	Bad Request	Ungültige JSON-Payload oder fehlende erforderliche Felder
401	Unauthorized	Fehlendes oder ungültiges JWT-Token
404	Not Found	Arbeitsmappe oder Arbeitsblattname existiert nicht
500	Internal Server Error	Unerwarteter Serverfehler

Cloud SDK-Familie

Die Verwendung eines SDK ist der beste Weg, die Entwicklung zu beschleunigen. Ein SDK übernimmt Details auf niedriger Ebene und ermöglicht es Ihnen, sich auf Ihre Projekt Aufgaben zu konzentrieren. Bitte 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 mit verschiedenen SDKs durchgeführt werden: