Mettre à jour les propriétés d’un graphique – Aspose.Cells Cloud REST API
Cet API REST permet de mettre à jour les propriétés d’un graphique.
Sécurité et authentification
Les API REST Aspose.Cells Cloud sont sécurisées et exigent une authentification basée sur un jeton JWT.
API PostWorksheetChart
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}
Paramètres de la requête
| Nom du paramètre | Type | Emplacement (chemin / chaîne de requête / corps HTTP) | Description |
|---|---|---|---|
| name | string | path | Nom du fichier Excel. |
| sheetName | string | path | Nom de la feuille de calcul contenant le graphique. |
| chartIndex | integer | path | Index (à zéro) du graphique à mettre à jour. |
| chart | object | body | Objet JSON définissant les propriétés du graphique à modifier. |
| folder | string | query | Dossier dans le stockage où le fichier est situé. |
| storageName | string | query | Nom du service de stockage. |
Schéma du corps de la requête
L’objet chart contient les propriétés que vous pouvez modifier. Voici un exemple JSON représentatif incluant plusieurs champs couramment utilisés :
{
"Title": {
"Text": "Chiffre d'affaires trimestriel"
},
"ShowLegend": true,
"Type": "Line",
"DataLabels": {
"ShowValue": true,
"ShowPercentage": false
},
"ChartArea": {
"BorderColor": "Blue",
"FillColor": "White"
}
}
Remarque : Vous devez uniquement fournir les champs que vous souhaitez modifier. Les propriétés omises conservent leurs valeurs actuelles.
La spécification OpenAPI définit une interface de programmation accessible publiquement et permet d’effectuer des interactions REST directement depuis un navigateur web.
Vous pouvez utiliser l’outil en ligne de commande cURL pour accéder facilement aux services web Aspose.Cells. L’exemple suivant montre comment effectuer des appels à l’API Cloud à l’aide de cURL.
Réponse
L’API renvoie un objet JSON indiquant le résultat de l’opération. Une mise à jour réussie renvoie :
{
"Code": 200,
"Status": "OK"
}
Codes de statut en cas de succès
| Statut HTTP | Description |
|---|---|
| 200 | OK – les propriétés du graphique ont été mises à jour. |
En-têtes de réponse
| En-tête | Description |
|---|---|
Content-Type |
application/json – indique que le corps de la réponse est au format JSON. |
X-RequestId |
Identifiant unique de la requête (utile pour le débogage). |
Les réponses d’erreur possibles incluent :
| Statut HTTP | Description |
|---|---|
| 400 | Requête incorrecte – paramètres ou corps invalide |
| 401 | Non autorisé – jeton manquant ou invalide |
| 404 | Non trouvé – fichier, feuille de calcul ou graphique introuvable |
| 500 | Erreur interne du serveur |
Pour d’autres opérations liées aux graphiques, voir les sujets connexes tels que Mettre à jour le titre du graphique et Mettre à jour la légende du graphique.
Famille de SDK Cloud
L’utilisation d’un SDK est le moyen le plus efficace d’accélérer le développement. Un SDK gère les détails de bas niveau et vous permet de vous concentrer sur les tâches de votre projet. Veuillez consulter le dépôt GitHub pour obtenir la liste complète des SDK Aspose.Cells Cloud.
Les exemples de code suivants montrent comment effectuer des appels aux services web Aspose.Cells à l’aide de divers SDK :