Esporta una pagina di foglio di lavoro – Riferimento API di Aspose.Cells Cloud
Esportare una pagina specifica di un foglio di lavoro è utile quando hai bisogno di un’istantanea stampabile di un report, di un’immagine di un grafico o di un’estratto di dati senza scaricare l’intero libro di lavoro. Questo endpoint consente di recuperare una singola pagina nel formato più adatto al flusso di lavoro successivo.
L’API GET /cells/{name}/worksheets/{sheetName} consente di convertire una pagina specifica di un foglio di lavoro in vari formati file. I formati supportati sono: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT, PDF, OTS, XPS, DIF, PNG, JPEG, GIF, BMP, WMF, TIFF, EMF, NUMBERS, FODS.
API REST
La specifiche OpenAPI definiscono un’interfaccia di programmazione pubblicamente accessibile e consentono di effettuare interazioni REST direttamente da un browser web.
Prerequisiti – Devi disporre di un token di autenticazione JWT valido e del libro di lavoro memorizzato in una cartella cloud specificata tramite il parametro
folder.
Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web di Aspose.Cells. L’esempio seguente mostra come effettuare una chiamata all’API cloud con cURL.
Parametri
| Parametro | Tipo | Descrizione | Valore predefinito |
|---|---|---|---|
format |
string | Format del file di output (ad esempio, pdf, png, csv). |
pdf |
verticalResolution |
integer | Risoluzione verticale dell’immagine renderizzata (DPI). | 100 |
horizontalResolution |
integer | Risoluzione orizzontale dell’immagine renderizzata (DPI). | 100 |
pageIndex |
integer | Indice in base zero della pagina del foglio di lavoro da esportare (0 = prima pagina). |
0 |
folder |
string | Cartella di archiviazione cloud in cui si trova il libro di lavoro sorgente. | — |
Codici di stato HTTP
| Codice | Significato | Descrizione |
|---|---|---|
| 200 | OK | Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione. |
| 400 | Richiesta non valida | Parametri mancanti o non validi (ad esempio, tipo di file non supportato). |
| 401 | Non autorizzato | Token JWT non valido o mancante. |
| 413 | Payload troppo grande | Il file caricato supera il limite di dimensione. |
| 500 | Errore interno del server | Errore imprevisto sul server. |
Errori possibili
- 401 Non autorizzato – Token JWT non valido o mancante.
- 404 Non trovato – Il libro di lavoro o il foglio di lavoro specificato non esiste.
- 400 Richiesta non valida – Valore di parametro non valido (ad esempio,
formatnon supportato). - 500 Errore interno del server – Problema imprevisto lato server.
Famiglia di SDK cloud
L’utilizzo di un SDK è il modo migliore per velocizzare lo sviluppo. Un SDK gestisce i dettagli a 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 di Aspose.Cells utilizzando vari SDK: