> Nessuna installazione locale di Excel. Nessun server di conversione da mantenere. Trasforma XLSX → PDF, Excel → CSV/JSON/immagini/HTML in semplici chiamate REST — e avrai il tuo primo “convertitore di fogli di calcolo cloud” funzionante in circa tre minuti. “Converti quel foglio di calcolo in un formato diverso” è una delle richieste più comuni nello sviluppo quotidiano: - I team finanziari e legali vogliono un report in sola lettura e resistente alle manomissioni invece di un .xlsx che chiunque può modificare; - I team di dati hanno bisogno di estrarre dati tabulari nei sistemi downstream come CSV / JSON; - Le app web e mobili vogliono fogli di lavoro — e persino grafici — renderizzati direttamente in PNG / SVG; - I portali vogliono frammenti puliti di HTML / HTML-Table da incorporare; - Qualcuno deve normalizzare un insieme di file .xls / .xlsx / .csv / .ods in un unico formato. Le risposte tradizionali — un’installazione locale di Excel con macro, o un componente COM pesante sul tuo server — sono difficili da scalare e complicate da mantenere cross-platform. Aspose.Cells Cloud sostituisce tutto ciò con una pura API REST: carica un file, ottieni un file in un nuovo formato. Questo post esplora le tre API di conversione esposte dal core ConversionController nel microservizio Aspose.Cells Cloud (fonte: src/Aspose.Cells.Cloud.MicroService/Controllers/ConversionController.cs), con esempi eseguibili in cURL, C# (.NET), Python e Java. — ## 1. Cosa può fare la funzione Convert? ConversionController è il controller dedicato alla conversione / esportazione di formato. Avvolge la conversione ad alta fedeltà a livello di motore in tre set di API HTTP: | # | Scenario | Endpoint tipico | Cosa fa | | — | ———————————————————— | ———————————————— | ———————————————————————————————————————- | | 1 | File già nello storage cloud → scarica un nuovo formato | GET /v4.0/cells/{name}?format=pdf | Converte un workbook direttamente nello storage cloud e restituisce il risultato — file di grandi dimensioni non devono mai viaggiare sulla tua macchina | | 2 | File locale → conversione online (funzione principale) | PUT /v4.0/cells/convert/spreadsheet?format=pdf | Carichi il file nel corpo della richiesta (multipart); il server lo converte e restituisce direttamente il file risultato | | 3 | File cloud → salva come un nuovo formato, di nuovo nello storage cloud | PUT /v4.0/cells/{name}/saveas?format=pdf | Il file convertito viene scritto direttamente nello storage cloud — ideale per pipeline automatizzate | > Nota di implementazione: le rotte sorgente utilizzano il prefisso v{version}/cells con la versione API 4.0, quindi le chiamate live appaiono come https://api.aspose.cloud/v4.0/cells/.... ### La granularità della conversione va ben oltre “l’intero file” Oltre a convertire un intero workbook, il controller può esportare un singolo elemento: - Un foglio di lavoro specifico → PDF / immagine / CSV / JSON / HTML - Un intervallo di celle specifico (ad es. A1:C12) → PDF / immagine / CSV / JSON / HTML - Una tabella specifica → PDF / immagine / CSV / JSON / HTML - Un grafico specifico → PNG / JPEG / BMP / GIF / SVG / TIFF / EMF / PDF Quindi non devi mai convertire un intero workbook da 50 MB solo per estrarre un grafico — converti solo ciò di cui hai bisogno e risparmia larghezza di banda e calcolo. — ## 2. Quali formati sono supportati? Basato sul registro ExportData integrato nel controller, la matrice di conversione appare all’incirca così: | Tipo | Formati | | —————————————– | ———————————————————————————————————————- | | Importa e esporta (bidirezionale) | XLS, XLSX, XLSB, XLSM, CSV, TSV, ODS, TXT | | Solo esportazione | PDF, OTS, XPS, DIF, HTML / MHTML, JSON, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS, Markdown, DOCX, PPTX, SQL, ecc. | In breve: conversioni da foglio di calcolo a foglio di calcolo di ogni tipo, più l’intera famiglia di output da foglio di calcolo → PDF / immagine / dati web — tutto dietro una sola superficie API. — ## 3. Due cose di cui hai bisogno prima di iniziare 1. Registrati per un account gratuito sul Aspose Cloud Dashboard e crea un’Applicazione per ottenere un Client ID e Client Secret (gli SDK scambiano questi per un JWT automaticamente — non è necessario costruire le intestazioni di autenticazione da solo). 2. Installa l’SDK per il linguaggio di tua scelta: xml <!-- .NET --> <PackageReference Include="Aspose.Cells-Cloud" Version="25.x" /> bash # Python pip install asposecellscloud xml <!-- Java (Maven) — nota: NON su Maven Central, quindi il repository Aspose qui sotto è necessario --> <repositories> <repository> <id>AsposeJavaAPI</id> <name>Aspose Java API</name> <url>https://repository.aspose.cloud/repo/</url> </repository> </repositories> <dependency> <groupId>com.aspose</groupId> <artifactId>aspose-cells-cloud</artifactId> <version>26.8</version> </dependency> > Nessun SDK richiesto? Tutto è pura REST, quindi cURL funziona altrettanto bene (vedi sotto). — ## 4. Scenario 1: Converti un file Excel locale online (l’API Convert principale) Questo è PUT /v4.0/cells/convert/spreadsheet — l’API “Convert” di punta: carica il tuo file locale nel corpo della richiesta, il server lo converte e restituisce il nuovo file. Niente viene persistito nello storage cloud e non rimane una copia di upload — perfetto per i momenti “converti semplicemente questo per me”. ### ① cURL bash # 1) Prima, ottieni un token curl -X POST "https://api.aspose.cloud/connect/token" \ -d "grant_type=client_credentials" \ -d "client_id=YOUR_CLIENT_ID" \ -d "client_secret=YOUR_CLIENT_SECRET" # 2) XLSX -> PDF curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/spreadsheet?format=pdf" \ -H "Authorization: Bearer $TOKEN" \ -F "file=@Book1.xlsx" \ -o Book1.pdf Scambia format con csv, json, png, xlsx… e ottieni quel formato. Un parametro, un formato di output. ### ② C# / .NET csharp using Aspose.Cells.Cloud.SDK.Api; using Aspose.Cells.Cloud.SDK.Request; var cellsApi = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET"); var request = new ConvertSpreadsheetRequest( spreadsheet: "C:/invoices/Book1.xlsx", // percorso del file locale format: "pdf"); // target: pdf / csv / json / png ... using Stream result = cellsApi.ConvertSpreadsheet(request); // stream del file convertito using var outFile = File.Create("C:/invoices/Book1.pdf"); result.CopyTo(outFile); // Ancora più semplice: punta l'SDK a un percorso di output e lascialo scrivere il file // cellsApi.ConvertSpreadsheet(request, "C:/invoices/Book1.pdf"); > Hai bisogno di un lavoro batch? Inserisci questo in un ciclo su una directory e avrai “converti l’intera cartella XLSX → PDF”. ### ③ Python python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ConvertSpreadsheetRequest import os instance = CellsApi( os.getenv('CellsCloudClientId'), os.getenv('CellsCloudClientSecret')) # XLSX locale -> PDF, risultato scritto localmente instance.convert_spreadsheet( ConvertSpreadsheetRequest("Book1.xlsx", "pdf"), local_outpath="Book1.pdf") # Altri formati: basta cambiare il parametro — json / csv / xlsx / png ... ### ④ Java java import com.aspose.cloud.cells.api.CellsApi; import com.aspose.cloud.cells.request.ConvertSpreadsheetRequest; import java.io.File; public class ConvertDemo { public static void main(String[] args) throws Exception { CellsApi api = new CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET"); ConvertSpreadsheetRequest req = new ConvertSpreadsheetRequest(); req.setSpreadsheet("C:/invoices/Book1.xlsx"); // percorso del file locale req.setFormat("pdf"); // target: pdf / csv / json / png ... File out = api.convertSpreadsheet(req); // risultato convertito come File out.renameTo(new File("C:/invoices/Book1.pdf")); System.out.println("Convertito: " + out.getAbsolutePath()); } } Quattro lingue, un’azione: dai un percorso + un parametro di formato → ottieni il file target di ritorno. Questo è il vero punto di forza dell’API Convert — nessuna dipendenza da Excel sul lato chiamante, nessun template, nessun componente COM. — ## 5. Scenario 2: Converti un file memorizzato nel cloud direttamente Quando un file è già presente nello Storage Cloud di Aspose (o nel tuo storage oggetti), non è necessario scaricare/caricare file di grandi dimensioni — la conversione avviene nel cloud, riducendo al minimo il trasferimento dei dati e migliorando le prestazioni su grandi workbook: bash # cloud Book1.xlsx -> PDF, scaricato localmente curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "format=pdf" \ --data-urlencode "folder=Reports" \ -o Book1.pdf python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import ExportSpreadsheetAsFormatRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") # Converti un workbook memorizzato nel cloud direttamente in PDF instance.export_spreadsheet_as_format( ExportSpreadsheetAsFormatRequest("Book1.xlsx", format="pdf", folder="Reports")) Puoi anche approfondire un singolo elemento — ad esempio, rendere “il 3° grafico su Sheet1” come PNG (versione cloud): bash # grafico -> PNG curl -G "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/worksheets/Sheet1/charts/2" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "format=png" \ -o chart.png Endpoint cloud granulari a colpo d’occhio: | Target | Endpoint | Esempio format | | —————- | ——————————————————- | —————————– | | Intero workbook | GET /v4.0/cells/{name} | pdf / xlsx / csv / json | | Singolo foglio di lavoro | GET /v4.0/cells/{name}/worksheets/{ws} | pdf / png / svg | | Singolo intervallo | GET /v4.0/cells/{name}/worksheets/{ws}/ranges/{range} | pdf / csv / json / html / png | | Singola tabella | GET /v4.0/cells/{name}/worksheets/{ws}/tables/{table} | pdf / csv / json / html / png | | Singolo grafico | GET /v4.0/cells/{name}/worksheets/{ws}/charts/{index} | pdf / png / jpeg / svg / tiff | — ## 6. Scenario 3: SaveAs — scrivi il risultato di nuovo nello storage cloud Quando desideri che il file convertito sia persistito di nuovo nello storage cloud (anziché scaricato), utilizza PUT /v4.0/cells/{name}/saveas. È una soluzione naturale per automazioni come “esporta il report di oggi in PDF per archiviazione, ogni giorno”: bash curl -X PUT "https://api.aspose.cloud/v4.0/cells/Book1.xlsx/saveas?format=pdf" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{}' python from asposecellscloud.apis.cells_api import CellsApi from asposecellscloud.requests import SaveSpreadsheetAsRequest instance = CellsApi("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET") instance.save_spreadsheet_as( SaveSpreadsheetAsRequest("Book1.xlsx", format="pdf", folder="Reports")) # Il risultato è salvato direttamente nello storage cloud; restituisce CellsCloudResponse(Code=200, Status="OK") Puoi passare opzioni di salvataggio dettagliate attraverso il corpo della richiesta SaveOptionsData, e controllare nome del file di output, storage di output, font personalizzati, regione/locale, password, ecc. tramite parametri di query — maggiori informazioni su questi sotto Dettagli ingegneristici di seguito. — ## 7. Altri endpoint “online convert” pronti all’uso Oltre alle conversioni a livello di workbook sopra, il controller espone un insieme completo di endpoint dedicati file locali → target specifico (stessa upload nel corpo della richiesta come Scenario 1), che sono più granulari e più economici in termini di larghezza di banda: | Obiettivo | Endpoint (PUT, prefisso /v4.0/cells/convert/) | | —————————————————– | ——————————————————————————————————– | | Workbook → PDF / JSON / CSV | spreadsheet/pdf, spreadsheet/json, spreadsheet/csv | | Foglio di lavoro → PDF / JSON / CSV / HTML / HTML-Table | worksheet/pdf, worksheet/json, worksheet/csv, worksheet/html, worksheet/html-table | | Foglio di lavoro → immagine | worksheet/image?worksheet=Sheet1&format=png | | Intervallo → PDF / CSV / HTML / JSON / immagine | range/pdf, range/csv, range/html, range/json, range/image?worksheet=..&range=A1:C12&format=png | | Tabella → PDF / CSV / HTML / JSON / immagine | table/pdf, table/csv, table/html, table/json, table/image | | Grafico → immagine / PDF | chart/image?worksheet=..&chartIndex=0&format=png, chart/pdf | Ad esempio, “esporta solo questo intervallo come CSV per il sistema downstream”: bash curl -X PUT "https://api.aspose.cloud/v4.0/cells/convert/range/csv" \ -H "Authorization: Bearer $TOKEN" \ --data-urlencode "worksheet=Sheet1" \ --data-urlencode "range=A1:C100" \ -F "file=@data.xlsx" \ -o data.csv Questi endpoint utilizzano lo stesso modello di upload nel corpo come convert/spreadsheet. Nell’SDK .NET i casi di grafico hanno wrapper tipizzati che mappano a queste rotte v4.0 — ConvertChartToImage (convert/chart/image) e ConvertChartToPdf (convert/chart/pdf). Le varianti worksheet/*, range/* e table/* non hanno ancora un wrapper v4.0, quindi chiamale tramite pura REST esattamente come fa il cURL sopra. — ## 8. Dettagli ingegneristici & gestione degli errori ### Opzioni di conversione da conoscere (parametri di query) - password — apri workbook protetti da password; - fontsLocation / supporto font personalizzati — mantieni corretti i glifi durante il rendering di PDF/immagini; - auto-adatta righe/colonne, e se stampare intestazioni di righe/colonne (printHeadings), configurazione regione/pagina (region), ecc.; - lato output: outPath / outStorageName decidono dove si trova il risultato nello storage cloud. ### Codici di errore (il contratto documentato dal controller) | Stato | Significato | Causa tipica | | ——- | —————- | ———————————————————– | | 400 | Richiesta non valida | URL / parametri non validi, o un format non supportato | | 401 | Non autorizzato | Autenticazione fallita o nessuna credenziale valida fornita | | 404 | Non trovato | Il file sorgente non è accessibile nello storage cloud | | 500 | Errore del server | Il servizio ha riscontrato un’anomalia durante l’ottenimento dei dati di conversione | ### Autenticazione Tutti gli SDK si autenticano automaticamente con OAuth 2.0 client_credentials e un JWT; quando utilizzi raw cURL, chiama /connect/token una volta prima (vedi Scenario 1, ① sopra). — ## 9. Perché Aspose.Cells Cloud Convert? - ✅ Zero dipendenze locali — nessun Office/Excel, nessun COM. Chiamabile da qualsiasi linguaggio e qualsiasi piattaforma (Linux, contenitori, serverless); - ✅ Rendering ad alta fedeltà — alimentato dal motore Aspose.Cells, quindi formule, grafici, stili e paginazione vengono renderizzati con qualità professionale in PDF/immagini; - ✅ Nativo nel cloud — i file possono rimanere nel cloud durante la conversione per evitare di spedire grandi payload; la pura conversione online non richiede affatto storage cloud; - ✅ Granularità flessibile — workbook / foglio di lavoro / intervallo / tabella / grafico: converti esattamente il pezzo di cui hai bisogno; - ✅ Una forma attraverso gli SDK — gli esempi di cURL, .NET, Python e Java mappano 1:1, quindi puoi letteralmente copiare il modello che preferisci. Inizia ora: registrati sul Aspose Cloud Dashboard, crea un’Applicazione, inserisci le tue credenziali in uno qualsiasi degli snippet sopra e eseguilo — avrai il tuo “convertitore Excel cloud” in pochi minuti. Hai trovato utile questo? Metti un like, segna come preferito o condividi — e raccontaci dei tuoi casi d’uso di conversione di fogli di calcolo nei commenti.