Η εξαγωγή δεδομένων από αρχεία JSON σε λογιστικά φύλλα Excel είναι μια συχνή απαίτηση για αναφορές και ανταλλαγή δεδομένων σε σύγχρονες εφαρμογές Node.JS. Το Aspose.OCR Cloud SDK for Node.js παρέχει ένα ισχυρό API που μπορεί να διαχειριστεί αυτή τη μετατροπή απευθείας στο cloud. Σε αυτόν τον οδηγό, θα μάθετε πώς να μετατρέψετε JSON σε XLSX στο Node.JS χρησιμοποιώντας πρότυπα async/await και τη μέθοδο convertDocument του SDK. Θα περάσουμε από τις προαπαιτούμενες απαιτήσεις, μια λεπτομερή ανάλυση κώδικα, ένα πλήρες παράδειγμα και ακόμη μια εναλλακτική cURL για ενσωμάτωση REST.

Πριν Ξεκινήσετε: Προαπαιτούμενα και Εγκατάσταση

Για να ακολουθήσετε αυτό το tutorial χρειάζεστε:

  • Node.js 14 ή νεότερο εγκατεστημένο τοπικά.
  • Λογαριασμό Aspose Cloud με ενεργοποιημένο το OCR API.
  • Το Client Id και το Client Secret από τον πίνακα ελέγχου του Aspose Cloud.
  • Πρόσβαση στο σύστημα αρχείων όπου θα βρίσκονται η πηγή JSON και η έξοδος XLSX.

Εγκαταστήστε το SDK μέσω npm:

npm install aspose-ocr-cloud

Κατεβάστε το τελευταίο πακέτο από τη σελίδα επίσημης κυκλοφορίας: Aspose.OCR Cloud SDK for Node.js Download. Μετά την εγκατάσταση, μπορείτε να αρχίσετε να γράφετε κώδικα.

Το παρακάτω απόσπασμα δείχνει πώς να διαμορφώσετε τον πελάτη OCR με τα διαπιστευτήριά σας:

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

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

Με τον πελάτη έτοιμο, οι επόμενες ενότητες παρουσιάζουν τη ροή εργασίας μετατροπής βήμα προς βήμα.

Οδηγός βήμα-βήμα για τη μετατροπή JSON σε XLSX σε Node.JS

Παρακάτω παρουσιάζεται μια λεπτομερής περιγραφή κάθε λειτουργίας που απαιτείται για τη μετατροπή JSON σε XLSX στο Node.JS.

Βήμα 1: Φόρτωση του Πηγαίου Εγγράφου

Πρώτα, δημιουργήστε ένα ρεύμα ανάγνωσης για το αρχείο JSON που θέλετε να μετατρέψετε.

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

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

Βήμα 2: Διαμόρφωση του πελάτη OCR API

Επαναχρησιμοποίηστε τη διαμόρφωση που εμφανίστηκε νωρίτερα για να δημιουργήσετε το αντικείμενο API.

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

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

Βήμα 3: Κλήση της μεθόδου ConvertDocument

Κλήστε το endpoint μετατροπής, καθορίζοντας xlsx ως μορφή προορισμού.

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

Το SDK επιστρέφει τα δυαδικά δεδομένα XLSX στο response.body.

Βήμα 4: Γράψτε το αρχείο εξόδου XLSX

Αποθηκεύστε τα δυαδικά δεδομένα σε ένα αρχείο στο δίσκο.

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

Βήμα 5: Καθαρισμός Πόρων

Κλείστε τη ροή αρχείου για να ελευθερώσετε πόρους συστήματος.

jsonFileStream.close();

Με αυτά τα βήματα, έχετε ολοκληρώσει με επιτυχία τη μετατροπή JSON σε XLSX σε λειτουργία Node.JS χρησιμοποιώντας τη βιβλιοθήκη Aspose OCR Cloud.

Μετατροπή JSON σε XLSX σε Node.JS - Πλήρες Παράδειγμα Κώδικα

Το παρακάτω παράδειγμα δείχνει την πλήρη υλοποίηση για τη μετατροπή JSON σε XLSX σε Node.JS χρησιμοποιώντας το 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();
    }
})();

