Aggiorna le proprietà del grafico – Aspose.Cells Cloud REST API
Questa REST API aggiorna le proprietà del grafico.
Sicurezza e autenticazione
Le API REST di Aspose.Cells Cloud sono sicure e richiedono l’autenticazione basata su token JWT.
API PostWorksheetChart
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}
Parametri della richiesta
| Nome parametro | Tipo | Percorso/Query string/Corpo HTTP | Descrizione |
|---|---|---|---|
| name | string | percorso | Nome del file Excel. |
| sheetName | string | percorso | Nome del foglio di calcolo contenente il grafico. |
| chartIndex | integer | percorso | Indice in base zero del grafico da aggiornare. |
| chart | object | corpo | Oggetto JSON che definisce le proprietà del grafico da modificare. |
| folder | string | query | Cartella nello storage in cui si trova il file. |
| storageName | string | query | Nome del servizio di storage. |
Schema del corpo della richiesta
L’oggetto chart contiene le proprietà che è possibile modificare. Di seguito è riportato un esempio rappresentativo in JSON che include diversi campi comunemente utilizzati:
{
"Title": {
"Text": "Vendite trimestrali"
},
"ShowLegend": true,
"Type": "Line",
"DataLabels": {
"ShowValue": true,
"ShowPercentage": false
},
"ChartArea": {
"BorderColor": "Blue",
"FillColor": "White"
}
}
Nota: È necessario fornire solo i campi che si desidera modificare. Le proprietà omesse mantengono i valori precedentemente impostati.
La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di effettuare interazioni REST direttamente da un browser web.
Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare chiamate all’API Cloud tramite cURL.
Risposta
L’API restituisce un oggetto JSON che indica il risultato dell’operazione. Un aggiornamento riuscito restituisce:
{
"Code": 200,
"Status": "OK"
}
Codici di stato di successo
| Stato HTTP | Descrizione |
|---|---|
| 200 | OK – Le proprietà del grafico sono state aggiornate correttamente. |
Intestazioni della risposta
| Intestazione | Descrizione |
|---|---|
Content-Type |
application/json – Indica che il corpo della risposta è in formato JSON. |
X-RequestId |
Identificatore univoco della richiesta (utile per la risoluzione dei problemi). |
Le risposte di errore possibili includono:
| Stato HTTP | Descrizione |
|---|---|
| 400 | Richiesta non valida – parametri o corpo non validi |
| 401 | Non autorizzato – token mancante o non valido |
| 404 | Non trovato – file, foglio di calcolo o grafico non trovato |
| 500 | Errore interno del server |
Per altre operazioni relative ai grafici, consulta gli argomenti correlati come Aggiorna il titolo del grafico e Aggiorna la legenda del grafico.
Famiglia di SDK Cloud
L’utilizzo di un SDK rappresenta il modo più efficace per accelerare lo sviluppo. Un SDK gestisce i dettagli di basso livello e ti consente di concentrarti sulle attività del tuo progetto. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.
I seguenti esempi di codice mostrano come effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK: