Aggiorna un oggetto elenco in un foglio di calcolo Excel – Documentazione dell'API Aspose.Cells Cloud
Questa REST API consente di aggiornare le proprietà di un oggetto elenco (tabella) in un foglio di calcolo Excel.
Sicurezza e autenticazione
Le API Aspose.Cells Cloud sono sicure e richiedono l'autenticazione basata su token JWT.
Schema del corpo della richiesta
Il DTO listObject contiene i campi seguenti. Sono richiesti nel corpo della richiesta soltanto i campi che si desidera modificare.
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| DisplayName | stringa | opzionale | Nome visualizzato per la tabella. |
| StartRow / StartColumn | intero | opzionale | Indice in base zero della prima riga/colonna della tabella. |
| EndRow / EndColumn | intero | opzionale | Indice in base zero dell’ultima riga/colonna della tabella. |
| Range | stringa | opzionale | Indirizzo in stile A1 che definisce l’intervallo della tabella (es. A1:D10). |
| ShowHeaderRow | booleano | opzionale | true per visualizzare la riga di intestazione. |
| ShowTotals | booleano | opzionale | true per visualizzare la riga dei totali. |
| TableStyleName | stringa | opzionale | Nome dello stile di tabella predefinito da applicare. |
| TableStyleType | stringa | opzionale | Tipo di stile (TableStyleLight, TableStyleMedium, ecc.). |
| ListColumns | array di oggetti | opzionale | Collezione di definizioni di colonne (Name, TotalsCalculation). |
| Sorter, AutoFilter, ShowTableStyle… | oggetto | opzionale | Opzioni avanzate di formattazione e filtraggio (vedere il DTO completo nella specifica OpenAPI). |
Payload di esempio minimo
{
"DisplayName": "SalesData",
"Range": "A1:E20",
"ShowHeaderRow": true,
"ShowTotals": false
}
REST API
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}
Parametri della richiesta
| Nome del parametro | Tipo | Posizione | Descrizione |
|---|---|---|---|
| name | stringa | path | Nome del documento. |
| sheetName | stringa | path | Nome del foglio di calcolo. |
| listObjectIndex | intero | path | Indice dell’oggetto elenco da aggiornare. |
| listObject | oggetto | body | DTO ListObject nel corpo della richiesta. |
| folder | stringa | query | Cartella contenente il documento. |
| storageName | stringa | query | Nome dello storage. |
La specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di effettuare interazioni REST direttamente da un browser web.
Richiesta
Risposte di errore
| Codice HTTP | Descrizione | Payload di esempio |
|---|---|---|
| 400 | Richiesta non valida – campi obbligatori mancanti o JSON malformato. | { "Code": 400, "Message": "Invalid request body." } |
| 401 | Non autorizzato – token JWT mancante o non valido. | { "Code": 401, "Message": "Authentication failed." } |
| 404 | Non trovato – il foglio di calcolo, il foglio o l’oggetto elenco specificati non esistono. | { "Code": 404, "Message": "Resource not found." } |
| 500 | Errore interno del server – condizione imprevista lato server. | { "Code": 500, "Message": "Server error." } |
Domande frequenti (FAQ)
Come aggiorno un oggetto elenco utilizzando l'API Aspose.Cells Cloud?
Utilizzare l’endpoint POST /cells/{name}/worksheets/{sheetName}/listobjects/{listObjectIndex}. Includere nel corpo JSON le proprietà da modificare (es. DisplayName, ShowHeaderRow). Eseguire l’autenticazione tramite token JWT nell’intestazione Authorization.
Che risposta ricevo dopo un aggiornamento riuscito?
Viene restituito un oggetto JSON con Code: 200 e Status: "OK". In caso di errore, la risposta contiene il codice di stato HTTP appropriato e un oggetto Error che descrive il problema.
Posso aggiornare solo un sottoinsieme delle proprietà dell'oggetto elenco?
Sì. Includere nel corpo della richiesta soltanto i campi che si desidera modificare; tutti gli altri campi rimangono invariati.
Documentazione correlata
Famiglia di SDK cloud
L’utilizzo di un SDK rappresenta il modo più rapido per velocizzare lo sviluppo. Un SDK gestisce i dettagli di basso livello, consentendoti 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 chiamare i servizi web Aspose.Cells utilizzando vari SDK: