Imposta il valore di un intervallo in un foglio di lavoro Excel – API Aspose.Cells Cloud

Utilizza questa API REST per impostare un valore in un intervallo specificato. Quando appropriato, il valore viene convertito in un altro tipo di dati e il formato numerico della cella viene ripristinato.

Prerequisiti

  • Un account Aspose Cloud valido.
  • Un token JWT che include l’ambito Cells.ReadWrite.
  • Il libro deve essere già caricato nella posizione di archiviazione di destinazione.

API PostWorksheetCellsRangeValue

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/value

I parametri della richiesta sono:

Nome Parametro Tipo Posizione Descrizione
name string path Nome del libro
sheetName string path Nome del foglio di lavoro
value string query Valore di input
range object body Oggetto intervallo nel foglio di lavoro
isConverted boolean query Indica se il valore di input deve essere convertito
setStyle boolean query Indica se applicare lo stile alle celle di destinazione
folder string query Cartella del libro
storageName string query Nome dell’archiviazione

Esempio di oggetto range che può essere inviato nel corpo della richiesta:

{
  "range": {
    "FirstRow": 0,
    "FirstColumn": 0,
    "RowCount": 1,
    "ColumnCount": 1
  }
}

La Specifiche OpenAPI definisce un’interfaccia di programmazione accessibile pubblicamente e consente 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 chiamare l’API Cloud con cURL. Includi un token JWT valido nell’header Authorization.

Schema della risposta

Campo Tipo Descrizione
Code integer Codice di stato HTTP dell’operazione.
Status string Breve descrizione del risultato (es. “OK”).
Message string Messaggio di errore dettagliato in caso di fallimento (opzionale).
Result object Dati aggiuntivi restituiti per chiamate riuscite (opzionale).

Codici di stato HTTP possibili

  • 200 OK – Il valore dell’intervallo è stato impostato correttamente.
  • 400 Bad Request – Parametri non validi o corpo della richiesta malformato.
  • 401 Unauthorized – Token JWT mancante o non valido.
  • 403 Forbidden – Autorizzazioni insufficienti per l’operazione richiesta.
  • 404 Not Found – Il libro, il foglio di lavoro o l’intervallo specificato non esistono.
  • 500 Internal Server Error – Errore imprevisto del server.

Esempio di risposta di errore per un 400 Bad Request:

{
  "Code": 400,
  "Status": "Bad Request",
  "Message": "All'oggetto 'range' mancano campi obbligatori."
}

Famiglia di SDK Cloud

L’utilizzo di un SDK è il modo migliore 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 effettuare chiamate ai servizi web di Aspose.Cells utilizzando vari SDK:

Imposta lo stile di un intervallo – Aspose.Cells Cloud API Modifica della larghezza delle colonne all'interno di un intervallo