המרת CSV ל‑Excel XLSX ב‑Node.JS

המרת נתוני CSV ל‑חוברת XLSX מודרנית היא דרישה נפוצה ליישומי Node.JS שצריכים ליצור דוחות Excel מבלי להסתמך על Microsoft Excel עצמו. Aspose.HTML Cloud SDK for Node.JS מספק API חזק שמטפל בהמרה כולה בענן. במדריך זה תראו דוגמת קוד מלאה, תלמדו כיצד לקרוא ל‑REST API באמצעות cURL, ותבינו את שלבי ההגדרה הדרושים להפעלת המרת CSV ל‑Excel XLSX ב‑Node.JS ביעילות.

דוגמת קוד מלאה: המרת CSV ל‑Excel XLSX ב‑Node.JS

דוגמה זו מדגימה כיצד להמיר קובץ CSV למחברת XLSX באמצעות Aspose.HTML Cloud SDK for Node.JS.

const fs = require('fs');
const path = require('path');
const {
    HtmlApi,
    Configuration,
    UploadFileRequest,
    DownloadFileRequest,
    ConvertDocumentRequest,
    DeleteFileRequest
} = require('@asposecloud/aspose-html-cloud');

// Replace with your actual Aspose Cloud credentials
const config = new Configuration({
    clientId: 'YOUR_CLIENT_ID',
    clientSecret: 'YOUR_CLIENT_SECRET'
});

const htmlApi = new HtmlApi(config);

async function convertCsvToXlsx() {
    const localCsvPath = path.resolve(__dirname, 'input.csv');
    const localXlsxPath = path.resolve(__dirname, 'output.xlsx');

const remoteCsvPath = 'input.csv';
    const remoteXlsxPath = 'output.xlsx';

try {
        // Upload CSV using a read stream (efficient for large files)
        const uploadStream = fs.createReadStream(localCsvPath);
        await htmlApi.uploadFile(new UploadFileRequest({
            path: remoteCsvPath,
            file: uploadStream
        }));

// Convert CSV to XLSX
        await htmlApi.convertDocument(new ConvertDocumentRequest({
            inputPath: remoteCsvPath,
            outputPath: remoteXlsxPath,
            format: 'xlsx'
        }));

// Download the resulting XLSX file
        const downloadResponse = await htmlApi.downloadFile(new DownloadFileRequest({
            path: remoteXlsxPath
        }));
        const writeStream = fs.createWriteStream(localXlsxPath);
        await new Promise((resolve, reject) => {
            downloadResponse.body.pipe(writeStream);
            downloadResponse.body.on('end', resolve);
            downloadResponse.body.on('error', reject);
        });

console.log('Conversion completed successfully.');
    } catch (error) {
        console.error('Error during conversion:', error);
    } finally {
        // Cleanup remote files
        try {
            await htmlApi.deleteFile(new DeleteFileRequest({ path: remoteCsvPath }));
            await htmlApi.deleteFile(new DeleteFileRequest({ path: remoteXlsxPath }));
        } catch (cleanupError) {
            // Ignore cleanup errors
        }
    }
}

convertCsvToXlsx();

הערה: דוגמת קוד זו מדגימה את הפונקציונליות המרכזית. לפני השימוש בו בפרויקט שלך, ודא לעדכן את נתיבי הקבצים (input.csv, output.xlsx, וכו’) כך שיתאימו למיקומי הקבצים האמיתיים שלך, אמת שכל התלויות הדרושות מותקנות כראוי, ובצע בדיקות מקיפות בסביבת הפיתוח שלך. אם אתה נתקל בבעיות, אנא פנה לתיעוד הרשמי או פנה לצוות תמיכה לקבלת סיוע.

המרת CSV ל‑XLSX עם cURL ו‑REST API

אם אתה מעדיף גישה ישירה באמצעות REST, ניתן לבצע את ההמרה באותו אופן עם פקודות cURL. השלבים למטה מראים כיצד לקבל אסימון גישה, להעלות את קובץ ה‑CSV, להפעיל את ההמרה ולהוריד את קובץ ה‑XLSX.

# 1. Get an access token
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"

# 2. Upload the source CSV file
curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/csv" \
     --data-binary @input.csv

# 3. Convert CSV to XLSX
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=xlsx&outPath=output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"inputPath":"input.csv"}'

# 4. Download the generated XLSX file
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx


לפרטים נוספים על פרמטרי הבקשה ואפשרויות נוספות, ראו את [תיעוד ה-API הרשמי](https://reference.aspose.cloud/html/).

## פירוק המרת CSV ל‑Excel ב‑Node.JS

הבנת האופן שבו הקוד מבצע המרת CSV ל‑Excel בפורמט XLSX ב‑Node.JS מסייעת לכם להתאים את התהליך לפרויקטים שלכם.

1. **הגדרת תצורה** – המחלקה `Configuration` מאחסנת את `clientId` ו‑`clientSecret` שלכם.  
   <!--[CODE_SNIPPET_START]-->
   ```javascript
   const [config](https://docs.fileformat.com/programming/config/) = new Configuration({
       clientId: 'YOUR_CLIENT_ID',
       clientSecret: 'YOUR_CLIENT_SECRET'
   });

אתחול API – HtmlApi נוצר עם התצורה כדי לגשת לכל נקודות הקצה של ההמרה.
```
const htmlApi = new HtmlApi(config);
```

העלאת ה‑CSV – זרם קריאה (fs.createReadStream) מעלה את הקובץ בצורה יעילה, דבר החשוב לקבצי CSV גדולים.

const uploadStream = fs.createReadStream(localCsvPath);
await htmlApi.uploadFile(new UploadFileRequest({
    path: remoteCsvPath,
    file: uploadStream
}));

ביצוע ההמרה – convertDocument נקרא עם format: 'xlsx' כדי לבצע את המרת CSV ל‑Excel בפורמט XLSX.

await htmlApi.convertDocument(new ConvertDocumentRequest({
    inputPath: remoteCsvPath,
    outputPath: remoteXlsxPath,
    format: 'xlsx'
}));

הורדת התוצאה – ה‑SDK משדר את קובץ ה‑XLSX שנוצר חזרה למערכת הקבצים המקומית.

const downloadResponse = await htmlApi.downloadFile(new DownloadFileRequest({
    path: remoteXlsxPath
}));
const writeStream = fs.createWriteStream(localXlsxPath);
await new Promise((resolve, reject) => {
    downloadResponse.body.pipe(writeStream);
    downloadResponse.body.on('end', resolve);
    downloadResponse.body.on('error', reject);
});

שלבים אלה מדגימים את זרימת הקצה‑לקצה של המרת CSV ל‑Excel בפורמט XLSX ב‑Node.JS באמצעות Aspose.HTML Cloud SDK.

דרישות מוקדמות והגדרה - התקנת Aspose.HTML Cloud SDK עבור Node.JS

Runtime של Node.js – ודאו שיש לכם Node.js גרסה 14 או גבוהה יותר מותקנת.
התקנת ה‑SDK – הריצו את פקודת npm הבאה (כתובת ההורדה: https://releases.aspose.cloud/html/nodejs/).
```
npm install @asposecloud/aspose-html-cloud --save
```
הגדרת אישורים - צרו קובץ תצורה .asposecloud או הגדרו משתני סביבה עם clientId ו‑clientSecret שלכם שהושגו מלוח המחוונים של Aspose Cloud.
אימות ההתקנה - הריצו node -e "require('@asposecloud/aspose-html-cloud')" כדי לאשר שהחבילה נטענת ללא שגיאות.

לאחר שה‑SDK מותקן והאישורים מוגדרים, אתם מוכנים להריץ את קוד ההמרה.

סיכום

מדריך זה הוביל אתכם דרך המרת CSV ל‑Excel בפורמט XLSX ב‑Node.JS באמצעות Aspose.HTML Cloud SDK עבור Node.JS. ראיתם דוגמה מלאה עובדת, למדתם כיצד לבצע את אותה משימה עם cURL, והגדרתם את ה‑SDK במכונת הפיתוח שלכם. הספרייה מבטלת את הצורך ב‑Microsoft Excel על השרת, מה שהופך יצירת דוחות בקנה מידה גדול לקלה וקלה לתחזוקה. לשימוש בייצור, רכשו רישיון מסחרי או השתמשו ברישיון זמני מה-דף הרישיון הזמני כדי להישאר תואמים.

שאלות נפוצות

אילו פורמטים של קבצים נתמכים להמרה בנוסף ל‑CSV ול‑XLSX?
Aspose.HTML תומכת במגוון רחב של פורמטים כולל HTML, PDF, DOCX, ו‑PPTX. עיינו ב-תיעוד המוצר לקבלת הרשימה המלאה.
איך ניתן להמיר מספר קבצי CSV בריצה אחת?
עברו על רשימת הקבצים שלכם, וקראו לפעולות העלאה, המרה והורדה עבור כל קובץ. גישת ה‑streaming של ה‑SDK עובדת היטב לעיבוד באצוות.
האם ניתן להתאים אישית את פלט ה‑Excel (למשל, רוחב עמודות, סגנונות)?
ההמרה הבסיסית יוצרת חוברת עבודה סטנדרטית. לעיצוב מתקדם, ניתן לבצע post‑processing של קובץ ה‑XLSX באמצעות Aspose.Cells Cloud לאחר ההמרה.
היכן ניתן למצוא פרטי תמחור עבור Aspose.HTML Cloud SDK?
מידע על תמחור זמין באתר Aspose. ניתן גם להתחיל ברישיון זמני להערכת המוצר לפני רכישת מנוי מלא.

דוגמת קוד מלאה: המרת CSV ל‑Excel XLSX ב‑Node.JS#

המרת CSV ל‑XLSX עם cURL ו‑REST API#

דרישות מוקדמות והגדרה - התקנת Aspose.HTML Cloud SDK עבור Node.JS#

סיכום#

שאלות נפוצות#

קראו עוד#

דוגמת קוד מלאה: המרת CSV ל‑Excel XLSX ב‑Node.JS

המרת CSV ל‑XLSX עם cURL ו‑REST API

דרישות מוקדמות והגדרה - התקנת Aspose.HTML Cloud SDK עבור Node.JS

סיכום

שאלות נפוצות

קראו עוד