Leere Spalte zu Excel-Arbeitsblatt mit Aspose.Cells Cloud API hinzufügen

Diese REST-API fügt eine oder mehrere Spalten in ein Arbeitsblatt ein.

Voraussetzungen
Bevor Sie diesen Endpunkt aufrufen, stellen Sie sicher, dass Sie die folgenden Schritte ausgeführt haben:

  • Holen Sie sich ein gültiges OAuth 2.0-Zugriffstoken und fügen Sie es in den Authorization-Header ein.
  • Speichern Sie die Ziel-Arbeitsmappe im ausgewählten Speicher (Standard = „Default“) oder geben Sie die entsprechenden Parameter folder und storageName an.
  • Stellen Sie sicher, dass der in sheetName angegebene Arbeitsblattname in der Arbeitsmappe vorhanden ist.

PutInsertWorksheetColumns API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/{columnIndex}?totalColumns=1

Sicherheit und Authentifizierung

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

Anfrageparameter

Parametername Typ Ort Beschreibung
name string path Der Name der Arbeitsmappen-Datei.
sheetName string path Der Name des Arbeitsblatts.
columnIndex integer path Nullbasierter Index der Spalte, an der der Einfügvorgang beginnt.
totalColumns integer query Anzahl der einzufügenden Spalten.
updateReference boolean query Wenn true, werden Zellbezüge aktualisiert, um die Einfügung widerzuspiegeln.
folder string query Pfad zum Ordner, der die Arbeitsmappe enthält.
storageName string query Name des Speicherdiensts.

Hinweise

  • Der columnIndex muss zwischen 0 und der aktuellen Anzahl der Spalten im Arbeitsblatt liegen. Das Einfügen außerhalb des vorhandenen Bereichs erweitert das Arbeitsblatt automatisch.
  • Das Einfügen mehrerer Spalten (totalColumns > 1) verschiebt vorhandene Spalten nach rechts.
  • Der updateReference-Flag ist standardmäßig auf false gesetzt; setzen Sie ihn auf true, um Formeln und benannte Bereiche zu aktualisieren.

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 Aspose.Cells-Webservices aufzurufen. Das folgende Beispiel zeigt eine vollständige Anfrage einschließlich Authentifizierung und korrekter Pfadparameter.

Antwortcodes

Code Beschreibung
200 Spalte(n) erfolgreich eingefügt.
400 Ungültige Anfrage – fehlende oder ungültige Parameter.
401 Nicht autorisiert – ungültiges oder fehlendes Token.
404 Arbeitsmappe oder Arbeitsblatt nicht gefunden.
500 Interner Serverfehler.

Beispiel für Fehlerantworten

// 400 Bad Request – fehlende oder ungültige Parameter
{
  "Code": 400,
  "Message": "Ungültiger Parameter: totalColumns muss eine positive Ganzzahl sein."
}

// 401 Unauthorized – ungültiges oder fehlendes Token
{
  "Code": 401,
  "Message": "Authentifizierung fehlgeschlagen. Zugriffstoken fehlt oder ist ungültig."
}

// 404 Not Found – Arbeitsmappe oder Arbeitsblatt existiert nicht
{
  "Code": 404,
  "Message": "Arbeitsmappe 'test.xlsx' nicht gefunden."
}

// 500 Internal Server Error
{
  "Code": 500,
  "Message": "Auf dem Server ist ein unerwarteter Fehler aufgetreten."
}

Cloud SDK-Familie

Die Verwendung eines SDKs ist die schnellste Möglichkeit zur Entwicklung. Ein SDK übernimmt Details der niedrigen Ebene, sodass Sie sich auf die Logik Ihres Projekts konzentrieren können. Eine vollständige Liste der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.

Die folgenden Codebeispiele zeigen, wie Aspose.Cells-Webservices mit verschiedenen SDKs aufgerufen werden:

Spaltengruppierung in Excel aufheben – Aspose.Cells Cloud API Spalten in einem Excel-Arbeitsblatt kopieren