JSON 파일에서 Excel 스프레드시트로 데이터를 내보내는 것은 최신 Node.JS 애플리케이션에서 보고 및 데이터 교환을 위해 자주 요구됩니다. Aspose.OCR Cloud SDK for Node.js는 클라우드에서 직접 이 변환을 처리할 수 있는 강력한 API를 제공합니다. 이 가이드에서는 async/await 패턴과 SDK의 convertDocument 메서드를 사용하여 Node.JS에서 JSON을 XLSX로 변환하는 방법을 배웁니다. 전제 조건, 자세한 코드 walkthrough, 완전한 예제, 그리고 REST 통합을 위한 cURL 대안까지 살펴보겠습니다.

시작하기 전에: 전제 조건 및 설치

이 튜토리얼을 따라하려면 다음이 필요합니다:

  • Node.js 14 이상(또는 이후) 버전이 로컬에 설치되어 있어야 합니다.
  • OCR API가 활성화된 Aspose Cloud 계정.
  • Aspose Cloud 대시보드에서 얻은 Client Id 및 Client Secret.
  • JSON 소스와 XLSX 출력이 위치할 파일 시스템에 대한 접근 권한.

npm을 통해 SDK를 설치합니다:

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);

클라이언트를 준비했으니, 다음 섹션에서는 변환 워크플로를 단계별로 시연합니다.

Node.JS에서 JSON을 XLSX로 변환하는 단계별 가이드

아래는 Node.JS에서 JSON을 XLSX로 변환하는 데 필요한 각 작업에 대한 상세한 단계별 안내입니다.

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();

이 단계들을 통해 Node.JS에서 Aspose OCR Cloud 라이브러리를 사용하여 JSON을 XLSX로 변환하는 작업을 성공적으로 수행했습니다.

Node.JS에서 JSON을 XLSX로 변환 - 전체 코드 예제

아래 예제는 Aspose.OCR Cloud SDK를 사용하여 Node.JS에서 JSON을 XLSX로 변환하는 전체 구현을 보여줍니다.

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();
    }
})();

참고: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로와 구성 값을 실제 환경에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인하며, 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서 또는 지원 팀 에 문의하십시오.

Node.JS에서 JSON을 XLSX로 변환하기 위한 cURL 접근 방식

순수 REST 솔루션을 선호한다면, 동일한 변환을 cURL 명령으로 수행할 수 있습니다. 이 방법은 Node.JS에서 convert JSON to XLSX라는 기본 구문을 사용합니다.

  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 문서를 참조하십시오.

결론

Node.JS에서 JSON을 XLSX로 변환하는 작업은 Aspose.OCR Cloud SDK for Node.js를 활용하면 간단해집니다. SDK가 복잡한 작업을 처리해 주므로 파일 형식의 세부 사항보다 비즈니스 로직에 집중할 수 있습니다. 클라이언트 자격 증명을 안전하게 보관하고, 오류를 우아하게 처리하며, 현실적인 데이터 크기로 테스트하는 것을 기억하세요. 프로덕션 배포를 위해서는 유료 구독이 필요하며, 가격 세부 정보는 제품 페이지에서 확인할 수 있고, 임시 라이선스는 임시 라이선스 페이지에서 얻을 수 있습니다. 즐거운 코딩 되세요!

FAQs

JSON을 XLSX로 Node.JS에서 Aspose.OCR Cloud SDK를 사용하여 변환하려면 어떻게 해야 하나요?
format: 'xlsx'와 함께 OcrApi.convertDocument 메서드를 사용하십시오. 이 문서의 전체 코드 예제는 정확한 구현 단계를 보여줍니다.

OCR Cloud API에 필요한 인증은 무엇인가요?
Aspose Cloud 대시보드에서 클라이언트 ID와 클라이언트 비밀을 생성한 다음, 이를 OAuth 토큰으로 교환합니다. SDK의 Configuration 객체가 토큰 검색을 자동으로 관리합니다.

큰 JSON 파일을 효율적으로 처리할 수 있나요?
예. SDK는 입력 파일을 스트리밍하여 메모리 사용량을 낮게 유지합니다. 이를 async/await와 결합하면 Node.js 이벤트 루프가 응답성을 유지합니다.

더 많은 예제와 지원을 어디서 찾을 수 있나요?
공식 GitHub 저장소, Aspose 문서 사이트를 방문하거나, 지원 포럼에서 질문하십시오.

자세히 보기