Exportar datos desde JSON archivos a hojas de cálculo de Excel es un requisito frecuente para la generación de informes y el intercambio de datos en aplicaciones modernas de Node.JS. Aspose.OCR Cloud SDK for Node.js proporciona una API potente que puede manejar esta conversión directamente en la nube. En esta guía, aprenderá cómo convertir JSON a XLSX en Node.JS utilizando patrones async/await y el método convertDocument del SDK. Recorreremos los requisitos previos, una explicación detallada del código, un ejemplo completo e incluso una alternativa cURL para la integración REST.

Antes de comenzar: requisitos e instalación

Para seguir este tutorial necesitas:

  • Node.js 14 o posterior instalado localmente.
  • Una cuenta de Aspose Cloud con la API OCR habilitada.
  • Tu Client Id y Client Secret del panel de Aspose Cloud.
  • Acceso al sistema de archivos donde residirán el origen JSON y la salida XLSX.

Instale el SDK mediante npm:

npm install aspose-ocr-cloud

Descargue el paquete más reciente desde la página oficial de lanzamientos: Aspose.OCR Cloud SDK for Node.js Descargar. Después de la instalación, puede comenzar a programar.

El siguiente fragmento muestra cómo configurar el cliente OCR con sus credenciales:

const { OcrApi, Configuration } = require('asposeocrcloud');

const config = new Configuration({
    clientId: 'YOUR_CLIENT_ID',
    clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);

Con el cliente listo, las siguientes secciones demuestran el flujo de trabajo de conversión paso a paso.

Guía paso a paso para convertir JSON a XLSX en Node.JS

A continuación se muestra una guía detallada de cada operación necesaria para convertir JSON a XLSX en Node.JS.

Paso 1: Cargar el documento de origen

Primero, crea un flujo de lectura para el archivo JSON que deseas convertir.

const fs = require('fs');
const path = require('path');

const inputJsonPath = path.resolve(__dirname, 'input.json');
const jsonFileStream = fs.createReadStream(inputJsonPath);

Paso 2: Configurar el cliente API de OCR

Reutilice la configuración mostrada anteriormente para instanciar el objeto API.

const { OcrApi, Configuration } = require('asposeocrcloud');

const config = new Configuration({
    clientId: 'YOUR_CLIENT_ID',
    clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);

Paso 3: Llamar al método ConvertDocument

Invoca el endpoint de conversión, especificando xlsx como formato de destino.

const response = await ocrApi.convertDocument({
    format: 'xlsx',
    file: jsonFileStream
});

El SDK devuelve los datos binarios XLSX en response.body.

Paso 4: Escribir el archivo de salida XLSX

Guarde los datos binarios en un archivo en el disco.

const outputXlsxPath = path.resolve(__dirname, 'output.xlsx');
fs.writeFileSync(outputXlsxPath, response.body, { encoding: 'binary' });
console.log('Conversion completed successfully:', outputXlsxPath);

Paso 5: Limpiar recursos

Cierre el flujo de archivo para liberar los recursos del sistema.

jsonFileStream.close();

Con estos pasos, ha realizado con éxito una conversión de JSON a XLSX en Node.JS utilizando la biblioteca Aspose OCR Cloud.

Conversión de JSON a XLSX en Node.JS - Ejemplo de código completo

El ejemplo a continuación muestra la implementación completa para convertir JSON a XLSX en Node.JS usando 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 ejemplo de código demuestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Enfoque cURL para la conversión de JSON a XLSX en Node.JS

Si prefiere una solución REST pura, la misma conversión se puede realizar con comandos cURL. Este método también utiliza la frase principal convertir JSON a XLSX en Node.JS.

  1. Obtener un token de acceso
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"
  1. Cargue el archivo JSON y solicite la conversión
curl -X POST "https://api.aspose.cloud/v3.0/ocr/convert?format=xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.json"

La respuesta contiene la carga binaria XLSX.

  1. Guardar la salida 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

Estos comandos ilustran cómo lograr el mismo resultado sin escribir ningún código Node.js. Para obtener más detalles, consulte la documentación oficial de la API.

Conclusión

Convertir JSON a XLSX en Node.JS se vuelve sencillo cuando aprovechas el Aspose.OCR Cloud SDK for Node.js. El SDK se encarga del trabajo pesado, permitiéndote centrarte en la lógica de negocio en lugar de en las complejidades del formato de archivo. Recuerda asegurar tus credenciales de cliente, manejar los errores de forma adecuada y probar con tamaños de datos realistas. Para implementaciones en producción necesitarás una suscripción paga; los detalles de precios están disponibles en la página del producto, y una licencia temporal se puede obtener desde la página de licencia temporal. ¡Feliz codificación!

Preguntas frecuentes

¿Cómo convierto JSON a XLSX en Node.JS usando Aspose.OCR Cloud SDK?
Utilice el método OcrApi.convertDocument con format: 'xlsx'. El ejemplo de código completo en este artículo muestra los pasos exactos de implementación.

¿Qué autenticación se requiere para la API OCR Cloud?
Cree un ID de cliente y un secreto de cliente en el panel de Aspose Cloud, luego cámbielos por un token OAuth. El objeto Configuration del SDK administra la recuperación del token automáticamente.

¿Puedo procesar archivos JSON grandes de manera eficiente?
Sí. El SDK transmite el archivo de entrada, manteniendo bajo el uso de memoria. Combine esto con async/await para mantener el bucle de eventos de Node.js receptivo.

¿Dónde puedo encontrar más ejemplos y soporte?
Visite el repositorio oficial de GitHub, el sitio de documentación de Aspose, o haga preguntas en el foro de soporte.

Leer más