تحويل JSON إلى XLSX في Node.JS

تصدير البيانات من ملفات JSON إلى جداول بيانات Excel هو طلب شائع للتقارير وتبادل البيانات في تطبيقات Node.JS الحديثة. يوفر Aspose.OCR Cloud SDK for Node.js واجهة برمجة تطبيقات قوية يمكنها معالجة هذا التحويل مباشرةً في السحابة. في هذا الدليل، ستتعلم كيفية تحويل JSON إلى XLSX في Node.JS باستخدام نمط async/await وطريقة convertDocument في SDK. سنستعرض المتطلبات المسبقة، شرحًا مفصلاً للكود، مثالًا كاملاً، وحتى بديل cURL للتكامل عبر REST.

قبل البدء: المتطلبات المسبقة والتثبيت

لمتابعة هذا البرنامج التعليمي تحتاج إلى:

Node.js 14 أو أحدث مثبت محليًا.
حساب Aspose Cloud مع تمكين OCR API.
معرف Client Id و Client Secret الخاصين بك من لوحة تحكم Aspose Cloud.
الوصول إلى نظام الملفات حيث سيقع مصدر JSON وإخراج XLSX.

قم بتثبيت SDK عبر npm:

npm install aspose-ocr-cloud

قم بتنزيل أحدث حزمة من صفحة الإصدار الرسمية: Aspose.OCR Cloud SDK for Node.js Download. بعد التثبيت، يمكنك البدء بالبرمجة.

المقتطف التالي يوضح كيفية تكوين عميل OCR باستخدام بيانات الاعتماد الخاصة بك:

const { OcrApi, Configuration } = require('asposeocrcloud');

const config = new Configuration({
    clientId: 'YOUR_CLIENT_ID',
    clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);

مع جاهزية العميل، توضح الأقسام التالية سير عمل التحويل خطوة بخطوة.

دليل خطوة بخطوة لتحويل JSON إلى XLSX في Node.JS

فيما يلي شرح تفصيلي لكل عملية مطلوبة لتحويل JSON إلى XLSX في Node.JS.

الخطوة 1: تحميل مستند المصدر

أولاً، أنشئ تدفق قراءة لملف JSON الذي تريد تحويله.

const fs = require('fs');
const path = require('path');

const inputJsonPath = path.resolve(__dirname, 'input.json');
const jsonFileStream = fs.createReadStream(inputJsonPath);

الخطوة 2: تكوين عميل OCR API

أعد استخدام التكوين المعروض سابقًا لإنشاء كائن API.

const { OcrApi, Configuration } = require('asposeocrcloud');

const config = new Configuration({
    clientId: 'YOUR_CLIENT_ID',
    clientSecret: 'YOUR_CLIENT_SECRET'
});
const ocrApi = new OcrApi(config);

الخطوة 3: استدعاء طريقة ConvertDocument

استدعِ نقطة تحويل النهاية، مع تحديد xlsx كتنسيق الهدف.

const response = await ocrApi.convertDocument({
    format: 'xlsx',
    file: jsonFileStream
});

تُعيد SDK بيانات XLSX الثنائية في response.body.

الخطوة 4: كتابة ملف XLSX الناتج

احفظ البيانات الثنائية في ملف على القرص.

const outputXlsxPath = path.resolve(__dirname, 'output.xlsx');
fs.writeFileSync(outputXlsxPath, response.body, { encoding: 'binary' });
console.log('Conversion completed successfully:', outputXlsxPath);

الخطوة 5: تنظيف الموارد

أغلق تدفق الملف لتحرير موارد النظام.

jsonFileStream.close();

مع هذه الخطوات، لقد نجحت في تنفيذ عملية تحويل JSON إلى XLSX في Node.JS باستخدام مكتبة Aspose OCR Cloud.

تحويل JSON إلى XLSX في Node.JS - مثال كامل للكود

يوضح المثال أدناه التنفيذ الكامل لتحويل JSON إلى XLSX في Node.JS باستخدام Aspose.OCR Cloud SDK.

const fs = require('fs');
const path = require('path');
const { OcrApi, Configuration } = require('asposeocrcloud');

(async () => {
    // Configure Aspose OCR Cloud client
    const config = new Configuration({
        clientId: 'YOUR_CLIENT_ID',
        clientSecret: 'YOUR_CLIENT_SECRET'
    });
    const ocrApi = new OcrApi(config);

// Define input JSON and output XLSX paths
    const inputJsonPath = path.resolve(__dirname, 'input.json');
    const outputXlsxPath = path.resolve(__dirname, 'output.xlsx');

// Prepare file stream for the JSON file
    const jsonFileStream = fs.createReadStream(inputJsonPath);

try {
        // Convert JSON to XLSX using Aspose OCR Cloud SDK
        const response = await ocrApi.convertDocument({
            format: 'xlsx',
            file: jsonFileStream
        });

// Write the returned binary data to the XLSX file
        fs.writeFileSync(outputXlsxPath, response.body, { encoding: 'binary' });

console.log('Conversion completed successfully:', outputXlsxPath);
    } catch (error) {
        console.error('Conversion failed:', error);
    } finally {
        // Ensure the file stream is closed
        jsonFileStream.close();
    }
})();

ملاحظة: يوضح مثال الشيفرة هذا الوظيفة الأساسية. قبل استخدامه في مشروعك، تأكد من تحديث أي مسارات ملفات وقيم التكوين لتتناسب مع بيئتك الفعلية، وتحقق من تثبيت جميع الاعتمادات المطلوبة بشكل صحيح، واختبر بدقة في بيئة التطوير الخاصة بك. إذا واجهت أي مشاكل، يرجى الرجوع إلى الوثائق الرسمية أو التواصل مع فريق الدعم للحصول على المساعدة.

طريقة cURL لتحويل JSON إلى XLSX في Node.JS

إذا كنت تفضل حلاً يعتمد على REST فقط، يمكن تنفيذ نفس التحويل باستخدام أوامر cURL. تستخدم هذه الطريقة أيضًا العبارة الأساسية convert JSON to XLSX في Node.JS.

الحصول على رمز الوصول

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"

قم بتحميل ملف JSON واطلب التحويل

curl -X POST "https://api.aspose.cloud/v3.0/ocr/convert?format=xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.json"

تحتوي الاستجابة على حمولة XLSX الثنائية.

احفظ مخرجات XLSX محليًا

   curl -X GET "https://api.aspose.cloud/v3.0/ocr/convert/result/output.xlsx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.xlsx

توضح هذه الأوامر كيفية تحقيق النتيجة نفسها دون كتابة أي كود Node.js. لمزيد من التفاصيل، راجع وثائق API الرسمية.

الخلاصة

تحويل JSON إلى XLSX في Node.JS يصبح بسيطًا عندما تستفيد من Aspose.OCR Cloud SDK for Node.js. يتولى SDK الأعمال الثقيلة، مما يتيح لك التركيز على منطق الأعمال بدلاً من تعقيدات تنسيقات الملفات. تذكر أن تؤمن بيانات اعتماد العميل، وتعالج الأخطاء بلطف، وتختبر باستخدام أحجام بيانات واقعية. بالنسبة للنشر في بيئة الإنتاج ستحتاج إلى اشتراك مدفوع؛ تفاصيل التسعير متاحة على صفحة المنتج، ويمكن الحصول على ترخيص مؤقت من صفحة الترخيص المؤقت. برمجة سعيدة!

FAQs

كيف يمكنني تحويل JSON إلى XLSX في Node.JS باستخدام Aspose.OCR Cloud SDK?
استخدم طريقة OcrApi.convertDocument مع format: 'xlsx'. يوضح مثال الشيفرة الكامل في هذه المقالة خطوات التنفيذ الدقيقة.

ما هو نوع المصادقة المطلوبة لواجهة برمجة تطبيقات OCR Cloud API؟
إنشاء معرف عميل (client ID) وسر عميل (client secret) في لوحة تحكم Aspose Cloud، ثم استبدالهما برمز OAuth. يدير كائن Configuration في SDK استرجاع الرمز تلقائيًا.

هل يمكنني معالجة ملفات JSON الكبيرة بكفاءة؟
نعم. يقوم SDK ببث ملف الإدخال، مما يحافظ على انخفاض استهلاك الذاكرة. اجمع ذلك مع async/await للحفاظ على استجابة حلقة الأحداث في Node.js.

أين يمكنني العثور على المزيد من الأمثلة والدعم؟
قم بزيارة مستودع GitHub الرسمي، موقع توثيق Aspose، أو اطرح أسئلتك على منتدى الدعم.

قبل البدء: المتطلبات المسبقة والتثبيت#

دليل خطوة بخطوة لتحويل JSON إلى XLSX في Node.JS#

الخطوة 1: تحميل مستند المصدر#

الخطوة 2: تكوين عميل OCR API#

الخطوة 3: استدعاء طريقة ConvertDocument#

الخطوة 4: كتابة ملف XLSX الناتج#

الخطوة 5: تنظيف الموارد#

تحويل JSON إلى XLSX في Node.JS - مثال كامل للكود#

طريقة cURL لتحويل JSON إلى XLSX في Node.JS#

الخلاصة#

FAQs#

اقرأ المزيد#