Η μετατροπή δεδομένων Excel σε CSV είναι συχνή απαίτηση κατά την κατασκευή αγωγών δεδομένων, εργαλείων αναφοράς ή λειτουργιών εισαγωγής/εξαγωγής. Το Aspose.BarCode Cloud SDK for Node.js παρέχει μια ισχυρή βιβλιοθήκη που καθιστά τη μετατροπή από XLS σε CSV στο Node.JS απλή και αξιόπιστη. Αυτός ο οδηγός σας καθοδηγεί μέσω των προαπαιτήσεων, των βημάτων εγκατάστασης, ενός πλήρους λειτουργικού παραδείγματος και συμβουλών βέλτιστων πρακτικών, ώστε να μπορείτε να ενσωματώσετε τη μετατροπή στην εφαρμογή σας με σιγουριά.

Πλήρες Παράδειγμα Εργασίας για τη Μετατροπή XLS σε CSV σε Node.JS χρησιμοποιώντας Aspose.BarCode

Αυτό το παράδειγμα δείχνει πώς να διαβάσετε ένα βιβλίο εργασίας XLS από το cloud storage, να μετατρέψετε κάθε φύλλο εργασίας σε CSV και να μεταφέρετε το αποτέλεσμα πίσω στον πελάτη.

// Full working code for XLS to CSV conversion using Aspose.BarCode Cloud SDK

const { BarcodeApi, Configuration } = require('aspose-barcode-cloud');
const fs = require('fs');
const path = require('path');

// ==== Configuration ====
const config = new Configuration({
    clientId: "YOUR_CLIENT_ID",
    clientSecret: "YOUR_CLIENT_SECRET",
    // Optional: set a custom base URL if you use a private cloud
    // baseUrl: "https://api.aspose.cloud"
});

const apiInstance = new BarcodeApi(config);

// ==== Input / Output Paths ====
const inputFile = "sample.xls";               // Path to your local XLS file
const outputFolder = "output";                // Cloud folder for CSV files

// ---- 1. Upload XLS to cloud storage ----
async function uploadFile() {
    const fileData = fs.readFileSync(inputFile);
    await apiInstance.uploadFile({ path: inputFile, file: fileData });
    console.log(`Uploaded ${inputFile} to cloud storage.`);
}

// ---- 2. Convert XLS to CSV ----
async function convertXlsToCsv() {
    // Conversion options
    const options = {
        storage: "Default",               // Use default storage
        outPath: outputFolder,            // Destination folder
        format: "CSV",                    // Target format
        // Optional: delimiter, encoding, etc.
        delimiter: ",",
        encoding: "UTF-8"
    };

// Call the conversion endpoint (hypothetical method)
    const response = await apiInstance.convertDocument({
        name: inputFile,
        format: "csv",
        options: options
    });

console.log(`Conversion started. Check ${outputFolder} for CSV files.`);
    return response;
}

// ---- 3. Download generated CSV files ----
async function downloadCsvFiles() {
    const files = await apiInstance.getFilesList({ path: outputFolder });
    for (const file of files.value) {
        if (file.name.endsWith(".csv")) {
            const csvData = await apiInstance.downloadFile({ path: `${outputFolder}/${file.name}` });
            const localPath = path.join(__dirname, "result", file.name);
            fs.mkdirSync(path.dirname(localPath), { recursive: true });
            fs.writeFileSync(localPath, csvData.body);
            console.log(`Downloaded ${file.name} to ${localPath}`);
        }
    }
}

// ==== Execution Flow ====
(async () => {
    try {
        await uploadFile();
        await convertXlsToCsv();
        await downloadCsvFiles();
        console.log("XLS to CSV conversion completed successfully.");
    } catch (error) {
        console.error("Error during conversion:", error);
    }
})();

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

Μετατροπή XLS σε CSV μέσω Cloud API με cURL

Μπορείτε να εκτελέσετε την ίδια μετατροπή χωρίς να γράψετε κώδικα, χρησιμοποιώντας το cURL για να καλέσετε τα REST endpoints. Η διαδικασία αποτελείται από έλεγχο ταυτότητας, μεταφόρτωση αρχείου, αίτημα μετατροπής και λήψη.

# 1. Get an access token
curl -X POST "https://api.aspose.cloud/connect/token" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET" \
     -H "Content-Type: application/x-www-form-urlencoded"
# Response contains "access_token"

# 2. Upload the XLS file
curl -X PUT "https://api.aspose.cloud/v3.0/barcode/storage/file/sample.xls" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -T "sample.xls"

