Exportar dados de arquivos JSON para planilhas Excel é uma necessidade frequente para relatórios e troca de dados em aplicações Node.JS modernas. O Aspose.OCR Cloud SDK for Node.js fornece uma API poderosa que pode lidar com essa conversão diretamente na nuvem. Neste guia, você aprenderá como converter JSON para XLSX em Node.JS usando padrões async/await e o método convertDocument do SDK. Percorreremos os pré‑requisitos, uma análise detalhada do código, um exemplo completo e até uma alternativa cURL para integração REST.
Antes de Começar: Pré-requisitos e Instalação
Para seguir este tutorial, você precisa de:
- Node.js 14 ou posterior instalado localmente.
- Uma conta Aspose Cloud com OCR API habilitada.
- Seu Client Id e Client Secret do painel Aspose Cloud.
- Acesso ao sistema de arquivos onde o JSON de origem e o XLSX de saída residirão.
Instale o SDK via npm:
npm install aspose-ocr-cloud
Baixe o pacote mais recente na página oficial de lançamentos: Aspose.OCR Cloud SDK for Node.js Download. Após a instalação, você pode começar a codificar.
O trecho a seguir mostra como configurar o cliente OCR com suas credenciais:
const { OcrApi, Configuration } = require('asposeocrcloud');
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);
Com o cliente pronto, as próximas seções demonstram o fluxo de trabalho de conversão passo a passo.
Guia passo a passo para converter JSON em XLSX no Node.JS
A seguir está um walkthrough detalhado de cada operação necessária para converter JSON em XLSX no Node.JS.
Etapa 1: Carregar o Documento de Origem
Primeiro, crie um fluxo de leitura para o arquivo JSON que você deseja converter.
const fs = require('fs');
const path = require('path');
const inputJsonPath = path.resolve(__dirname, 'input.json');
const jsonFileStream = fs.createReadStream(inputJsonPath);
Etapa 2: Configurar o cliente da API OCR
Reutilize a configuração mostrada anteriormente para instanciar o objeto da API.
const { OcrApi, Configuration } = require('asposeocrcloud');
const config = new Configuration({
clientId: 'YOUR_CLIENT_ID',
clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);
Etapa 3: Chamar o método ConvertDocument
Chame o endpoint de conversão, especificando xlsx como o formato de destino.
const response = await ocrApi.convertDocument({
format: 'xlsx',
file: jsonFileStream
});
O SDK retorna os dados binários XLSX em response.body.
Etapa 4: Gravar o arquivo de saída XLSX
Persistir os dados binários em um arquivo no disco.
const outputXlsxPath = path.resolve(__dirname, 'output.xlsx');
fs.writeFileSync(outputXlsxPath, response.body, { encoding: 'binary' });
console.log('Conversion completed successfully:', outputXlsxPath);
Passo 5: Limpar Recursos
Feche o fluxo de arquivo para liberar os recursos do sistema.
jsonFileStream.close();
Com estas etapas, você concluiu com sucesso a conversão de JSON para XLSX em Node.JS usando a biblioteca Aspose OCR Cloud.
Conversão de JSON para XLSX em Node.JS - Exemplo de Código Completo
O exemplo abaixo demonstra a implementação completa para converter JSON em XLSX no Node.JS usando o 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: Este exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.
Abordagem cURL para Conversão de JSON para XLSX em Node.JS
Se você preferir uma solução REST pura, a mesma conversão pode ser realizada com comandos cURL. Este método também usa a frase principal convert JSON to XLSX in Node.JS.
- Obter um token de acesso
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"
- Carregue o arquivo JSON e solicite a conversão
curl -X POST "https://api.aspose.cloud/v3.0/ocr/convert?format=xlsx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-F "file=@input.json"
A resposta contém o payload binário XLSX.
- Salvar a saída 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
Esses comandos ilustram como obter o mesmo resultado sem escrever nenhum código Node.js. Para mais detalhes, consulte a documentação oficial da API.
Conclusão
Converter JSON para XLSX em Node.JS torna-se simples quando você aproveita o Aspose.OCR Cloud SDK for Node.js. O SDK cuida do trabalho pesado, permitindo que você se concentre na lógica de negócios em vez das complexidades do formato de arquivo. Lembre-se de proteger suas credenciais de cliente, tratar erros de forma elegante e testar com tamanhos de dados realistas. Para implantações em produção, você precisará de uma assinatura paga; detalhes de preços estão disponíveis na página do produto, e uma licença temporária pode ser obtida na página de licença temporária. Feliz codificação!
FAQs
Como converto JSON para XLSX em Node.JS usando o Aspose.OCR Cloud SDK?
Use o método OcrApi.convertDocument com format: 'xlsx'. O exemplo de código completo neste artigo mostra as etapas exatas de implementação.
Qual autenticação é necessária para a OCR Cloud API?
Crie um ID do cliente e um segredo do cliente no painel Aspose Cloud, depois troque-os por um token OAuth. O objeto Configuration do SDK gerencia a recuperação do token automaticamente.
Posso processar arquivos JSON grandes de forma eficiente?
Sim. O SDK transmite o arquivo de entrada, mantendo o uso de memória baixo. Combine isso com async/await para manter o loop de eventos do Node.js responsivo.
Onde posso encontrar mais exemplos e suporte?
Visite o repositório oficial do GitHub, o site de documentação da Aspose ou faça perguntas no forum de suporte.