המרת נתוני Excel ל-CSV היא דרישה נפוצה בעת בניית צינורות נתונים, כלי דיווח או תכונות ייבוא/ייצוא. Aspose.BarCode Cloud SDK for Node.js מספקת ספרייה חזקה שמפשטת ומבטיחה המרה מ-XLS ל‑CSV ב‑Node.JS. מדריך זה מוביל אותך דרך דרישות קדם, שלבי ההתקנה, דוגמה מלאה עובדת, וטיפים של שיטות מיטביות כדי שתוכל לשלב את ההמרה באפליקציה שלך בביטחון.

דוגמה מלאה עובדת להמרת XLS ל‑CSV ב‑Node.JS באמצעות Aspose.BarCode

דוגמה זו מציגה כיצד לקרוא חוברת עבודה של XLS מאחסון ענן, להמיר כל גיליון עבודה ל‑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. התהליך כולל אימות, העלאת קובץ, בקשת המרה והורדה.

# 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 המקומי לאחסון הענן של 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 reference.

הכנת סביבת העבודה - דרישות מוקדמות והגדרה

לפני שתתחיל, ודא שהדרישות המוקדמות הבאות מתקיימות.

  • 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 - ציין תיקיית ענן שבה יאוחסנו קבצי ה‑CSV. 
    options.outPath = "converted";
  • storage - בחר את שם האחסון אם אתה משתמש בשירות אחסון מותאם. 
    options.storage = "MyCustomStorage";

לרשימה מלאה של האפשרויות הנתמכות, ראה את תיעוד API.

טיפים פרקטיים להמרה יעילה מ‑XLS ל‑CSV

  • הזרמת קבצים גדולים - הפעל מצב הזרמה כדי לעבד שורות בחלקים ולמנוע צריכת זיכרון גבוהה.
  • שימוש בתיקייה זמנית - כתוב קבצי CSV ביניים בתיקייה ייעודית בענן ונקה אותה לאחר ההורדה.
  • הגדרת מפריד מתאים - אם הנתונים שלך מכילים פסיקים, עבור למפריד של טאב או קו אנכי כדי למנוע חוסר התאמה בעמודות.
  • אימות לאחר ההורדה - בדוק את השורות הראשונות של קובץ ה‑CSV כדי לוודא קידוד נכון ושימוש במפריד לפני המשך העיבוד.

סיכום

המרת XLS ל‑CSV ב‑Node.JS הופכת לפשוטה כאשר אתה מנצל את היכולות של Aspose.BarCode Cloud SDK for Node.js. מדריך זה כיסה את כל מה שצריך, מהגדרת הסביבה ודוגמה מלאה עובדת ועד אפשרויות תצורה ושיטות מיטביות למיקוד ביצועים. זכור לאבטח את אישורי הלקוח שלך, לבחור ב‑streaming עבור חוברות עבודה גדולות, ולנקות קבצים זמניים כדי לשמור על אחסון הענן שלך מסודר. בפריסות ייצור תזדקק לרישיון בתשלום; אתה יכול לעיין בתמחור בעמוד המוצר ולקבל רישיון הערכה זמני מה-דף רישיון זמני.

FAQs

כיצד המרת XLS ל‑CSV ב‑Node.JS מתמודדת עם גיליונות מרובים?
הספרייה מעבדת כל גיליון באופן רציף, ויוצרת קובץ CSV נפרד עבור כל גיליון. ניתן למזג אותם מאוחר יותר אם נדרש קובץ CSV יחיד. עיין ב‑Aspose.BarCode Cloud SDK for Node.js לקבלת פרטים נוספים.

האם אני יכול להזרים קבצי XLS גדולים ל‑CSV מבלי לטעון את כל חוברת העבודה בזיכרון?
כן. על‑ידי הפעלת אפשרות ההזרמה בפרמטרי ההמרה, ה‑API קורא שורות בחלקים ניתנים לניהול, מה שמחזיק את השימוש בזיכרון נמוך ואת הביצועים גבוהים.

איזו רישיון נדרש לשימוש ב‑Aspose.BarCode Cloud SDK עבור Node.js בייצור?
רישיון מסחרי נדרש לשימוש בייצור. אפשרויות הרכישה מפורטות בעמוד תמחור המוצר, וניתן לבקש רישיון הערכה זמני מדף דף הרישיון הזמני.

האם ניתן להתאים אישית את המפריד של CSV במהלך ההמרה?
בהחלט. הגדר את האפשרות delimiter בפרמטרי ההמרה לכל תו שאתה צריך, כגון טאב (\t) או קו אנכי (|). זה מבטיח שה‑CSV שנוצר יתאים לציפיות העיבוד שלך.

קרא עוד