Az Excel adatok CSV formátumba konvertálása gyakori követelmény adatcsővezetékek, jelentéskészítő eszközök vagy import/export funkciók építésekor. Az Aspose.BarCode Cloud SDK for Node.js egy robusztus könyvtárat biztosít, amely egyszerűvé és megbízhatóvá teszi az XLS CSV-re konvertálását Node.JS-ben. Ez az útmutató végigvezet a szükséges előfeltételeken, a telepítési lépéseken, egy teljesen működő példán, valamint a legjobb gyakorlatok tippein, hogy magabiztosan integrálhassa a konverziót alkalmazásába.

Teljesen működő példa az XLS CSV konverzióra Node.JS használatával Aspose.BarCode segítségével

Ez a példa bemutatja, hogyan lehet egy XLS munkafüzetet felhő tárolóból beolvasni, minden munkalapot CSV formátumba konvertálni, és az eredményt vissza streamelni a kliensnek.

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

Megjegyzés: Ez a kódpélda bemutatja az alapvető funkcionalitást. Mielőtt a projektjében használná, győződjön meg róla, hogy frissítette a fájl útvonalakat (sample.xls, output), ellenőrizze, hogy minden szükséges függőség megfelelően telepítve van, és alaposan tesztelje a fejlesztési környezetben. Ha problémákba ütközik, kérjük, tekintse meg a hivatalos dokumentációt vagy lépjen kapcsolatba a támogatási csapattal segítségért.

XLS to CSV Conversion via Cloud API with cURL

Ugyanazt a konverziót kód írása nélkül is elvégezheti a cURL használatával, a REST végpontok meghívásával. A folyamat magában foglalja a hitelesítést, a fájl feltöltését, a konverziós kérést és a letöltést.

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

A kérés paramétereiről további részletekért tekintse meg a hivatalos API dokumentációt.

Hogyan működik az XLS CSV-re konvertálása Node.JS-ben

  1. Konfiguráció beállítása - A Configuration objektum tárolja az ügyfél hitelesítő adatait és az opcionális alap URL-t. Ez az objektum kerül átadásra a BarcodeApi példánynak. 
    const config = new Configuration({ clientId, clientSecret });
const apiInstance = new BarcodeApi(config);
  2. Fájl feltöltés - Az uploadFile metódus streameli a helyi XLS fájlt az Aspose.BarCode felhő tárolóba, így elérhetővé teszi a konvertáláshoz. 
    await apiInstance.uploadFile({ path: inputFile, file: fileData });
  3. Konvertálási hívás - convertDocument (hipotetikus) kérést küld a forrásfájl nevével, a célformátummal (csv) és a konvertálási beállításokkal, mint például a határoló és a kódolás. A szolgáltatás feldolgozza az egyes munkalapokat és létrehozza a megfelelő CSV fájlokat. 
    const response = await apiInstance.convertDocument({ name: inputFile, format: "csv", options });
  4. Eredmény lekérése - A konvertálás után a getFilesList felsorolja a kimeneti mappában létrehozott CSV fájlokat. Minden fájlt ezután a downloadFile segítségével letöltenek és helyileg mentenek. 
    const files = await apiInstance.getFilesList({ path: outputFolder });
const csvData = await apiInstance.downloadFile({ path: csvPath });
  5. Hiba kezelés - Bármely API hiba elkapásra kerül a catch blokkban, ahol naplózhatja a részleteket vagy megvalósíthatja az újrapróbálkozási logikát. A hibakódok teljes listájáért tekintse meg az API referenciát.

Környezet előkészítése - Előfeltételek és beállítás

Mielőtt elkezdené, győződjön meg arról, hogy a következő előfeltételek teljesülnek:

  • Node.js 14 vagy újabb telepítve a fejlesztői gépére.
  • Érvényes ügyfélhitelesítő adatokkal (Client ID és Client Secret) rendelkező Aspose Cloud fiók.
  • Internet-hozzáférés az API hívásokhoz.

Telepítse a könyvtárat npm‑vel, és hivatkozzon a letöltési oldalra referenciaként:

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

