Das Konvertieren von Excel‑Daten in CSV ist eine häufige Anforderung beim Aufbau von Datenpipelines, Reporting‑Tools oder Import/Export‑Funktionen. Aspose.BarCode Cloud SDK for Node.js bietet eine robuste Bibliothek, die die Konvertierung von XLS zu CSV in Node.JS einfach und zuverlässig macht. Dieser Leitfaden führt Sie durch die Voraussetzungen, Installationsschritte, ein vollständiges funktionierendes Beispiel und bewährte Tipps, damit Sie die Konvertierung mit Vertrauen in Ihre Anwendung integrieren können.

Vollständiges funktionierendes Beispiel für die XLS‑zu‑CSV‑Konvertierung in Node.JS mit Aspose.BarCode

Dieses Beispiel zeigt, wie man eine XLS‑Arbeitsmappe aus dem Cloud‑Speicher liest, jedes Arbeitsblatt in CSV konvertiert und das Ergebnis zum Client streamt.

// 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);
    }
})();

Hinweis: Dieses Codebeispiel demonstriert die Kernfunktionalität. Bevor Sie es in Ihrem Projekt verwenden, stellen Sie sicher, dass Sie die Dateipfade (sample.xls, output) aktualisieren, dass alle erforderlichen Abhängigkeiten korrekt installiert sind und testen Sie gründlich in Ihrer Entwicklungsumgebung. Wenn Sie auf Probleme stoßen, lesen Sie bitte die offizielle Dokumentation oder wenden Sie sich an das Support-Team für Unterstützung.

XLS zu CSV-Konvertierung über Cloud-API mit cURL

Sie können dieselbe Konvertierung ohne Code zu schreiben durchführen, indem Sie cURL verwenden, um die REST-Endpunkte aufzurufen. Der Ablauf besteht aus Authentifizierung, Datei‑Upload, Konvertierungsanfrage und Download.

# 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"

Weitere Details zu den Anfrageparametern finden Sie in der offiziellen API-Dokumentation.

Wie die XLS-zu-CSV-Konvertierung in Node.JS funktioniert

  1. Konfiguration einrichten - Ein Configuration-Objekt enthält Ihre Client-Anmeldeinformationen und optional die Basis-URL. Dieses Objekt wird an die BarcodeApi-Instanz übergeben. 
    const config = new Configuration({ clientId, clientSecret });
const apiInstance = new BarcodeApi(config);
  2. Datei-Upload - Die Methode uploadFile streamt die lokale XLS-Datei in den Aspose.BarCode-Cloud-Speicher, wodurch sie für die Konvertierung verfügbar wird. 
    await apiInstance.uploadFile({ path: inputFile, file: fileData });
  3. Konvertierungsaufruf - convertDocument (hypothetisch) sendet eine Anfrage mit dem Quelldateinamen, dem Zielformat (csv) und Konvertierungsoptionen wie Trennzeichen und Kodierung. Der Dienst verarbeitet jedes Arbeitsblatt und erstellt entsprechende CSV-Dateien. 
    const response = await apiInstance.convertDocument({ name: inputFile, format: "csv", options });
  4. Ergebnisabruf - Nach der Konvertierung listet getFilesList die erzeugten CSV-Dateien im Ausgabeverzeichnis auf. Jede Datei wird dann mit downloadFile heruntergeladen und lokal gespeichert. 
    const files = await apiInstance.getFilesList({ path: outputFolder });
const csvData = await apiInstance.downloadFile({ path: csvPath });
  5. Fehlerbehandlung - Jeder API-Fehler wird im catch-Block abgefangen, wo Sie Details protokollieren oder eine Wiederholungslogik implementieren können. Für eine vollständige Liste der Fehlercodes siehe die API-Referenz.

Umgebungsvorbereitung - Voraussetzungen und Einrichtung

Bevor Sie beginnen, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

  • Node.js 14 oder höher auf Ihrem Entwicklungsrechner installiert.
  • Ein Aspose Cloud‑Konto mit gültigen Client‑Anmeldeinformationen (Client ID und Client Secret).
  • Zugriff auf das Internet für API‑Aufrufe.

Installieren Sie die Bibliothek über npm und verlinken Sie die Download‑Seite zum Nachschlagen:

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

Nach der Installation erstellen Sie eine Konfigurationsdatei (z. B. config.json), um Ihre Anmeldeinformationen sicher zu speichern.

