L’exportation de données à partir de fichiers JSON vers des feuilles de calcul Excel est une exigence fréquente pour le reporting et l’échange de données dans les applications Node.JS modernes. Aspose.OCR Cloud SDK for Node.js fournit une API puissante qui peut gérer cette conversion directement dans le cloud. Dans ce guide, vous apprendrez comment convertir du JSON en XLSX dans Node.JS en utilisant les modèles async/await et la méthode convertDocument du SDK. Nous passerons en revue les prérequis, une analyse détaillée du code, un exemple complet, ainsi qu’une alternative cURL pour l’intégration REST.

Avant de commencer : Prérequis et Installation

Pour suivre ce tutoriel, vous avez besoin de :

  • Node.js 14 ou version ultérieure installé localement.
  • Un compte Aspose Cloud avec l’API OCR activée.
  • Votre Client Id et Client Secret depuis le tableau de bord Aspose Cloud.
  • Accès au système de fichiers où le source JSON et la sortie XLSX résideront.

Installez le SDK via npm:

npm install aspose-ocr-cloud

Téléchargez le dernier package depuis la page officielle de publication : Aspose.OCR Cloud SDK for Node.js Téléchargement. Après l’installation, vous pouvez commencer à coder.

Le fragment suivant montre comment configurer le client OCR avec vos identifiants :

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

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

Avec le client prêt, les sections suivantes démontrent le flux de travail de conversion étape par étape.

Guide étape par étape pour convertir JSON en XLSX dans Node.JS

Voici une présentation détaillée de chaque opération requise pour convertir JSON en XLSX dans Node.JS.

Étape 1 : Charger le document source

Tout d’abord, créez un flux de lecture pour le fichier JSON que vous souhaitez convertir.

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

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

Étape 2 : Configurer le client API OCR

Réutilisez la configuration affichée précédemment pour instancier l’objet API.

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

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

Étape 3 : appeler la méthode ConvertDocument

Appelez le point de terminaison de conversion, en spécifiant xlsx comme format cible.

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

Le SDK renvoie les données binaires XLSX dans response.body.

Étape 4 : écrire le fichier de sortie XLSX

Enregistrez les données binaires dans un fichier sur le disque.

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

Étape 5 : Nettoyer les ressources

Fermez le flux de fichier pour libérer les ressources système.

jsonFileStream.close();

Avec ces étapes, vous avez réussi à effectuer une opération de conversion de JSON en XLSX dans Node.JS en utilisant la bibliothèque Aspose OCR Cloud.

Conversion JSON vers XLSX en Node.JS - Exemple de code complet

L’exemple ci‑dessous montre l’implémentation complète pour convertir du JSON en XLSX en Node.JS en utilisant 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();
    }
})();

Remarque : Cet exemple de code montre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Approche cURL pour la conversion JSON en XLSX avec Node.JS

Si vous préférez une solution REST pure, la même conversion peut être effectuée avec des commandes cURL. Cette méthode utilise également la phrase principale convert JSON to XLSX en Node.JS.

  1. Obtenir un jeton d’accès
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. Téléversez le fichier JSON et demandez la conversion
curl -X POST "https://api.aspose.cloud/v3.0/ocr/convert?format=xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.json"

La réponse contient la charge utile binaire XLSX.

  1. Enregistrer la sortie XLSX localement
curl -X GET "https://api.aspose.cloud/v3.0/ocr/convert/result/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

Ces commandes illustrent comment obtenir le même résultat sans écrire de code Node.js. Pour plus de détails, consultez la documentation officielle de l’API.

Conclusion

Convertir du JSON en XLSX dans Node.JS devient simple lorsque vous exploitez le Aspose.OCR Cloud SDK for Node.js. Le SDK gère les tâches lourdes, vous permettant de vous concentrer sur la logique métier plutôt que sur les complexités du format de fichier. N’oubliez pas de sécuriser vos identifiants client, de gérer les erreurs de manière élégante et de tester avec des tailles de données réalistes. Pour les déploiements en production, vous aurez besoin d’un abonnement payant ; les détails de tarification sont disponibles sur la page du produit, et une licence temporaire peut être obtenue depuis la page de licence temporaire. Bon codage!

FAQs

Comment convertir du JSON en XLSX dans Node.JS en utilisant Aspose.OCR Cloud SDK?
Utilisez la méthode OcrApi.convertDocument avec format: 'xlsx'. L’exemple complet de code dans cet article montre les étapes exactes d’implémentation.

Quelle authentification est requise pour l’API OCR Cloud ?
Créez un ID client et un secret client dans le tableau de bord Aspose Cloud, puis échangez‑les contre un jeton OAuth. L’objet Configuration du SDK gère automatiquement la récupération du jeton.

Puis-je traiter de gros fichiers JSON efficacement ?
Oui. Le SDK diffuse le fichier d’entrée, maintenant une faible utilisation de la mémoire. Combinez cela avec async/await pour garder la boucle d’événements Node.js réactive.

Où puis-je trouver plus d’exemples et d’assistance ?
Visitez le référentiel officiel GitHub, le site de documentation Aspose, ou posez des questions sur le forum d’assistance.

En savoir plus