Експорт даних з файлів 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 Завантажити. Після встановлення ви можете розпочати кодування.

Наступний фрагмент показує, як налаштувати 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.

  1. Отримайте токен доступу
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"
  1. Завантажте файл 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.

  1. Збережіть вихідний файл 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 token. Об’єкт Configuration SDK автоматично керує отриманням токену.

Чи можу я ефективно обробляти великі JSON-файли?
Так. SDK транслює вхідний файл, зберігаючи низьке використання пам’яті. Поєднайте це з async/await, щоб залишити цикл подій Node.js реактивним.

Де я можу знайти більше прикладів та підтримку?
Відвідайте офіційний репозиторій GitHub, сайт документації Aspose або задавайте питання на форумі підтримки.

Read More