# 3. Request XLS to CSV conversion
curl -X POST "https://api.aspose.cloud/v3.0/barcode/convert/sample.xls?format=csv&outPath=output" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Download the generated CSV file
curl -X GET "https://api.aspose.cloud/v3.0/barcode/storage/file/output/sample.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -o "sample.csv"

Για περισσότερες λεπτομέρειες σχετικά με τις παραμέτρους του αιτήματος, δείτε την επίσημη τεκμηρίωση API.

Πώς λειτουργεί η μετατροπή XLS σε CSV στο Node.JS

  1. Ρύθμιση Διαμόρφωσης - Ένα αντικείμενο Configuration περιέχει τα διαπιστευτήρια του πελάτη σας και προαιρετικό βασικό URL. Αυτό το αντικείμενο περνάται στην περίπτωση BarcodeApi. 
    const config = new Configuration({ clientId, clientSecret });
const apiInstance = new BarcodeApi(config);
  2. Μεταφόρτωση Αρχείου - Η μέθοδος uploadFile μεταδίδει το τοπικό αρχείο XLS στην αποθήκη cloud του Aspose.BarCode, καθιστώντας το διαθέσιμο για μετατροπή. 
    await apiInstance.uploadFile({ path: inputFile, file: fileData });
  3. Κλήση Μετατροπής - Η convertDocument (υποθετική) στέλνει ένα αίτημα με το όνομα του αρχείου προέλευσης, τον στόχο μορφής (csv) και επιλογές μετατροπής όπως το διαχωριστικό και η κωδικοποίηση. Η υπηρεσία επεξεργάζεται κάθε φύλλο εργασίας και δημιουργεί τα αντίστοιχα αρχεία CSV. 
    const response = await apiInstance.convertDocument({ name: inputFile, format: "csv", options });
  4. Ανάκτηση Αποτελεσμάτων - Μετά τη μετατροπή, η getFilesList εμφανίζει τα παραγόμενα αρχεία CSV στον φάκελο εξόδου. Κάθε αρχείο κατεβάζεται στη συνέχεια με τη downloadFile και αποθηκεύεται τοπικά. 
    const files = await apiInstance.getFilesList({ path: outputFolder });
const csvData = await apiInstance.downloadFile({ path: csvPath });
  5. Διαχείριση Σφαλμάτων - Οποιοδήποτε σφάλμα API συλλαμβάνεται στο μπλοκ catch, όπου μπορείτε να καταγράψετε λεπτομέρειες ή να εφαρμόσετε λογική επανάληψης. Για πλήρη λίστα κωδικών σφαλμάτων, ανατρέξτε στην αναφορά API.

Προετοιμασία Περιβάλλοντος - Προαπαιτούμενα και Ρυθμίσεις

Πριν ξεκινήσετε, βεβαιωθείτε ότι πληρούνται τα παρακάτω προαπαιτούμενα:

  • Node.js 14 ή νεότερο εγκατεστημένο στο μηχάνημά σας για ανάπτυξη.
  • Ένας λογαριασμός Aspose Cloud με έγκυρα διαπιστευτήρια πελάτη (Client ID και Client Secret).
  • Πρόσβαση στο διαδίκτυο για κλήσεις API.

Εγκαταστήστε τη βιβλιοθήκη μέσω npm και συνδέστε τη σελίδα λήψης για αναφορά:

npm install aspose-barcode-cloud
# Download package details: https://releases.aspose.cloud/barcode/nodejs/

Μετά την εγκατάσταση, δημιουργήστε ένα αρχείο διαμόρφωσης (π.χ., config.json) για να αποθηκεύσετε με ασφάλεια τα διαπιστευτήριά σας.

Παράμετροι Μετατροπής: Επιλογές και Ρυθμίσεις

Το API μετατροπής δέχεται αρκετές προαιρετικές παραμέτρους που σας επιτρέπουν να ρυθμίσετε λεπτομερώς την έξοδο:

  • delimiter - Επιλέξτε έναν χαρακτήρα για το διαχωρισμό των πεδίων (προεπιλογή είναι ,).
options.delimiter = "\t"; // Tab‑delimited CSV
  • encoding - Ορίστε την κωδικοποίηση χαρακτήρων για το αρχείο CSV (π.χ., UTF-8, ISO-8859-1).
options.encoding = "UTF-8";
  • outPath - Καθορίστε έναν φάκελο στο cloud όπου θα αποθηκευτούν τα αρχεία CSV.