A telepítés után hozzon létre egy konfigurációs fájlt (például config.json), hogy biztonságosan tárolja hitelesítő adatait.

Konverziós paraméterek: Opciók és beállítások

A konverziós API több opcionális paramétert fogad el, amelyek lehetővé teszik a kimenet finomhangolását.

  • delimiter - Válasszon egy karaktert a mezők elválasztásához (alapértelmezett a ,).
options.delimiter = "\t"; // Tab‑delimited CSV
  • encoding - Határozza meg a CSV-fájl karakterkódolását (például UTF-8, ISO-8859-1).
options.encoding = "UTF-8";
  • outPath - Adja meg a felhőmappát, ahol a CSV-fájlok tárolva lesznek.
options.outPath = "converted";
  • storage - Válassza ki a tároló nevét, ha egy egyéni tárolószolgáltatást használ.
options.storage = "MyCustomStorage";

A támogatott beállítások teljes listájáért lásd az API referenciát.

Hatékony XLS → CSV konvertáláshoz gyakorlati tippek

  • Nagy fájlok streamelése - Engedélyezze a streaming módot, hogy a sorokat darabokban dolgozza fel, és elkerülje a magas memóriahasználatot.
  • Ideiglenes mappa használata - Írja az köztes CSV fájlokat egy dedikált felhőmappába, és a letöltés után tisztítsa meg azt.
  • Megfelelő elválasztó beállítása - Ha az adatok vesszőket tartalmaznak, válasszon tabulátor vagy csővezeték (pipe) elválasztót a oszlopok helytelen igazodásának elkerülése érdekében.
  • Letöltés utáni ellenőrzés - Ellenőrizze a CSV első néhány sorát, hogy biztosítsa a helyes kódolást és az elválasztó megfelelő használatát a további feldolgozás előtt.

Következtetés

Az XLS CSV-re konvertálása Node.JS-ben egyszerűvé válik, ha kihasználja az Aspose.BarCode Cloud SDK for Node.js képességeit. Ez az útmutató mindent lefedett a környezet beállításától és egy teljes működő példától a konfigurációs beállításokig és a teljesítmény‑orientált legjobb gyakorlatokig. Ne feledje, hogy biztonságban tartsa ügyfél hitelesítő adatait, nagy munkafüzetek esetén válassza a streaminget, és tisztítsa meg az ideiglenes fájlokat, hogy felhő tárolója rendezett maradjon. A termelési környezetben fizetett licencre lesz szüksége; az árakat megtekintheti a termékoldalon, és ideiglenes értékelő licencet szerezhet a ideiglenes licenc oldal.

GYIK

Hogyan kezeli az XLS CSV-re konvertálás Node.JS-ben a több munkalapot?
A könyvtár sorban feldolgozza az egyes munkalapokat, minden laphoz külön CSV fájlt generál. Később összevonhatja őket, ha egyetlen CSV fájlra van szükség. Részletes használathoz tekintse meg a Aspose.BarCode Cloud SDK for Node.js oldalt.

Streamelhetek nagy XLS fájlokat CSV-re anélkül, hogy betölteném az egész munkafüzetet a memóriába?
Igen. A konverziós paraméterekben a streaming opció engedélyezésével az API a sorokat kezelhető darabokban olvassa, így alacsony memóriahasználatot és magas teljesítményt biztosít.

Milyen licenc szükséges az Aspose.BarCode Cloud SDK for Node.js használatához termelésben?
A termelési használathoz kereskedelmi licenc szükséges. A vásárlási lehetőségek a termék árazási oldalán vannak felsorolva, és kérhet ideiglenes értékelő licencet a ideiglenes licenc oldal.

Lehetőség van a CSV elválasztó testreszabására a konverzió során?
Természetesen. Állítsa be a delimiter opciót a konverziós paraméterekben a kívánt karakterre, például egy tabulátorra (\t) vagy egy csővezeték karakterre (|). Ez biztosítja, hogy a generált CSV megfeleljen az utófeldolgozási elvárásoknak.

További információk