Việc xuất dữ liệu từ các tệp JSON sang bảng tính Excel là một yêu cầu thường gặp cho việc báo cáo và trao đổi dữ liệu trong các ứng dụng Node.JS hiện đại. Aspose.OCR Cloud SDK for Node.js cung cấp một API mạnh mẽ có thể xử lý việc chuyển đổi này trực tiếp trên đám mây. Trong hướng dẫn này, bạn sẽ học cách chuyển đổi JSON sang XLSX trong Node.JS bằng các mẫu async/await và phương thức convertDocument của SDK. Chúng tôi sẽ đi qua các yêu cầu trước, một walkthrough chi tiết của mã, một ví dụ hoàn chỉnh, và thậm chí một tùy chọn cURL cho tích hợp REST.

Trước Khi Bắt Đầu: Các Yêu Cầu Trước và Cài Đặt

Để làm theo hướng dẫn này, bạn cần:

  • Node.js 14 hoặc mới hơn được cài đặt trên máy cục bộ.
  • Một tài khoản Aspose Cloud với OCR API đã được bật.
  • Client IdClient Secret của bạn từ bảng điều khiển Aspose Cloud.
  • Quyền truy cập vào hệ thống tệp nơi nguồn JSON và đầu ra XLSX sẽ được lưu trữ.

Cài đặt SDK qua npm:

npm install aspose-ocr-cloud

Tải xuống gói mới nhất từ trang phát hành chính thức: Aspose.OCR Cloud SDK for Node.js Download. Sau khi cài đặt, bạn có thể bắt đầu viết mã.

Đoạn mã sau cho thấy cách cấu hình client OCR với thông tin xác thực của bạn:

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

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

Khi client đã sẵn sàng, các phần tiếp theo sẽ trình bày quy trình chuyển đổi từng bước.

Hướng dẫn từng bước để chuyển đổi JSON sang XLSX trong Node.JS

Dưới đây là hướng dẫn chi tiết từng thao tác cần thiết để chuyển đổi JSON sang XLSX trong Node.JS.

Bước 1: Tải tài liệu nguồn

Đầu tiên, tạo một luồng đọc cho tệp JSON mà bạn muốn chuyển đổi.

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

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

Bước 2: Cấu hình máy khách API OCR

Sử dụng lại cấu hình đã được hiển thị ở trên để khởi tạo đối tượng API.

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

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

Bước 3: Gọi phương thức ConvertDocument

Gọi endpoint chuyển đổi, chỉ định xlsx làm định dạng đích.

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

SDK trả về dữ liệu XLSX nhị phân trong response.body.

Bước 4: Ghi tệp XLSX đầu ra

Lưu trữ dữ liệu nhị phân vào một tệp trên đĩa.

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

Bước 5: Dọn dẹp tài nguyên

Đóng luồng tệp để giải phóng tài nguyên hệ thống.

jsonFileStream.close();

Với các bước này, bạn đã thực hiện thành công thao tác chuyển đổi JSON sang XLSX trong Node.JS bằng thư viện Aspose OCR Cloud.

Chuyển đổi JSON sang XLSX trong Node.JS - Ví dụ mã hoàn chỉnh

Ví dụ dưới đây trình bày việc triển khai đầy đủ để chuyển đổi JSON sang XLSX trong Node.JS bằng 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();
    }
})();

Lưu ý: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật mọi đường dẫn tệp và giá trị cấu hình để phù hợp với môi trường thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.

Cách tiếp cận cURL để chuyển đổi JSON sang XLSX trong Node.JS

Nếu bạn muốn một giải pháp REST thuần túy, việc chuyển đổi tương tự có thể được thực hiện bằng các lệnh cURL. Phương pháp này cũng sử dụng cụm từ chính convert JSON to XLSX trong Node.JS.

  1. Nhận token truy cập
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. Tải lên tệp JSON và yêu cầu chuyển đổi
curl -X POST "https://api.aspose.cloud/v3.0/ocr/convert?format=xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@input.json"

Phản hồi chứa payload nhị phân XLSX.

  1. Lưu tệp XLSX đầu ra cục bộ
curl -X GET "https://api.aspose.cloud/v3.0/ocr/convert/result/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

Các lệnh này minh họa cách đạt được kết quả tương tự mà không cần viết bất kỳ mã Node.js nào. Để biết thêm chi tiết, hãy tham khảo tài liệu API chính thức.

Kết luận

Chuyển đổi JSON sang XLSX trong Node.JS trở nên đơn giản khi bạn tận dụng Aspose.OCR Cloud SDK for Node.js. SDK xử lý phần công việc nặng, cho phép bạn tập trung vào logic nghiệp vụ thay vì các chi tiết phức tạp của định dạng tệp. Hãy nhớ bảo mật thông tin xác thực client, xử lý lỗi một cách nhẹ nhàng và kiểm thử với kích thước dữ liệu thực tế. Đối với triển khai sản xuất, bạn sẽ cần một gói thuê bao trả phí; chi tiết giá cả có trên trang sản phẩm, và bạn có thể nhận giấy phép tạm thời từ trang giấy phép tạm thời. Chúc lập trình vui vẻ!

Câu hỏi thường gặp

Làm thế nào để chuyển đổi JSON sang XLSX trong Node.JS bằng Aspose.OCR Cloud SDK?
Sử dụng phương thức OcrApi.convertDocument với format: 'xlsx'. Ví dụ mã hoàn chỉnh trong bài viết này cho thấy các bước thực hiện chính xác.

Xác thực nào được yêu cầu cho OCR Cloud API?
Tạo một client ID và client secret trong bảng điều khiển Aspose Cloud, sau đó đổi chúng lấy token OAuth. Đối tượng Configuration của SDK tự động quản lý việc lấy token.

Tôi có thể xử lý các tệp JSON lớn một cách hiệu quả không?
Có. SDK truyền luồng tệp đầu vào, giữ mức sử dụng bộ nhớ thấp. Kết hợp điều này với async/await để giữ vòng lặp sự kiện của Node.js phản hồi nhanh.

Bạn có thể tìm thêm ví dụ và hỗ trợ ở đâu?
Truy cập kho GitHub chính thức, trang tài liệu Aspose, hoặc đặt câu hỏi trên diễn đàn hỗ trợ.

Read More