تبدیل CSV به TXT در Node.JS

تبدیل داده‌های صفحه‌گسترده به متن ساده یک نیاز مکرر است وقتی می‌خواهید اطلاعات را به سیستم‌های قدیمی یا تجزیه‌کننده‌های ساده منتقل کنید. Aspose.Cells Cloud SDK for Node.js کتابخانه قدرتمندی را فراهم می‌کند که کارهای سنگین را در سمت سرور انجام می‌دهد. در این راهنما شما یک مثال کامل عملی، یک جریان کاری cURL برای REST API، مراحل نصب، گزینه‌های پیکربندی و نکات بهترین روش را خواهید دید تا تبدیل CSV به TXT در Node.JS به‌صورت بدون دردسر و قابل اعتماد باشد.

مثال کامل کارآمد برای CSV به TXT در Node.JS

این مثال نشان می‌دهد که چگونه می‌توان Cells API را فراخوانی کرد و فایل TXT تبدیل‌شده را به‌صورت محلی ذخیره کرد.

const fs = require('fs');
const path = require('path');
const { CellsApi, ApiClient } = require('@aspose/cells-cloud');

async function convertCsvToTxt() {
    // Aspose Cloud authentication
    const clientId = 'YOUR_CLIENT_ID';
    const clientSecret = 'YOUR_CLIENT_SECRET';
    const config = new ApiClient();
    config.clientId = clientId;
    config.clientSecret = clientSecret;
    config.basePath = 'https://api.aspose.cloud';

const cellsApi = new CellsApi(config);

// File paths
    const inputFile = path.resolve(__dirname, 'input.csv');
    const outputFile = path.resolve(__dirname, 'output.txt');

// Prepare request
    const fileStream = fs.createReadStream(inputFile);
    const request = {
        file: fileStream,
        format: 'txt' // target format
    };

try {
        // Convert CSV to TXT
        const response = await cellsApi.postConvertWorkbook(request);
        // response.body is a Buffer containing the TXT data
        fs.writeFileSync(outputFile, response.body);
        console.log(`Conversion completed. TXT saved to ${outputFile}`);
    } catch (err) {
        console.error('Conversion failed:', err);
    }
}

convertCsvToTxt();

توجه: این مثال کد عملکرد اصلی را نشان می‌دهد. قبل از استفاده از آن در پروژه خود، اطمینان حاصل کنید که مسیرهای فایل و مقادیر پیکربندی را به‌گونه‌ای به‌روزرسانی کنید که با محیط واقعی شما مطابقت داشته باشد، بررسی کنید که تمام وابستگی‌های مورد نیاز به‌درستی نصب شده‌اند و به‌طور کامل در محیط توسعه خود تست کنید. اگر با مشکلی مواجه شدید، لطفاً به مستندات رسمی یا برای دریافت کمک با تیم پشتیبانی تماس بگیرید.

تجزیه CSV به TXT در Node.JS

کد در چند گام منطقی کار می‌کند:

راه‌اندازی کلاینت API - new ApiClient() با اعتبارنامه‌های شما و URL پایه پیکربندی می‌شود.

const config = new ApiClient();
config.clientId = clientId;
config.clientSecret = clientSecret;
config.basePath = 'https://api.aspose.cloud';

یک نمونه CellsApi ایجاد کنید - این شیء متد تبدیل را در دسترس قرار می‌دهد.

const cellsApi = new CellsApi(config);

فایل CSV را به‌صورت جریان بخوانید - fs.createReadStream داده‌های باینری مورد نیاز API را فراهم می‌کند.

const fileStream = fs.createReadStream(inputFile);

ساخت شیء درخواست - ویژگی format به سرویس می‌گوید که خروجی TXT باشد.

const request = {
    file: fileStream,
    format: 'txt'
};

Call postConvertWorkbook - API یک Buffer حاوی متن تبدیل‌شده برمی‌گرداند که سپس در دیسک نوشته می‌شود.

const response = await cellsApi.postConvertWorkbook(request);
fs.writeFileSync(outputFile, response.body);

درک هر بخش به شما کمک می‌کند تا جریان را سفارشی‌سازی کنید، مانند افزودن مدیریت خطا یا پردازش چندین فایل.

آماده‌سازی محیط

SDK را با npm نصب کنید:

npm install asposecellscloud

اطمینان حاصل کنید که Node.js 14 یا نسخهٔ بالاتر نصب شده است.
اگر نصب دستی را ترجیح می‌دهید، آخرین بسته را از صفحهٔ رسمی انتشار دانلود کنید: Aspose.Cells Cloud SDK for Node.js دانلود.
برای دریافت client ID و client secret یک حساب رایگان Aspose Cloud ایجاد کنید.

با برآورده شدن این پیش‌نیازها، می‌توانید اسکریپت تبدیل را بلافاصله اجرا کنید.

تبدیل CSV به TXT با استفاده از cURL و REST API

