تحويل CSV إلى TXT في Node.JS

تحويل بيانات جداول البيانات إلى نص عادي هو حاجة متكررة عندما تريد إدخال المعلومات إلى أنظمة قديمة أو محللات بسيطة. Aspose.Cells Cloud SDK for Node.js يوفر مكتبة قوية تتعامل مع الأعمال الشاقة على جانب الخادم. في هذا الدليل ستشاهد مثالًا عمليًا كاملًا، وسير عمل cURL لواجهة برمجة التطبيقات REST، وخطوات التثبيت، وخيارات التكوين، ونصائح أفضل الممارسات لجعل تحويل 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'
};

استدعِ postConvertWorkbook - تُعيد الواجهة البرمجية 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 تنزيل.
أنشئ حساب Aspose Cloud مجاني للحصول على معرف العميل و سر العميل.

مع استيفاء هذه المتطلبات المسبقة، يمكنك تشغيل برنامج التحويل مباشرةً.

تحويل CSV إلى TXT باستخدام cURL وواجهة برمجة التطبيقات REST

يمكنك تحقيق النتيجة نفسها دون كتابة أي رمز عن طريق استدعاء نقاط النهاية 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.

إعدادات التحويل: الخيارات والمعلمات

يستخدم المثال معلمتين فقط، لكن واجهة برمجة التطبيقات تدعم إعدادات إضافية:

format - يحدد نوع الملف المستهدف. في حالتنا يتم تعيينه إلى 'txt'. تغيير هذه القيمة يتيح لك التصدير إلى صيغ نصية أخرى يدعمها الخدمة.
file - تدفق يمثل ملف CSV المصدر. يمكنك استبدال التدفق بذاكرة مؤقتة (Buffer) أو سلسلة base64 إذا كان ذلك يناسب بنية تطبيقك.

للحصول على قائمة كاملة بالمعلمات المدعومة، راجع صفحة مرجع API لـ postConvertWorkbook.

نصائح عملية لتصدير CSV إلى TXT

تحقق من صحة ملفات الإدخال قبل إرسالها إلى API لتجنب أخطاء التحويل غير المتوقعة.
أعد استخدام عميل API عبر عمليات تحويل متعددة لتقليل عبء المصادقة.
قم ببث ملفات CSV الكبيرة بدلاً من تحميلها بالكامل في الذاكرة؛ fs.createReadStream يقوم بذلك بالفعل.
تعامل مع Buffer الاستجابة باستخدام الترميز المناسب (utf8) إذا كنت بحاجة إلى تعديل النص بعد التحويل.
احمِ بيانات الاعتماد الخاصة بك عن طريق تخزين 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 في طلب واحد؟
تقوم الواجهة البرمجية بمعالجة ملف واحد لكل طلب. قم بالتكرار عبر ملفاتك في 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#

إعدادات التحويل: الخيارات والمعلمات#

نصائح عملية لتصدير CSV إلى TXT#

الخلاصة#

الأسئلة المتكررة#

المزيد#