Verschieben eines benannten Bereichs mit einer Excel-Arbeitsmappe über die Aspose.Cells Cloud API

Das Verschieben eines benannten Bereichs ist eine häufige Aufgabe, wenn Sie Daten programmgesteuert neu organisieren müssen. Dieser Abschnitt erläutert, wie Sie einen definierten Bereich auf derselben Arbeitsmappe an eine neue Position verschieben, mithilfe der Aspose.Cells Cloud REST API.

Diese REST-API verschiebt einen angegebenen Bereich an eine Zielposition innerhalb einer Excel-Arbeitsmappe.

REST-API

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

Authentifizierung

Die API erfordert ein Bearer JWT-Token, das über den OAuth-Flow von Aspose Cloud abgerufen wird. Fügen Sie das Token in den Authorization-Header ein:

Authorization: Bearer <jwt token>

Das Token muss den Scope Cells besitzen.

Voraussetzungen

  • Die Arbeitsmappe muss im Aspose Cloud-Speicher gespeichert sein.
  • Geben Sie den Speichernamen (storageName) und den Ordnerpfad (folder) an, wenn sich die Datei nicht im Root-Verzeichnis befindet.
  • Verwenden Sie die neueste Version des Aspose.Cells Cloud SDK, die API-Version v3.0 unterstützt.

Sicherheit und Authentifizierung

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

Anfrageparameter

Name Typ Position Beschreibung
name string path Name der Arbeitsmappe
sheetName string path Name des Arbeitsblatts
destRow integer query Startzeilenindex des Zielbereichs (0-basiert)
destColumn integer query Startspaltenindex des Zielbereichs (0-basiert)
range object body Definition des zu verschiebenden Quellbereichs
folder string query Ordnerpfad, in dem die Arbeitsmappe gespeichert ist
storageName string query Name des Aspose Cloud-Speichers

Anforderungstext

Feld Typ Erforderlich Beschreibung
ColumnCount integer Nein Anzahl der Spalten im Quellbereich
ColumnWidth integer Nein Breite jeder Spalte (in Punkten)
FirstColumn integer Nein Nullbasierter Index der ersten Spalte des Quellbereichs
FirstRow integer Nein Nullbasierter Index der ersten Zeile des Quellbereichs
Name string Nein Name des Bereichs (falls es sich um einen benannten Bereich handelt)
RefersTo string Nein A1-Referenzstil, der den Bereich definiert
RowCount integer Nein Anzahl der Zeilen im Quellbereich
RowHeight integer Nein Höhe jeder Zeile (in Punkten)
Worksheet string Nein Arbeitsblatt, das den Quellbereich enthält

Arbeitsablauf

  1. Hochladen der Arbeitsmappe in den Aspose Cloud-Speicher (sofern noch nicht vorhanden).
  2. Erstellen eines JWT-Tokens über den OAuth-Endpunkt.
  3. Erstellen des JSON-Payloads, der den Quellbereich beschreibt.
  4. Aufrufen des moveto-Endpunkts mit den erforderlichen Pfad- und Abfrageparametern sowie dem JSON-Body.
  5. Überprüfen der Antwort; bei erfolgreicher Ausführung wird ein Statuscode 200 OK zurückgegeben.

Beispielanfrage / -antwort

Im Fehlerfall enthält die Antwort ein optionales Feld ErrorMessage, das zusätzliche Details zum Fehler liefert.

HTTP-Statuscodes

Code Bedeutung Beschreibung
200 OK Filter erfolgreich angewendet; Antwort enthält Details zur Operation.
400 Bad Request Fehlende oder ungültige Parameter (z. B. nicht unterstützter Dateityp).
401 Unauthorized Ungültiges oder fehlendes JWT-Token.
413 Payload Too Large Die hochgeladene Datei überschreitet die Größe.
500 Internal Server Error Unerwarteter Serverfehler.

Antwortschema

Feld Typ Beschreibung
Code integer HTTP-ähnlicher Statuscode, der von der API zurückgegeben wird (z. B. 200)
Status string Textuelle Beschreibung des Ergebnisses (z. B. “OK”)
ErrorMessage string (optional) Menschlich lesbare Fehlerdetails im Fehlerfall

Cloud SDK-Familie

Die Verwendung eines SDK ist der beste Weg, die Entwicklungsgeschwindigkeit zu erhöhen. Ein SDK übernimmt die Low-Level-Details, sodass Sie sich auf Ihre Projektziele konzentrieren können. Besuchen Sie das GitHub-Repository für eine vollständige Liste der Aspose.Cells Cloud SDKs.

Die folgenden Codebeispiele zeigen, wie Aufrufe an Aspose.Cells-Webdienste mit verschiedenen SDKs durchgeführt werden: