Documentation –

Developer-Guide: Adattamento automatico della colonna in Excel con Aspose.Cells Cloud API – Guida rapida

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST regola automaticamente la larghezza di una singola colonna o di un intervallo contiguo di colonne in un foglio di calcolo Excel.

API REST

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

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file Excel.
sheetName	string	path	Nome del foglio di calcolo.
firstColumn	integer	query	Indice in base zero della prima colonna da adattare automaticamente.
lastColumn	integer	query	Indice in base zero dell’ultima colonna da adattare automaticamente.
autoFitterOptions	object	body	Opzioni che controllano il comportamento dell’adattamento automatico (vedere AutoFitterOptions).
firstRow	integer	query	Indice in base zero della prima riga considerata nel calcolo della larghezza della colonna.
lastRow	integer	query	Indice in base zero dell’ultima riga considerata nel calcolo della larghezza della colonna.
folder	string	query	Cartella nello storage in cui si trova il file.
storageName	string	query	Nome del servizio di storage.

Risposte di errore

Status HTTP	Significato	Corpo JSON di esempio
400	Parametro/i non valido/i	`{"Code":400,"Message":"Parametro 'firstColumn' non valido."}`
401	Non autorizzato – token JWT mancante o non valido	`{"Code":401,"Message":"Autorizzazione non riuscita."}`
404	File o foglio di calcolo non trovato	`{"Code":404,"Message":"Foglio 'Sheet1' non trovato."}`
500	Errore interno del server	`{"Code":500,"Message":"Si è verificato un errore imprevisto."}`

La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di effettuare interazioni REST direttamente da un browser web.

È possibile utilizzare lo strumento a riga di comando cURL per richiamare i servizi Aspose.Cells Cloud. L’esempio seguente mostra come richiamare l’endpoint di adattamento automatico della colonna.

Richiesta

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

Risposta

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

Famiglia di SDK per il cloud

Utilizzare un SDK rappresenta il metodo più rapido per integrare l’API nella propria applicazione. Gli SDK gestiscono i dettagli di basso livello, consentendoti di concentrarti sulla logica di business. Consulta il repository GitHub per l’elenco completo degli SDK di Aspose.Cells Cloud.

I seguenti esempi di codice mostrano come richiamare l’endpoint di adattamento automatico della colonna utilizzando vari SDK:

Developer-Guide: Adattamento automatico di più colonne in un foglio di lavoro Excel

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST esegue l'adattamento automatico di più colonne in un foglio di lavoro Excel.

API REST

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

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file.
sheetName	string	path	Nome del foglio di lavoro.
firstColumn	integer	query	Indice della colonna iniziale.
lastColumn	integer	query	Indice della colonna finale.
autoFitterOptions*	object	body	Opzioni dell’adattatore automatico (vedere Opzioni dell’adattatore automatico). Include `AutoFitMergedCells`, `IgnoreHidden` e `OnlyAuto`.
firstRow	integer	query	Indice della riga iniziale per l’adattamento automatico (opzionale).
lastRow	integer	query	Indice della riga finale per l’adattamento automatico (opzionale).
folder	string	query	Percorso della cartella nello storage (opzionale).
storageName	string	query	Nome dello storage (opzionale).

*Il nome del parametro è visualizzato come link alla documentazione correlata.

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 con cURL.

Richiesta

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

Risposta

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

Famiglia di SDK Cloud

L’utilizzo di un SDK rappresenta il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli a basso livello, consentendoti di concentrarti sui compiti 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:

Developer-Guide: Adattamento automatico di una riga in un foglio di calcolo Excel

Mon, 01 Jan 0001 00:00:00 +0000

Questa API REST esegue l’adattamento automatico di una riga in un foglio di calcolo Excel.

Sicurezza e autenticazione

Le API REST di Aspose.Cells Cloud sono sicure e richiedono l'autenticazione tramite token JWT.

API REST

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

Parametri della richiesta

Nome parametro	Tipo	Posizione	Descrizione
name	string	path	Nome del file Excel.
sheetName	string	path	Nome del foglio di calcolo.
rowIndex	integer	query	Indice in base zero della riga da adattare automaticamente.
firstColumn	integer	query	Indice della prima colonna inclusa nell’operazione.
lastColumn	integer	query	Indice dell’ultima colonna inclusa nell’operazione.
autoFitterOptions	object	body	Oggetto che controlla il comportamento di adattamento automatico (ad esempio, se considerare le celle unite, l’a capo automatico, ecc.). Vedere AutoFitterOptions{:rel=“noopener” title=“Controlla il comportamento di adattamento automatico”}.
folder	string	query	Cartella in cui è memorizzato il file.
storageName	string	query	Nome dello storage.

Esempio di corpo JSON autoFitterOptions

{
  "IsMergedCells": true,
  "IsWrapped": false,
  "AutoFitMergedCells": true,
  "AutoFitWrappedCells": false
}

Definizioni delle entità

Entità	Descrizione
`rowIndex`	Indice in base zero della riga di destinazione.
`firstColumn`	Colonna iniziale per l’operazione di adattamento automatico.
`lastColumn`	Colonna finale per l’operazione di adattamento automatico.
`autoFitterOptions`	Impostazioni opzionali che influenzano il modo in cui viene eseguito l’adattamento automatico della riga (celle unite, a capo automatico, ecc.).

La Specifiche OpenAPI definiscono un’interfaccia di programmazione accessibile pubblicamente e consentono di eseguire 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 tramite cURL.

Richiesta

curl -v "https://api.aspose.cloud/v3.0/cells/sampleAutoFit.xlsx/worksheets/Sheet1/autofitrow?rowIndex=2&firstColumn=1&lastColumn=10" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Risposta

Campo	Descrizione
Code	`200` – richiesta riuscita.
Status	`"OK"` – la riga è stata adattata automaticamente con successo.

Gestione degli errori

L’API restituisce i codici di stato HTTP standard. Le risposte di errore comuni per questo endpoint sono:

Codice HTTP	Esempio di payload	Significato
400	`{ "Code": 400, "Message": "Indice riga fuori intervallo." }`	L'`rowIndex` fornito non esiste nel foglio di calcolo.
401	`{ "Code": 401, "Message": "Token non valido o scaduto." }`	Autenticazione non riuscita – verificare il token JWT e assicurarsi che la richiesta avvenga tramite HTTPS.
404	`{ "Code": 404, "Message": "File non trovato." }`	Il file Excel o il foglio di calcolo specificato non può essere individuato.
500	`{ "Code": 500, "Message": "Errore interno del server." }`	Si è verificato un problema imprevisto lato server.

Famiglia di SDK cloud

L’utilizzo di un SDK rappresenta il metodo più rapido per lo sviluppo. Un SDK astrae i dettagli di basso livello, consentendo di concentrarsi sulla logica di business. Consulta il repository GitHub{:rel=“noopener noreferrer”} 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:

Vedi anche: Adattamento automatico colonna, Adattamento automatico righe, AutoFitterOptions.

Developer-Guide: Adattamento automatico di più righe in un foglio di lavoro Excel

Mon, 01 Jan 0001 00:00:00 +0000

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: