Come Convertire un Foglio di Calcolo in CSV Utilizzando l'API Aspose.Cells Cloud
L’endpoint ConvertWorksheetToCsv trasforma un singolo foglio di lavoro da un file di foglio di calcolo locale in un documento CSV interamente sul server Aspose.Cells Cloud. Caricando il file sorgente e specificando il foglio di lavoro di destinazione, gli sviluppatori ricevono un flusso binario CSV senza dover salvare il file nello storage cloud. Questa API è ideale per automatizzare l’estrazione dei dati, integrare dati da fogli di calcolo in sistemi downstream e ridurre i costi di archiviazione.
API per la Conversione del Foglio di Lavoro in CSV
API Web
PUT https://api.aspose.cloud/v4.0/cells/convert/worksheet/csv
Sicurezza e Autenticazione
Le API Aspose.Cells Cloud sono sicure e richiedono l’autenticazione tramite token JWT.
-H "Authorization: Bearer {access_token}"
Parametri della Richiesta
| Nome Parametro | Tipo | Posizione | Obbligatorio/Opzionale | Descrizione |
|---|---|---|---|---|
| Spreadsheet | File | FormData | Obbligatorio | File binario del foglio di calcolo sorgente (ad es. .xlsx, .xls). Esempio: myWorkbook.xlsx. |
| worksheet | String | Query | Obbligatorio | Nome del foglio di lavoro da convertire (case-sensitive). Se omesso, viene utilizzato il primo foglio. Esempio: Sheet1. |
| outPath | String | Query | Opzionale | Percorso della cartella di destinazione nello storage cloud dove salvare il CSV generato. Se omesso, il CSV viene restituito direttamente nel flusso di risposta. |
| outStorageName | String | Query | Opzionale | Nome del servizio di storage (ad es. Azure, AWS S3) in cui posizionare il file di output. Obbligatorio solo se viene utilizzato outPath. |
| fontsLocation | String | Query | Opzionale | Percorso di una cartella personalizzata dei font sul server, consentendo al motore di conversione di utilizzare font non standard. |
| region | String | Query | Opzionale | Identificatore di localizzazione che influisce sul formato di numeri/date nel CSV (ad es. it-IT, en-US, fr-FR). |
| password | String | Query | Opzionale | Password per aprire un foglio di calcolo protetto. Deve corrispondere alla password di crittografia del file sorgente. |
Risposta
[
{
"Name": "ResponseFile",
"DataType": {
"Identifier": "File",
"Reference": "Stream"
}
}
]
Codici di Stato HTTP
| Codice | Significato | Descrizione |
|---|---|---|
| 200 | OK | Filtro applicato correttamente; la risposta contiene i dettagli dell’operazione. |
| 400 | Richiesta Non Validata | Parametri mancanti o non validi (ad es. 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. |
Quando Utilizzare l’API per la Conversione del Foglio di Lavoro in CSV?
- Estrazione Dati per Pipeline BI – Recuperare un foglio di lavoro specifico da un report Excel e inviare direttamente il CSV risultante a Power BI o Tableau, senza gestire file intermedi.
- Elaborazione Automatica Fatture – Convertire in CSV il foglio di lavoro contenente le righe fattura per un rapido import in sistemi contabili.
- Integrazione con Sistemi Legacy – Esportare dati da fogli di lavoro in CSV per l’utilizzo da parte di applicazioni più datate che accettano solo file di testo delimitati.
- Generazione di Report in Tempo Reale – Produrre istantanee CSV dei dati di fogli di calcolo live in un servizio web, restituendo il file istantaneamente al browser del client.
Perché Utilizzare l’API per la Conversione del Foglio di Lavoro in CSV?
- Nessuno storage cloud permanente richiesto – Il file viene inviato direttamente al motore di conversione e scartato dopo la conversione, risparmiando larghezza di banda e costi di archiviazione.
- Esecuzione su Cloud ad Alto Rendimento – La conversione avviene sui server ottimizzati di Aspose, completandosi tipicamente entro 2 secondi per file fino a 100 MB.
- Controllo Granulare – Selezionare un singolo foglio di lavoro, applicare font personalizzati, formattazione regionale e protezione tramite password in una sola richiesta.
- Output CSV Consistente su Piattaforme Diverse – Garantisce output CSV identici su .NET, Java, Python e altri SDK che utilizzano lo stesso endpoint REST.
Come Usare l’API per la Conversione del Foglio di Lavoro in CSV con gli SDK
Specifica dell’API per la Conversione del Foglio di Lavoro in CSV
La Specifica dell’API per la Conversione del Foglio di Lavoro in CSV fornisce un’interfaccia di programmazione pubblicamente accessibile per eseguire interazioni REST direttamente da un browser web.
Puoi utilizzare lo strumento a riga di comando cURL per accedere facilmente ai servizi web Aspose.Cells. L’esempio seguente mostra come effettuare chiamate all’API Cloud con cURL.
Utilizzo degli SDK di Aspose.Cells Cloud
L’utilizzo dell’SDK semplifica lo sviluppo astrattendo i dettagli di basso livello, consentendo di unire un foglio di calcolo in un altro con codice conciso. Consulta il repository GitHub per un elenco completo degli SDK di Aspose.Cells Cloud.
I seguenti esempi di codice mostrano come interagire con i servizi web Aspose.Cells utilizzando vari SDK: