Daten in einem Bereich auf einem Excel-Arbeitsblatt sortieren

Die REST-API sortiert Daten innerhalb eines angegebenen Bereichs in einem Excel-Arbeitsblatt.

REST-API

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

Anforderungsparameter

Parametername	Typ	Speicherort	Erforderlich	Beschreibung
name	string	Pfad	Ja	Der Name der Arbeitsmappe.
sheetName	string	Pfad	Ja	Der Name des Arbeitsblatts.
cellArea	string	Abfrage	Ja	Der zu sortierende Zellbereich (z. B. `A5:A10`).
dataSorter	object	Körper	Ja	JSON-Objekt, das die Sortiereinstellungen definiert (siehe Schema unten).
folder	string	Abfrage	Nein	Der Ordner, der die Arbeitsmappe enthält.
storageName	string	Abfrage	Nein	Der Name des Speichers, in dem sich die Arbeitsmappe befindet.

dataSorter-Objektschema – Der Körper muss ein JSON-Objekt mit den folgenden Eigenschaften enthalten:

CaseSensitive (boolean, erforderlich) – Gibt an, ob die Sortierung zwischen Groß- und Kleinschreibung unterscheidet.
HasHeaders (boolean, erforderlich) – Gibt an, ob der Bereich eine Kopfzeile enthält.
KeyList (array, erforderlich) – Eine Sammlung von Sortierschlüsseln. Jedes Schlüsselobjekt enthält:
- Key (integer) – Nullbasierter Spaltenindex.
- SortOrder (string) – "ascending" (aufsteigend) oder "descending" (absteigend).
SortLeftToRight (boolean, erforderlich) – Wenn true, erfolgt die Sortierung von links nach rechts; andernfalls von oben nach unten.
(Optional) CaseOrder, SortLeftToRight usw. können gemäß der OpenAPI-Spezifikation ebenfalls angegeben werden.

Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt aus einem Webbrowser.

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

Anforderung

curl -v "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet1/sort?cellArea=A5:A10" \
  -X POST \
  -d '{"CaseSensitive":false,"HasHeaders":false,"KeyList":[{"Key":0,"SortOrder":"descending"}],"SortLeftToRight":false}' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Antwort

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

Fehlerbehandlung – Die API kann Standard-HTTP-Fehlercodes zurückgeben. Typische Antworten sind:

HTTP-Status	Code	Nachricht
400	400	Ungültige Anforderung – fehlende oder ungültige Parameter.
401	401	Nicht autorisiert – ungültiges oder fehlendes JWT-Token.
404	404	Nicht gefunden – Arbeitsmappe oder Arbeitsblatt existiert nicht.
500	500	Interner Serverfehler.

Der Antworttext folgt bei Fehlerfällen dem Muster { "Code": <status>, "Message": "<description>", "Status": "Error" }.

Cloud SDK-Familie

Die Verwendung eines SDKs ist die schnellste Möglichkeit zur Entwicklung. Ein SDK übernimmt die Details auf niedriger Ebene, sodass Sie sich auf Ihre Projekt Aufgaben 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-Webservices mithilfe verschiedener SDKs aufgerufen werden: