Diagrammeigenschaften aktualisieren – Aspose.Cells Cloud REST API
Diese REST API aktualisiert Diagrammeigenschaften.
Sicherheit und Authentifizierung
Die Aspose.Cells Cloud APIs sind sicher und erfordern eine JWT-Token-basierte Authentifizierung.
PostWorksheetChart API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}
Anforderungsparameter
| Parametername | Typ | Pfad/Abfragezeichenfolge/HTTP-Body | Beschreibung |
|---|---|---|---|
| name | string | path | Der Name der Excel-Datei. |
| sheetName | string | path | Der Name des Arbeitsblatts, das das Diagramm enthält. |
| chartIndex | integer | path | Der nullbasierte Index des zu aktualisierenden Diagramms. |
| chart | object | body | JSON-Objekt, das die zu ändernden Diagrammeigenschaften definiert. |
| folder | string | query | Der Ordner im Speicher, in dem sich die Datei befindet. |
| storageName | string | query | Der Name des Speicherdiensts. |
Anforderungstext-Schema
Das chart-Objekt enthält die Eigenschaften, die Sie ändern können. Nachfolgend finden Sie ein repräsentatives JSON-Beispiel mit mehreren häufig verwendeten Feldern:
{
"Title": {
"Text": " Quartalsumsätze"
},
"ShowLegend": true,
"Type": "Line",
"DataLabels": {
"ShowValue": true,
"ShowPercentage": false
},
"ChartArea": {
"BorderColor": "Blue",
"FillColor": "White"
}
}
Hinweis: Es müssen nur die Felder übermittelt werden, die Sie tatsächlich ändern möchten. Weitere Eigenschaften behalten ihre aktuellen Werte bei.
Die OpenAPI-Spezifikation definiert eine öffentlich zugängliche Programmierschnittstelle und ermöglicht REST-Interaktionen direkt über einen Webbrowser.
Sie können das cURL-Befehlszeilentool nutzen, um Aspose.Cells-Webservices einfach aufzurufen. Das folgende Beispiel zeigt, wie Sie mit cURL Aufrufe an die Cloud-API durchführen.
Antwort
Die API gibt ein JSON-Objekt zurück, das das Ergebnis des Vorgangs angibt. Eine erfolgreiche Aktualisierung ergibt:
{
"Code": 200,
"Status": "OK"
}
Erfolgs-HTTP-Statuscodes
| HTTP-Status | Beschreibung |
|---|---|
| 200 | OK – Die Diagrammeigenschaften wurden erfolgreich aktualisiert. |
Antwortheader
| Header | Beschreibung |
|---|---|
Content-Type |
application/json – Gibt an, dass der Antworttext JSON-formatiert ist. |
X-RequestId |
Eindeutige Kennung für die Anforderung (nützlich zur Fehlerbehebung). |
Mögliche Fehlerantworten:
| HTTP-Status | Beschreibung |
|---|---|
| 400 | Bad Request – ungültige Parameter oder Body |
| 401 | Unauthorized – fehlendes oder ungültiges Token |
| 404 | Not Found – Datei, Arbeitsblatt oder Diagramm nicht gefunden |
| 500 | Internal Server Error |
Weitere diagrammbezogene Vorgänge finden Sie in den verwandten Themen wie Diagrammtitel aktualisieren und Diagrammlegende aktualisieren.
Cloud SDK-Familie
Die Verwendung eines SDKs ist der beste Weg, die Entwicklungszeit zu verkürzen. Ein SDK übernimmt die Low-Level-Details und ermöglicht es Ihnen, sich auf Ihre Projektziele zu konzentrieren. Besuchen Sie das GitHub-Repository, um eine vollständige Liste der Aspose.Cells Cloud SDKs zu erhalten.
Die folgenden Codebeispiele zeigen, wie Sie mit verschiedenen SDKs Aufrufe an Aspose.Cells-Webservices durchführen: