Spalten gruppieren – Aspise.Cells Cloud API-Dokumentation

Spalten in einem Excel-Arbeitsblatt gruppieren

API-Version: v3.0
Vorgang: PostGroupWorksheetColumns – Gruppiert Spalten in einem Arbeitsblatt.

Übersicht

Diese REST-API ermöglicht das Gruppieren eines Bereichs von Spalten in einem Arbeitsblatt. Gruppierte Spalten können ein- oder ausgeblendet werden, sodass Sie einklappbare Abschnitte erstellen können, die denen in Microsoft Excel ähneln.

Voraussetzungen

  • Ein gültiges JWT-Zugriffstoken, das beim Aspose Cloud-Authentifizierungsdienst abgerufen wurde.
  • Die Arbeitsmappe muss an einem Ort gespeichert sein, der für Aspose.Cells Cloud zugänglich ist (Standardspeicher oder benutzerdefinierter Speichername).
  • Erforderliche SDK-Version (falls ein SDK verwendet wird): Die neueste Veröffentlichung, die API-Version v3.0 unterstützt.

Authentifizierung

Alle Anforderungen erfordern eine Bearer-Token-Authentifizierung.

Authorization: Bearer <access_token>

Einzelheiten zum Abrufen eines Tokens finden Sie im JWT-Authentifizierungsleitfaden.

HTTP-Anforderung

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/group
Parameter Ort Erforderlich Beschreibung
name Pfad Ja Der Dateiname der Arbeitsmappe (z. B. test.xlsx).
sheetName Pfad Ja Das Arbeitsblatt, das die zu gruppierenden Spalten enthält.
firstIndex Abfrage Ja Nullbasiertes Index der ersten Spalte, die in die Gruppe einzubeziehen ist.
lastIndex Abfrage Ja Nullbasiertes Index der letzten Spalte, die in die Gruppe einzubeziehen ist.
hide Abfrage Nein Wenn true, werden die gruppierten Spalten ausgeblendet; andernfalls bleiben sie sichtbar.
folder Abfrage Nein Pfad zum Ordner, der die Arbeitsmappe enthält.
storageName Abfrage Nein Name des Speicherdiensts, in dem sich die Datei befindet.

Anforderungsbeispiel (cURL)

curl -X POST "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/group?firstIndex=1&lastIndex=2&hide=true" \
     -H "accept: application/json" \
     -H "Authorization: Bearer <access_token>"

Hinweis: Die Anforderung verwendet HTTPS, um eine verschlüsselte Übertragung sicherzustellen.

Antwort

Erfolg (200)

Feld Typ Beschreibung
Code Integer HTTP-Statuscode (200).
Status String Textuelle Statusangabe des Vorgangs (OK).

Beispiel

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

Fehler (z. B. 400 Bad Request)

Feld Typ Beschreibung
Code Integer HTTP-Statuscode (400, 401, 404, 500, …).
Status String Textuelle Statusangabe (Error).
ErrorMessage String Menschlich lesbare Beschreibung des Problems.
ErrorCode String Programmatischer Fehlerbezeichner.

Beispiel – Bad Request

{
  "Code": 400,
  "Status": "Error",
  "ErrorMessage": "Ungültiger Spaltenindex.",
  "ErrorCode": "InvalidParameter"
}

SDK-Beispiele

Die folgenden Codeausschnitte zeigen, wie der Vorgang Group Worksheet Columns mithilfe der unterstützten SDKs aufgerufen wird.

Hinweise

  • Gruppierungsverhalten: Die API erstellt eine Spaltengruppe, die in Excel erweitert oder eingeklappt werden kann. Durch Festlegen von hide=true wird die Gruppe sofort eingeklappt.
  • Nullbasierte Indizierung: Sowohl firstIndex als auch lastIndex beginnen bei 0; die erste Spalte in einem Arbeitsblatt hat den Index 0.
  • Speicherüberlegungen: Wenn sich die Arbeitsmappe in einem Nicht-Standard-Speicher befindet, müssen sowohl die Abfrageparameter folder als auch storageName angegeben werden.

Siehe auch

Abbildung: Screenshot mit gruppierten Spalten in einem Excel-Arbeitsblatt{: .img-fluid alt=“Screenshot mit gruppierten Spalten in einem Excel-Arbeitsblatt” }

Das obige Platzhalterbild sollte durch einen echten Screenshot ersetzt werden, der das visuelle Ergebnis des Spaltengruppierens zeigt.

Spaltengruppierung in Excel aufheben – Aspose.Cells Cloud API