Konvertierungsparameter: Optionen und Einstellungen

Die Konvertierungs‑API akzeptiert mehrere optionale Parameter, die es Ihnen ermöglichen, die Ausgabe fein abzustimmen:

  • delimiter – Wählen Sie ein Zeichen, um Felder zu trennen (Standard ist ,). 
    options.delimiter = "\t"; // Tab‑delimited CSV
  • encoding – Definieren Sie die Zeichenkodierung für die CSV‑Datei (z. B. UTF-8, ISO-8859-1). 
    options.encoding = "UTF-8";
  • outPath – Geben Sie einen Cloud‑Ordner an, in dem die CSV‑Dateien gespeichert werden. 
    options.outPath = "converted";
  • storage – Wählen Sie den Speichernamen, wenn Sie einen benutzerdefinierten Speicherdienst verwenden. 
    options.storage = "MyCustomStorage";

Für eine vollständige Liste der unterstützten Optionen siehe die API‑Referenz.

Praktische Tipps für effiziente XLS-zu-CSV-Konvertierung

  • Große Dateien streamen - Aktivieren Sie den Streaming‑Modus, um Zeilen in Blöcken zu verarbeiten und hohen Speicherverbrauch zu vermeiden.
  • Verwenden Sie einen temporären Ordner - Schreiben Sie Zwischendateien im CSV‑Format in einen dedizierten Cloud‑Ordner und löschen Sie ihn nach dem Download.
  • Setzen Sie ein geeignetes Trennzeichen - Wenn Ihre Daten Kommas enthalten, wechseln Sie zu einem Tabulator‑ oder Pipe‑Trennzeichen, um eine Fehlinterpretation der Spalten zu vermeiden.
  • Nach dem Download validieren - Überprüfen Sie die ersten Zeilen der CSV, um sicherzustellen, dass die Kodierung und das Trennzeichen korrekt sind, bevor Sie weiterverarbeiten.

Fazit

Die XLS‑zu‑CSV‑Konvertierung in Node.JS wird unkompliziert, wenn Sie die Fähigkeiten des Aspose.BarCode Cloud SDK for Node.js nutzen. Dieser Leitfaden behandelte alles von der Einrichtung der Umgebung und einem vollständigen Beispiel bis hin zu Konfigurationsoptionen und leistungsorientierten Best Practices. Denken Sie daran, Ihre Client‑Anmeldeinformationen zu sichern, für große Arbeitsmappen Streaming zu wählen und temporäre Dateien zu bereinigen, um Ihren Cloud‑Speicher ordentlich zu halten. Für Produktionsbereitstellungen benötigen Sie eine kostenpflichtige Lizenz; Sie können die Preise auf der Produktseite einsehen und eine temporäre Evaluierungslizenz von der temporären Lizenzseite erhalten.

FAQs

Wie behandelt die XLS-zu-CSV-Konvertierung in Node.JS mehrere Arbeitsblätter?
Die Bibliothek verarbeitet jedes Arbeitsblatt nacheinander und erzeugt für jedes Blatt eine separate CSV-Datei. Sie können diese später zusammenführen, falls eine einzige CSV-Datei benötigt wird. Weitere Details finden Sie in der Aspose.BarCode Cloud SDK for Node.js.

Kann ich große XLS-Dateien in CSV streamen, ohne die gesamte Arbeitsmappe in den Speicher zu laden?
Ja. Durch Aktivieren der Streaming-Option in den Konvertierungsparametern liest die API Zeilen in handhabbaren Abschnitten, wodurch der Speicherverbrauch gering und die Leistung hoch bleibt.

Welches Lizenzmodell ist für die Verwendung von Aspose.BarCode Cloud SDK für Node.js in der Produktion erforderlich?
Für die Produktion ist eine kommerzielle Lizenz erforderlich. Kaufoptionen sind auf der Produktpreisseite aufgeführt, und Sie können eine temporäre Evaluierungslizenz von der temporären Lizenzseite anfordern.

Ist es möglich, das CSV‑Trennzeichen während der Konvertierung anzupassen?
Absolut. Setzen Sie die Option delimiter in den Konvertierungsparametern auf jedes gewünschte Zeichen, z. B. einen Tab (\t) oder ein Pipe‑Zeichen (|). Dadurch wird sichergestellt, dass das erzeugte CSV Ihren nachgelagerten Verarbeitungserwartungen entspricht.

Mehr lesen