Esportare dati da file JSON a fogli di calcolo Excel è una necessità frequente per la creazione di report e lo scambio di dati nelle moderne applicazioni Node.JS. Aspose.OCR Cloud SDK for Node.js offre un’API potente che può gestire questa conversione direttamente nel cloud. In questa guida imparerai come convertire JSON in XLSX in Node.JS usando i pattern async/await e il metodo convertDocument dell’SDK. Esamineremo i prerequisiti, una walkthrough dettagliata del codice, un esempio completo e anche un’alternativa cURL per l’integrazione REST.
Prima di Iniziare: Prerequisiti e Installazione
Per seguire questo tutorial è necessario:
- Node.js 14 o versioni successive installati localmente.
- Un account Aspose Cloud con l’API OCR abilitata.
- Il tuo Client Id e Client Secret dalla dashboard di Aspose Cloud.
- Accesso al file system dove risiederanno il file JSON di origine e l’output XLSX.
Installa l’SDK tramite npm:
npm install aspose-ocr-cloud
Scarica l’ultimo pacchetto dalla pagina di rilascio ufficiale: Aspose.OCR Cloud SDK for Node.js Download. Dopo l’installazione, puoi iniziare a programmare.
Il seguente snippet mostra come configurare il client OCR con le tue credenziali:
const { OcrApi, Configuration } = require('asposeocrcloud');
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);
Con il client pronto, le sezioni successive dimostrano il flusso di lavoro di conversione passo dopo passo.
Guida passo-passo per convertire JSON in XLSX in Node.JS
Di seguito è una descrizione dettagliata di ciascuna operazione necessaria per convertire JSON in XLSX in Node.JS.
Passo 1: Carica il documento di origine
Innanzitutto, crea uno stream di lettura per il file JSON che desideri convertire.
const fs = require('fs');
const path = require('path');
const inputJsonPath = path.resolve(__dirname, 'input.json');
const jsonFileStream = fs.createReadStream(inputJsonPath);
Passo 2: Configura il client API OCR
Riutilizza la configurazione mostrata in precedenza per istanziare l’oggetto API.
const { OcrApi, Configuration } = require('asposeocrcloud');
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);
Passo 3: Chiama il metodo ConvertDocument
Invoca l’endpoint di conversione, specificando xlsx come formato di destinazione.
const response = await ocrApi.convertDocument({
format: 'xlsx',
file: jsonFileStream
});
L’SDK restituisce i dati binari XLSX in response.body.
Passo 4: Scrivi il file di output XLSX
Salva i dati binari su un file su disco.
const outputXlsxPath = path.resolve(__dirname, 'output.xlsx');
fs.writeFileSync(outputXlsxPath, response.body, { encoding: 'binary' });
console.log('Conversion completed successfully:', outputXlsxPath);
Passo 5: Pulizia delle risorse
Chiudi il flusso del file per liberare le risorse di sistema.
jsonFileStream.close();
Con questi passaggi, hai eseguito con successo un’operazione di conversione da JSON a XLSX in Node.JS utilizzando la libreria Aspose OCR Cloud.
Conversione da JSON a XLSX in Node.JS - Esempio di Codice Completo
L’esempio seguente dimostra l’implementazione completa per convertire JSON in XLSX in Node.JS utilizzando Aspose.OCR Cloud SDK.
const fs = require('fs');
const path = require('path');
const { OcrApi, Configuration } = require('asposeocrcloud');
(async () => {
// Configure Aspose OCR Cloud client
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);
// Define input JSON and output XLSX paths
const inputJsonPath = path.resolve(__dirname, 'input.json');
const outputXlsxPath = path.resolve(__dirname, 'output.xlsx');
// Prepare file stream for the JSON file
const jsonFileStream = fs.createReadStream(inputJsonPath);
try {
// Convert JSON to XLSX using Aspose OCR Cloud SDK
const response = await ocrApi.convertDocument({
format: 'xlsx',
file: jsonFileStream
});
// Write the returned binary data to the XLSX file
fs.writeFileSync(outputXlsxPath, response.body, { encoding: 'binary' });
console.log('Conversion completed successfully:', outputXlsxPath);
} catch (error) {
console.error('Conversion failed:', error);
} finally {
// Ensure the file stream is closed
jsonFileStream.close();
}
})();
Nota: Questo esempio di codice dimostra la funzionalità principale. Prima di utilizzarlo nel tuo progetto, assicurati di aggiornare tutti i percorsi dei file e i valori di configurazione per corrispondere al tuo ambiente reale, verifica che tutte le dipendenze richieste siano correttamente installate e testa accuratamente nel tuo ambiente di sviluppo. Se incontri problemi, consulta la documentazione ufficiale o contatta il team di supporto per assistenza.
Approccio cURL per la conversione da JSON a XLSX in Node.JS
Se preferisci una soluzione REST pura, la stessa conversione può essere eseguita con comandi cURL. Questo metodo utilizza anche la frase principale convert JSON to XLSX in Node.JS.
- Ottieni un token di accesso
curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
- Carica il file JSON e richiedi la conversione
curl -X POST "https://api.aspose.cloud/v3.0/ocr/convert?format=xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@input.json"
La risposta contiene il payload binario XLSX.
- Salva l’output XLSX localmente
curl -X GET "https://api.aspose.cloud/v3.0/ocr/convert/result/output.xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.xlsx
Questi comandi illustrano come ottenere lo stesso risultato senza scrivere alcun codice Node.js. Per ulteriori dettagli, consultare la documentazione ufficiale dell’API.
Conclusione
Convertire JSON in XLSX in Node.JS diventa semplice quando si utilizza il Aspose.OCR Cloud SDK for Node.js. L’SDK gestisce il lavoro pesante, consentendoti di concentrarti sulla logica di business anziché sulle complessità del formato file. Ricorda di proteggere le credenziali client, gestire gli errori in modo appropriato e testare con dimensioni di dati realistiche. Per le distribuzioni in produzione avrai bisogno di un abbonamento a pagamento; i dettagli dei prezzi sono disponibili nella pagina del prodotto, e una licenza temporanea può essere ottenuta dalla pagina della licenza temporanea. Buona programmazione!
FAQs
Come converto JSON in XLSX in Node.JS usando Aspose.OCR Cloud SDK?
Utilizza il metodo OcrApi.convertDocument con format: 'xlsx'. L’esempio di codice completo in questo articolo mostra i passaggi esatti di implementazione.
Qual è l’autenticazione richiesta per l’OCR Cloud API?
Crea un client ID e un client secret nella dashboard di Aspose Cloud, quindi scambiali per un token OAuth. L’oggetto Configuration dell’SDK gestisce automaticamente il recupero del token.
Posso elaborare file JSON di grandi dimensioni in modo efficiente?
Sì. L’SDK trasmette in streaming il file di input, mantenendo basso l’uso della memoria. Combina questo con async/await per mantenere il ciclo di eventi di Node.js reattivo.
Dove posso trovare più esempi e supporto?
Visita il repository ufficiale su GitHub, il sito di documentazione di Aspose o poni domande sul forum di supporto.