تبدیل JSON به XLSX در Node.JS

صادر کردن داده‌ها از فایل‌های JSON به صفحات گسترده Excel یک نیاز مکرر برای گزارش‌گیری و تبادل داده در برنامه‌های مدرن Node.JS است. Aspose.OCR Cloud SDK for Node.js یک API قدرتمند ارائه می‌دهد که می‌تواند این تبدیل را به‌صورت مستقیم در ابر انجام دهد. در این راهنما، خواهید آموخت که چگونه 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);

مرحله ۲: پیکربندی OCR API Client

از پیکربندی نشان داده شده در بالا برای ایجاد شیء 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 برمی‌گرداند.

مرحله ۴: نوشتن فایل خروجی 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 مراجعه کنید.

نتیجه‌گیری

Converting JSON to XLSX در Node.JS زمانی که از Aspose.OCR Cloud SDK for Node.js استفاده کنید، ساده می‌شود. این SDK کارهای سنگین را بر عهده می‌گیرد و به شما امکان می‌دهد تا بر منطق کسب‌وکار تمرکز کنید نه جزئیات فرمت فایل. به یاد داشته باشید که اعتبارنامه‌های کلاینت خود را ایمن کنید، خطاها را به‌صورت مناسب مدیریت کنید و با اندازه‌های داده واقعی تست کنید. برای استقرارهای تولیدی به اشتراک‌گذاری پرداختی نیاز خواهید داشت؛ جزئیات قیمت‌گذاری در صفحه محصول موجود است و می‌توانید یک لایسنس موقت را از صفحه لایسنس موقت دریافت کنید. برنامه‌نویسی خوش!

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

چگونه 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: بارگذاری سند منبع#

مرحله ۲: پیکربندی OCR API Client#

مرحله 3: فراخوانی متد ConvertDocument#

مرحله ۴: نوشتن فایل خروجی XLSX#

مرحله 5: پاک‌سازی منابع#

تبدیل JSON به XLSX در Node.JS - مثال کامل کد#

رویکرد cURL برای تبدیل JSON به XLSX در Node.JS#

نتیجه‌گیری#

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

Read More#