تبدیل CSV به Excel XLSX در Node.JS

تبدیل داده‌های CSV به یک کتاب‌کار XLSX مدرن، یک نیاز رایج برای برنامه‌های Node.JS است که باید گزارش‌های Excel را بدون وابستگی به خود Microsoft Excel تولید کنند. Aspose.HTML Cloud SDK for Node.JS یک API قدرتمند ارائه می‌دهد که تبدیل را به‌صورت کامل در ابر انجام می‌دهد. در این راهنما، یک مثال کامل کد را خواهید دید، یاد می‌گیرید چگونه با cURL API REST را فراخوانی کنید و مراحل تنظیم مورد نیاز برای اجرای تبدیل 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

<!--[CODE_SNIPPET_END]-->

For more details on request parameters and additional options, see the [official API documentation](https://reference.aspose.cloud/html/).

## Breaking Down CSV to Excel Conversion in Node.JS

Understanding how the code achieves CSV to Excel XLSX conversion in Node.JS helps you customize the process for your own projects.

1. **Configuration Setup** – The `Configuration` class stores your `clientId` and `clientSecret`.  
   <!--[CODE_SNIPPET_START]-->
   ```javascript
   const [config](https://docs.fileformat.com/programming/config/) = new Configuration({
       clientId: 'YOUR_CLIENT_ID',
       clientSecret: 'YOUR_CLIENT_SECRET'
   });

API Initialization – HtmlApi is instantiated with the configuration to access all conversion endpoints.
```
const htmlApi = new HtmlApi(config);
```

Uploading the CSV – A read stream (fs.createReadStream) uploads the file efficiently, which is crucial for large CSV files.

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

Executing the Conversion – convertDocument is called with format: 'xlsx' to perform the CSV to Excel XLSX conversion.

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

Downloading the Result – The SDK streams the generated XLSX back to the local file system.

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

These steps illustrate the end‑to‑end flow of CSV to Excel XLSX conversion in Node.JS using the Aspose.HTML Cloud SDK.

Prerequisites and Setup - Installing Aspose.HTML Cloud SDK for Node.JS

Node.js Runtime – Ensure you have Node.js 14 or higher installed.
Install the SDK – Run the following npm command (download URL: https://releases.aspose.cloud/html/nodejs/).
```
npm install @asposecloud/aspose-html-cloud --save
```
Configure Credentials - Create a .asposecloud configuration file or set environment variables with your clientId and clientSecret obtained from the Aspose Cloud dashboard.
Verify Installation - Execute node -e "require('@asposecloud/aspose-html-cloud')" to confirm the package loads without errors.

With the SDK installed and credentials configured, you are ready to run the conversion code.

Conclusion

This guide walked you through CSV to Excel XLSX conversion in Node.JS using Aspose.HTML Cloud SDK for Node.JS. You saw a complete working example, learned how to perform the same task with cURL, and set up the SDK on your development machine. The library eliminates the need for Microsoft Excel on the server, making large‑scale report generation lightweight and reliable. For production use, acquire a commercial license or use a temporary license from the temporary license page to stay compliant.

FAQs

What file formats are supported for conversion besides CSV and XLSX?
Aspose.HTML supports a wide range of formats including HTML, PDF, DOCX, and PPTX. Refer to the product documentation for the full list.
How can I convert multiple CSV files in a single run?
Loop through your file list, calling the upload, convert, and download steps for each file. The SDK’s streaming approach works well for batch processing.
Is it possible to customize the Excel output (e.g., column widths, styles)?
The basic conversion creates a standard workbook. For advanced styling, you can post‑process the XLSX using Aspose.Cells Cloud after conversion.
Where can I find pricing details for the Aspose.HTML Cloud SDK?
Pricing information is available on the Aspose website. You can also start with a temporary license for evaluation before purchasing a full subscription.

مثال کامل کد: تبدیل CSV به Excel XLSX در Node.JS#

تبدیل CSV به XLSX با cURL و REST API#

Prerequisites and Setup - Installing Aspose.HTML Cloud SDK for Node.JS#

Conclusion#

FAQs#

Read More#

مثال کامل کد: تبدیل CSV به Excel XLSX در Node.JS

تبدیل CSV به XLSX با cURL و REST API

Prerequisites and Setup - Installing Aspose.HTML Cloud SDK for Node.JS

Conclusion

FAQs

Read More