Adattamento automatico di più righe in un foglio di lavoro Excel – Documentazione API Aspose.Cells Cloud

Questa API REST regola automaticamente l’altezza delle righe in un foglio di lavoro Excel.

Sicurezza e autenticazione

Le API di Aspose.Cells Cloud sono sicure e richiedono autenticazione basata su token JWT.

API REST

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

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione	Obbligatorio
name	string	path	Nome del file Excel.	✔
sheetName	string	path	Nome del foglio di lavoro.	✔
autoFitterOptions	object	body	Opzioni che controllano il modo in cui vengono eseguite l’adattamento automatico delle righe (ad esempio, ignorare le righe nascoste). Vedi la breve descrizione dei campi di seguito.	✖
startRow	integer	query	Prima riga da adattare automaticamente (indice in base 1).	✔
endRow	integer	query	Ultima riga da adattare automaticamente (inclusa).	✔
onlyAuto	boolean	query	Se `true`, l’API regola solo le righe la cui altezza viene calcolata automaticamente da Excel. Se `false`, viene eseguito un adattamento completo.	✖
folder	string	query	Cartella contenente il documento.	✖
storageName	string	query	Nome del servizio di archiviazione.	✖

Campi di autoFitterOptions (tutti opzionali):

AutoFitMergedCells (boolean) – Se true, le celle unite vengono prese in considerazione durante il calcolo dell’altezza della riga.
IgnoreHidden (boolean) – Se true, le righe nascoste vengono ignorate durante il processo di adattamento automatico.
OnlyAuto (boolean) – Replica il parametro di query onlyAuto; quando impostato, sovrascrive il valore del parametro di query.

La specifica OpenAPI definisce un’interfaccia di programmazione pubblicamente accessibile 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.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/sampleAutoFit.xlsx/worksheets/Sheet1/autofitrows?startRow=1&endRow=7" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{"AutoFitMergedCells": true, "IgnoreHidden": true, "OnlyAuto": false}'

Risposta

{
  "Code": 200,
  "Status": "OK"
}

Le risposte di errore tipiche includono:

400 Bad Request – Valori dei parametri non validi o corpo JSON malformato.
401 Unauthorized – Token JWT mancante o non valido.
404 Not Found – Il file o il foglio di lavoro specificato non esiste.
500 Internal Server Error – Si è verificato un errore imprevisto sul server.

Codici di stato HTTP

Codice	Significato	Descrizione
200	OK	Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione.
400	Bad Request	Parametri mancanti o non validi (ad esempio, tipo di file non supportato).
401	Unauthorized	Token JWT non valido o mancante.
413	Payload Too Large	Il file caricato supera il limite di dimensione.
500	Internal Server Error	Errore imprevisto sul server.

Famiglia di SDK Cloud

Utilizzare un SDK è il modo più rapido per sviluppare. Un SDK gestisce i dettagli di basso livello, consentendoti di concentrarti sul 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 di Aspose.Cells utilizzando vari SDK:

Adattamento automatico di una riga in un foglio di calcolo Excel