می‌توانید همان نتیجه را بدون نوشتن هیچ کدی با فراخوانی مستقیم نقاط انتهایی REST سرویس Aspose.Cells Cloud به دست آورید.

دریافت توکن دسترسی - اعتبارهای مشتری خود را برای یک JWT تعویض کنید.

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"

بارگذاری فایل CSV منبع به ذخیره‌سازی.

curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/input.csv" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: text/csv" \
  --data-binary @input.csv

درخواست تبدیل به فرمت TXT.

curl -X POST "https://api.aspose.cloud/v3.0/cells/convert?format=txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@input.csv"

فایل TXT حاصل را دانلود کنید

curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.txt

برای جزئیات بیشتر درباره هر نقطه انتهایی، به Aspose.Cells API Reference مراجعه کنید.

تنظیمات تبدیل: گزینه‌ها و پارامترها

مثال فقط از دو پارامتر استفاده می‌کند، اما API از تنظیمات اضافی پشتیبانی می‌کند:

format - نوع فایل هدف را مشخص می‌کند. در مثال ما مقدار آن به 'txt' تنظیم شده است. تغییر این مقدار به شما امکان می‌دهد به سایر فرمت‌های متن ساده پشتیبانی‌شده توسط سرویس صادر کنید.
file - یک جریان (stream) که نمایانگر CSV منبع است. می‌توانید این جریان را با یک Buffer یا رشته base64 جایگزین کنید اگر برای معماری شما مناسب باشد.

برای دریافت فهرست کامل پارامترهای پشتیبانی‌شده، به صفحه مرجع API برای postConvertWorkbook مراجعه کنید.

نکات عملی برای تبدیل CSV به TXT

Validate input files قبل از ارسال آن‌ها به API تا از خطاهای ناخواسته تبدیل جلوگیری شود.
Reuse the API client در چندین تبدیل برای کاهش هزینه احراز هویت.
Stream large CSV files به‌جای بارگذاری کامل آن‌ها در حافظه؛ fs.createReadStream در حال حاضر این کار را انجام می‌دهد.
Handle the response Buffer با رمزگذاری مناسب (utf8) اگر نیاز به دستکاری متن پس از تبدیل دارید.
Secure your credentials با ذخیره‌سازی clientId و clientSecret در متغیرهای محیطی یا یک مدیر راز.

پیروی از این روش‌ها برنامه شما را کارآمد و ایمن نگه می‌دارد.

نتیجه‌گیری

تبدیل CSV به TXT در Node.JS به سادگی انجام می‌شود با Aspose.Cells Cloud SDK for Node.js. این کتابخانه جزئیات سطح پایین را انتزاع می‌کند و به شما اجازه می‌دهد بر منطق کسب‌وکار تمرکز کنید در حالی که نتایج قابل اعتماد ارائه می‌دهد. به یاد داشته باشید برای استفاده در تولید یک لایسنس معتبر دریافت کنید؛ می‌توانید یک اشتراک خریداری کنید یا لایسنس موقت را از صفحه لایسنس موقت دریافت کنید. با نمونه کد، جریان کار cURL و راهنمایی‌های بهترین‌روش در این مقاله، آماده‌اید تا خروجی CSV به TXT را در هر راه‌حل Node.JS یکپارچه کنید.

سؤالات متداول

چگونه می‌توانم تبدیل CSV به TXT را در Node.JS با استفاده از Aspose.Cells Cloud انجام دهم؟
از Aspose.Cells Cloud SDK برای Node.js استفاده کنید تا متد postConvertWorkbook را فراخوانی کنید. جریان فایل CSV را فراهم کنید و فرمت را به 'txt' تنظیم کنید. مثال کامل کد را در بالا ببینید.

آیا می‌توانم چندین فایل CSV را در یک درخواست به TXT تبدیل کنم؟
API یک فایل را در هر درخواست پردازش می‌کند. در Node.JS بر روی فایل‌های خود حلقه بزنید و برای هر فایل متد تبدیل را فراخوانی کنید.

CSV به TXT صادرات در Node.JS برای چه احراز هویتی نیاز است؟
شما به یک client ID و client secret از حساب Aspose Cloud خود نیاز دارید. SDK به‌صورت خودکار آن‌ها را برای دریافت یک access token تعویض می‌کند.

کجا می‌توانم جزئیات بیشتری درباره گزینه‌های تبدیل پیدا کنم؟
به مستندات رسمی در Aspose.Cells Cloud SDK for Node.js Documentation و مرجع API در Aspose.Cells API Reference مراجعه کنید.

مثال کامل کارآمد برای CSV به TXT در Node.JS#

تجزیه CSV به TXT در Node.JS#

آماده‌سازی محیط#

تبدیل CSV به TXT با استفاده از cURL و REST API#

تنظیمات تبدیل: گزینه‌ها و پارامترها#

نکات عملی برای تبدیل CSV به TXT#

نتیجه‌گیری#

سؤالات متداول#

بیشتر بخوانید#