Zellendaten basierend auf benanntem Bereich abrufen – Aspose.Cells Cloud API

Voraussetzungen

  • Ein gültiges JWT-Zugriffstoken mit der entsprechenden Berechtigung.
  • Die Arbeitsmappe muss in den Aspose Cloud-Speicher (oder einen angegebenen Ordner) hochgeladen sein.
  • Stellen Sie sicher, dass der Name des Ziel-Speichers angegeben wird, wenn ein von Standard abweichender Speicher verwendet wird.

Diese REST-API gibt eine Liste von Zellen innerhalb eines Bereichs zurück, der entweder durch einen benannten Bereich oder durch Zeilen-/Spaltenindizes identifiziert wird.

Mit diesem Vorgang können Entwickler programmgesteuert die Werte von Zellen abrufen, die zu einem bestimmten benannten Bereich in einem Excel-Arbeitsblatt gehören. Indem entweder der Bezeichner namedRange oder explizite Zeilen- und Spaltenindizes übergeben werden, gibt die API eine detaillierte Liste der Zellen zurück, einschließlich ihrer Adresse, Zeile, Spalte, des Werts, des Datentyps und der Formatierungsinformationen. Die Antwort kann verwendet werden, um datengetriebene Anwendungen zu steuern, Berichte zu generieren oder weitere Berechnungen serverseitig durchzuführen. Der Aspose.Cells Cloud-Dienst unterstützt mehrere Programmiersprachen über seine SDKs und gewährleistet eine nahtlose Integration unabhängig von der Entwicklungsplattform. Die Verwendung von HTTPS garantiert die sichere Übertragung der Daten, und die API richtet sich nach RESTful-Prinzipien, wobei standardmäßige HTTP-Statuscodes für Erfolgs- und Fehlerbedingungen zurückgegeben werden.

REST-API

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

Anforderungsparameter

Parametername Typ Ort Beschreibung
name string path Der Name der Arbeitsmappendatei.
sheetName string path Der Name des Arbeitsblatts innerhalb der Arbeitsmappe.
namedRange string query Der abzurufende benannte Bereich, z. B. A1:B2 oder range_name1.
firstRow integer query Nullbasierter Index der ersten Zeile des Bereichs (wird verwendet, wenn namedRange nicht angegeben ist).
firstColumn integer query Nullbasierter Index der ersten Spalte des Bereichs (wird verwendet, wenn namedRange nicht angegeben ist).
rowCount integer query Anzahl der im Bereich einzuschließenden Zeilen.
columnCount integer query Anzahl der im Bereich einzuschließenden Spalten.
folder string query Der Ordner, der die Arbeitsmappe enthält.
storageName string query Der Name des Cloud-Speichers, in dem sich die Arbeitsmappe befindet.

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

Sie können das cURL-Befehlszeilentool verwenden, um Aspose.Cells-Webservices problemlos aufzurufen. Das folgende Beispiel zeigt, wie Zellwerte aus einem benannten Bereich angefordert werden.

Sicherheitshinweis: Verwenden Sie bei Aufruf der API stets HTTPS. Der Dienst unterstützt keinen unverschlüsselten HTTP-Verkehr; HTTPS stellt sicher, dass die Anfrage verschlüsselt ist und bewährten Sicherheitspraktiken entspricht.

HTTP-Statuscodes

Code Bedeutung Beschreibung
200 OK Filter erfolgreich angewendet; Antwort enthält Details zum Vorgang.
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 das Größenlimit.
500 Internal Server Error Unerwarteter Serverfehler.

Beispiel einer Fehlerantwort (400 Bad Request)

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "Der Parameter 'namedRange' fehlt oder ist ungültig."
}

Tipp: Die API verwendet nullbasierte Indizes für firstRow und firstColumn. Die erste Zeile des Arbeitsblatts ist beispielsweise 0.

Cloud SDK-Familie

Die Verwendung eines SDKs ist der effizienteste Weg, die Entwicklung zu beschleunigen. Ein SDK abstrahiert low-level-Details, sodass Sie sich auf die Geschäftslogik 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:

Benannte Bereiche in einer Excel-Arbeitsmappe abrufen