Σημείωση: Αυτό το παράδειγμα κώδικα δείχνει τη βασική λειτουργικότητα. Πριν το χρησιμοποιήσετε στο έργο σας, βεβαιωθείτε ότι έχετε ενημερώσει τυχόν διαδρομές αρχείων και τιμές ρυθμίσεων ώστε να ταιριάζουν με το πραγματικό σας περιβάλλον, επαληθεύστε ότι όλες οι απαιτούμενες εξαρτήσεις είναι σωστά εγκατεστημένες και δοκιμάστε ενδελεχώς στο περιβάλλον ανάπτυξής σας. Εάν αντιμετωπίσετε προβλήματα, παρακαλούμε ανατρέξτε στην επίσημη τεκμηρίωση ή επικοινωνήστε με την ομάδα υποστήριξης για βοήθεια.

Προσέγγιση cURL για τη μετατροπή JSON σε XLSX σε Node.JS

Αν προτιμάτε μια καθαρά REST λύση, η ίδια μετατροπή μπορεί να εκτελεστεί με εντολές cURL. Αυτή η μέθοδος χρησιμοποιεί επίσης τη βασική φράση convert JSON to XLSX σε Node.JS.

  1. Αποκτήστε ένα διακριτικό πρόσβασης
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. Ανεβάστε το αρχείο JSON και ζητήστε τη μετατροπή
curl -X POST "https://api.aspose.cloud/v3.0/ocr/convert?format=xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.json"

Η απάντηση περιέχει το δυαδικό payload XLSX.

  1. Αποθηκεύστε το αρχείο εξόδου XLSX τοπικά
curl -X GET "https://api.aspose.cloud/v3.0/ocr/convert/result/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

Αυτές οι εντολές δείχνουν πώς να επιτύχετε το ίδιο αποτέλεσμα χωρίς να γράψετε κώδικα Node.js. Για περισσότερες λεπτομέρειες, ανατρέξτε στην επίσημη τεκμηρίωση API.

Συμπέρασμα

Μετατροπή JSON σε XLSX στο Node.JS γίνεται απλή όταν αξιοποιείτε το Aspose.OCR Cloud SDK for Node.js. Το SDK διαχειρίζεται το βαριά φορτίο, επιτρέποντάς σας να εστιάσετε στη λογική της επιχείρησης αντί στις λεπτομέρειες των μορφών αρχείων. Θυμηθείτε να ασφαλίζετε τα διαπιστευτήρια του πελάτη, να διαχειρίζεστε τα σφάλματα με χάρη και να δοκιμάζετε με ρεαλιστικά μεγέθη δεδομένων. Για παραγωγικές αναπτύξεις θα χρειαστείτε πληρωμένη συνδρομή· οι λεπτομέρειες τιμολόγησης είναι διαθέσιμες στη σελίδα του προϊόντος, και μια προσωρινή άδεια μπορεί να ληφθεί από τη σελίδα προσωρινής άδειας. Καλή προγραμματιστική!

Συχνές ερωτήσεις

Πώς μπορώ να μετατρέψω JSON σε XLSX σε Node.JS χρησιμοποιώντας το Aspose.OCR Cloud SDK?
Χρησιμοποιήστε τη μέθοδο OcrApi.convertDocument με format: 'xlsx'. Το πλήρες παράδειγμα κώδικα σε αυτό το άρθρο δείχνει τα ακριβή βήματα υλοποίησης.

Τι είδους έλεγχος ταυτότητας απαιτείται για το OCR Cloud API;
Δημιουργήστε ένα client ID και ένα client secret στον πίνακα ελέγχου Aspose Cloud, στη συνέχεια ανταλλάξτε τα για ένα διακριτικό OAuth. Το αντικείμενο Configuration του SDK διαχειρίζεται αυτόματα την ανάκτηση του διακριτικού.

Μπορώ να επεξεργαστώ μεγάλα αρχεία JSON αποδοτικά;
Ναι. Το SDK μεταδίδει το αρχείο εισόδου, διατηρώντας τη χρήση μνήμης χαμηλή. Συνδυάστε αυτό με async/await για να διατηρήσετε τον βρόχο γεγονότων του Node.js ανταποκρινόμενο.

Πού μπορώ να βρω περισσότερα παραδείγματα και υποστήριξη;
Επισκεφθείτε το επίσημο αποθετήριο GitHub, τον ιστότοπο τεκμηρίωσης Aspose ή κάντε ερωτήσεις στο φόρουμ υποστήριξης.

Διαβάστε Περισσότερα