options.outPath = "converted";
  • storage - Επιλέξτε το όνομα αποθήκευσης εάν χρησιμοποιείτε προσαρμοσμένη υπηρεσία αποθήκευσης.
options.storage = "MyCustomStorage";

Για μια πλήρη λίστα των υποστηριζόμενων επιλογών, δείτε την αναφορά API.

Πρακτικές Συμβουλές για Αποδοτική Μετατροπή XLS σε CSV

  • Ροή Μεγάλων Αρχείων - Ενεργοποιήστε τη λειτουργία ροής για να επεξεργάζεστε τις γραμμές σε τμήματα και να αποφεύγετε την υψηλή κατανάλωση μνήμης.
  • Χρησιμοποιήστε έναν Προσωρινό Φάκελο - Γράψτε ενδιάμεσα αρχεία CSV σε έναν αφιερωμένο φάκελο στο cloud και καθαρίστε τον μετά τη λήψη.
  • Ορίστε Κατάλληλο Διαχωριστικό - Εάν τα δεδομένα σας περιέχουν κόμματα, μεταβείτε σε διαχωριστικό καρτέλας ή σωλήνα για να αποτρέψετε την παραμόρφωση των στηλών.
  • Επικυρώστε Μετά τη Λήψη - Ελέγξτε τις πρώτες λίγες γραμμές του CSV για να διασφαλίσετε τη σωστή κωδικοποίηση και χρήση διαχωριστικού πριν από περαιτέρω επεξεργασία.

Συμπέρασμα

Η μετατροπή XLS σε CSV στο Node.JS γίνεται απλή όταν αξιοποιείτε τις δυνατότητες του Aspose.BarCode Cloud SDK for Node.js. Αυτός ο οδηγός κάλυψε τα πάντα, από τη ρύθμιση του περιβάλλοντος και ένα πλήρες λειτουργικό παράδειγμα έως τις επιλογές διαμόρφωσης και τις βέλτιστες πρακτικές προσανατολισμένες στην απόδοση. Θυμηθείτε να ασφαλίζετε τα διαπιστευτήρια του πελάτη, να επιλέγετε streaming για μεγάλα βιβλία εργασίας και να καθαρίζετε τα προσωρινά αρχεία ώστε η αποθήκευση στο σύννεφο να παραμένει τακτοποιημένη. Για παραγωγικές αναπτύξεις θα χρειαστείτε πληρωμένη άδεια· μπορείτε να ελέγξετε τις τιμές στη σελίδα του προϊόντος και να αποκτήσετε προσωρινή δοκιμαστική άδεια από τη σελίδα προσωρινής άδειας.

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

Πώς η μετατροπή XLS σε CSV στο Node.JS διαχειρίζεται πολλαπλά φύλλα εργασίας;
Η βιβλιοθήκη επεξεργάζεται κάθε φύλλο εργασίας διαδοχικά, δημιουργώντας ένα ξεχωριστό αρχείο CSV για κάθε φύλλο. Μπορείτε να τα συγχωνεύσετε αργότερα εάν απαιτείται ένα ενιαίο CSV. Ανατρέξτε στο Aspose.BarCode Cloud SDK for Node.js για λεπτομερή χρήση.

Μπορώ να μετατρέψω μεγάλα αρχεία XLS σε CSV χωρίς να φορτώνω ολόκληρο το βιβλίο εργασίας στη μνήμη;
Ναι. Ενεργοποιώντας την επιλογή streaming στις παραμέτρους μετατροπής, το API διαβάζει τις γραμμές σε διαχειρίσιμα τμήματα, διατηρώντας τη χρήση μνήμης χαμηλή και την απόδοση υψηλή.

Τι άδεια απαιτείται για τη χρήση του Aspose.BarCode Cloud SDK for Node.js σε παραγωγή;
Απαιτείται εμπορική άδεια για χρήση σε παραγωγή. Οι επιλογές αγοράς αναφέρονται στη σελίδα τιμολόγησης του προϊόντος και μπορείτε να ζητήσετε προσωρινή άδεια αξιολόγησης από τη σελίδα προσωρινής άδειας.

Μπορεί να προσαρμοστεί ο διαχωριστής CSV κατά τη μετατροπή;
Απολύτως. Ορίστε την επιλογή delimiter στις παραμέτρους μετατροπής σε οποιονδήποτε χαρακτήρα χρειάζεστε, όπως μια εσοχή (\t) ή κάθετη γραμμή (|). Αυτό διασφαλίζει ότι το παραγόμενο CSV ταιριάζει με τις προσδοκίες της επεξεργασίας σας.

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