Diagrammbereich aus einem Arbeitsblatt abrufen – Aspose.Cells Cloud API

Diese REST API gibt Informationen zum Diagrammbereich zurück.

Voraussetzungen: Um diesen Endpunkt aufzurufen, benötigen Sie ein gültiges JWT-Access-Token, die Zielarbeitsmappe muss in den Aspose Cloud-Speicher hochgeladen sein und das Dateiformat muss von Aspose.Cells unterstützt werden.

Hintergrund: Ein Diagrammbereich definiert den äußersten Begrenzungsrahmen eines Excel-Diagramms, einschließlich Titel, Legende und Plotbereich. Das Abrufen seiner Eigenschaften ermöglicht es Ihnen, Layout und Gestaltung programmgesteuert anzupassen.

GetChartArea API

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}/chartArea

Sicherheit und Authentifizierung

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

Anforderungsparameter

Parametername Typ Speicherort Beschreibung
name string path Name der Arbeitsmappe.
sheetName string path Name des Arbeitsblatts, das das Diagramm enthält.
chartIndex integer path Nullbasierter Index des Diagramms.
folder string query Ordner, in dem die Arbeitsmappe gespeichert ist.
storageName string query Name des Speicherdienstes.

Antwort

{
  "ChartArea": {
    "Area": {
      "BackgroundColor": { "A": "0", "R": "0", "G": "0", "B": "0" },
      "FillFormat": { "Type": "Automatic" },
      "ForegroundColor": { "A": "0", "R": "0", "G": "0", "B": "0" },
      "Formatting": "Automatic",
      "InvertIfNegative": false,
      "Transparency": 0.0
    },
    "AutoScaleFont": false,
    "BackgroundMode": "Automatic",
    "Border": {
      "BeginArrowLength": "Medium",
      "BeginArrowWidth": "Medium",
      "BeginType": "None",
      "CapType": "Flat",
      "Color": { "A": "0", "R": "0", "G": "0", "B": "0" },
      "CompoundType": "Single",
      "DashType": "Solid",
      "EndArrowLength": "Medium",
      "EndArrowWidth": "Medium",
      "EndType": "None",
      "IsAuto": false,
      "IsAutomaticColor": false,
      "IsVisible": false,
      "JoinType": "Round",
      "Style": "Solid",
      "Transparency": 0.0,
      "Weight": "HairLine",
      "WeightPt": 0.0
    },
    "Font": {
      "Color": { "A": "255", "R": "0", "G": "0", "B": "0" },
      "DoubleSize": 10.0,
      "IsBold": false,
      "IsItalic": false,
      "IsStrikeout": false,
      "IsSubscript": false,
      "IsSuperscript": false,
      "Name": "Arial",
      "Size": 10,
      "Underline": "None"
    },
    "IsAutomaticSize": false,
    "IsInnerMode": false,
    "Shadow": false,
    "Width": 0,
    "Height": 0,
    "X": 0,
    "Y": 0,
    "link": {
      "Href": "https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet5/charts/0/chartArea",
      "Rel": "self"
    }
  },
  "Code": "200",
  "Status": "OK"
}

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.

Verwendung der GetChartArea API mit SDKs

Spezifikation der GetChartArea API

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 Aspose.Cells-Webdienste einfach aufzurufen. Das folgende Beispiel zeigt, wie ein Aufruf der Cloud-API mit cURL erfolgt.

Verwendung der Aspose.Cells Cloud SDKs

Die Verwendung eines SDKs ist der beste Weg, um die Entwicklung zu beschleunigen. Ein SDK übernimmt Details auf niedriger Ebene, sodass Sie sich auf Ihre Projektanforderungen konzentrieren können. Eine vollständige Liste der Aspose.Cells Cloud SDKs finden Sie im GitHub-Repository.

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

Allgemeine HTTP-Anforderung (z. B. mit fetch):

fetch('https://api.aspose.cloud/v3.0/cells/Sample_Test_Book.xls/worksheets/Sheet5/charts/0/chartArea', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'Authorization': 'Bearer <jwt token>'
  }
})
  .then(response => response.json())
  .then(data => console.log(data));