Node.JS에서 CSV를 Excel XLSX로 변환

CSV 데이터를 최신 XLSX 워크북으로 변환하는 것은 Microsoft Excel에 의존하지 않고 Excel 보고서를 생성해야 하는 Node.JS 애플리케이션에서 자주 요구되는 작업입니다. Aspose.HTML Cloud SDK for Node.JS는 클라우드에서 변환을 완전히 처리하는 강력한 API를 제공합니다. 이 가이드에서는 전체 코드 예제를 확인하고, cURL을 사용하여 REST API를 호출하는 방법을 배우며, Node.JS에서 CSV를 Excel XLSX로 변환하기 위해 필요한 설정 단계들을 이해하게 됩니다.

전체 코드 예제: CSV를 Excel XLSX 변환 (Node.JS)

이 예제는 Aspose.HTML Cloud SDK for Node.JS를 사용하여 CSV 파일을 XLSX 워크북으로 변환하는 방법을 보여줍니다.

const fs = require('fs');
const path = require('path');
const {
    HtmlApi,
    Configuration,
    UploadFileRequest,
    DownloadFileRequest,
    ConvertDocumentRequest,
    DeleteFileRequest
} = require('@asposecloud/aspose-html-cloud');

// Replace with your actual Aspose Cloud credentials
const config = new Configuration({
    clientId: 'YOUR_CLIENT_ID',
    clientSecret: 'YOUR_CLIENT_SECRET'
});

const htmlApi = new HtmlApi(config);

async function convertCsvToXlsx() {
    const localCsvPath = path.resolve(__dirname, 'input.csv');
    const localXlsxPath = path.resolve(__dirname, 'output.xlsx');

const remoteCsvPath = 'input.csv';
    const remoteXlsxPath = 'output.xlsx';

try {
        // Upload CSV using a read stream (efficient for large files)
        const uploadStream = fs.createReadStream(localCsvPath);
        await htmlApi.uploadFile(new UploadFileRequest({
            path: remoteCsvPath,
            file: uploadStream
        }));

// Convert CSV to XLSX
        await htmlApi.convertDocument(new ConvertDocumentRequest({
            inputPath: remoteCsvPath,
            outputPath: remoteXlsxPath,
            format: 'xlsx'
        }));

// Download the resulting XLSX file
        const downloadResponse = await htmlApi.downloadFile(new DownloadFileRequest({
            path: remoteXlsxPath
        }));
        const writeStream = fs.createWriteStream(localXlsxPath);
        await new Promise((resolve, reject) => {
            downloadResponse.body.pipe(writeStream);
            downloadResponse.body.on('end', resolve);
            downloadResponse.body.on('error', reject);
        });

console.log('Conversion completed successfully.');
    } catch (error) {
        console.error('Error during conversion:', error);
    } finally {
        // Cleanup remote files
        try {
            await htmlApi.deleteFile(new DeleteFileRequest({ path: remoteCsvPath }));
            await htmlApi.deleteFile(new DeleteFileRequest({ path: remoteXlsxPath }));
        } catch (cleanupError) {
            // Ignore cleanup errors
        }
    }
}

convertCsvToXlsx();

Note: 이 코드 예제는 핵심 기능을 보여줍니다. 프로젝트에 사용하기 전에 파일 경로(input.csv, output.xlsx 등)를 실제 파일 위치에 맞게 업데이트하고, 모든 필수 종속성이 올바르게 설치되었는지 확인한 다음 개발 환경에서 충분히 테스트하십시오. 문제가 발생하면 공식 문서를 참조하거나 지원 팀에 문의하십시오.

cURL 및 REST API를 사용한 CSV에서 XLSX 변환

직접 REST 방식을 선호한다면, 동일한 변환을 cURL 명령으로 수행할 수 있습니다. 아래 단계에서는 액세스 토큰을 얻고, CSV를 업로드하고, 변환을 트리거하고, XLSX 파일을 다운로드하는 방법을 보여줍니다.

# 1. Get an access token
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"

# 2. Upload the source CSV file
curl -X PUT "https://api.aspose.cloud/v4.0/html/storage/file/input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: text/csv" \
     --data-binary @input.csv

# 3. Convert CSV to XLSX
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=xlsx&outPath=output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"inputPath":"input.csv"}'

# 4. Download the generated XLSX file
curl -X GET "https://api.aspose.cloud/v4.0/html/storage/file/output.xlsx" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.xlsx

<!--[CODE_SNIPPET_END]-->

요청 매개변수 및 추가 옵션에 대한 자세한 내용은 공식 API 문서를 참조하십시오.

## Node.JS에서 CSV를 Excel로 변환하는 과정 분석

Node.JS에서 코드가 CSV를 Excel XLSX로 변환하는 방식을 이해하면 자체 프로젝트에 맞게 프로세스를 맞춤 설정할 수 있습니다.

1. **구성 설정** – `Configuration` 클래스는 `clientId`와 `clientSecret`을 저장합니다.  
   <!--[CODE_SNIPPET_START]-->
   ```javascript
   const [config](https://docs.fileformat.com/programming/config/) = new Configuration({
       clientId: 'YOUR_CLIENT_ID',
       clientSecret: 'YOUR_CLIENT_SECRET'
   });

API 초기화 – HtmlApi는 구성을 사용하여 인스턴스화되며, 모든 변환 엔드포인트에 접근할 수 있습니다.
```
const htmlApi = new HtmlApi(config);
```

CSV 업로드 – 읽기 스트림(fs.createReadStream)을 사용하여 파일을 효율적으로 업로드합니다. 이는 대용량 CSV 파일에 매우 중요합니다.

const uploadStream = fs.createReadStream(localCsvPath);
await htmlApi.uploadFile(new UploadFileRequest({
    path: remoteCsvPath,
    file: uploadStream
}));

변환 실행 – convertDocument를 format: 'xlsx'와 함께 호출하여 CSV를 Excel XLSX로 변환합니다.

await htmlApi.convertDocument(new ConvertDocumentRequest({
    inputPath: remoteCsvPath,
    outputPath: remoteXlsxPath,
    format: 'xlsx'
}));

결과 다운로드 – SDK는 생성된 XLSX 파일을 스트리밍하여 로컬 파일 시스템에 저장합니다.

const downloadResponse = await htmlApi.downloadFile(new DownloadFileRequest({
    path: remoteXlsxPath
}));
const writeStream = fs.createWriteStream(localXlsxPath);
await new Promise((resolve, reject) => {
    downloadResponse.body.pipe(writeStream);
    downloadResponse.body.on('end', resolve);
    downloadResponse.body.on('error', reject);
});

이 단계들은 Aspose.HTML Cloud SDK를 사용한 Node.JS에서 CSV를 Excel XLSX로 변환하는 전체 흐름을 보여줍니다.

필수 조건 및 설정 - Node.JS용 Aspose.HTML Cloud SDK 설치

Node.js 런타임 – Node.js 14 이상이 설치되어 있는지 확인하십시오.
SDK 설치 – 다음 npm 명령을 실행하십시오 (다운로드 URL: https://releases.aspose.cloud/html/nodejs/).
```
npm install @asposecloud/aspose-html-cloud --save
```
자격 증명 구성 - .asposecloud 구성 파일을 만들거나 Aspose Cloud 대시보드에서 얻은 clientId와 clientSecret을 환경 변수로 설정하십시오.
설치 확인 - node -e "require('@asposecloud/aspose-html-cloud')"를 실행하여 패키지가 오류 없이 로드되는지 확인하십시오.

SDK가 설치되고 자격 증명이 구성되면 변환 코드를 실행할 준비가 됩니다.

결론

이 가이드는 Node.JS에서 Aspose.HTML Cloud SDK for Node.JS를 사용하여 CSV를 Excel XLSX로 변환하는 방법을 단계별로 안내합니다. 완전한 작업 예제를 확인하고, cURL을 사용하여 동일한 작업을 수행하는 방법을 배우며, 개발 머신에 SDK를 설정하는 과정을 살펴보았습니다. 이 라이브러리는 서버에서 Microsoft Excel이 필요 없도록 하여 대규모 보고서 생성이 가볍고 안정적으로 이루어지게 합니다. 실제 운영 환경에서는 상용 라이선스를 구매하거나 임시 라이선스 페이지에서 임시 라이선스를 사용하여 규정을 준수하십시오.

자주 묻는 질문

CSV 및 XLSX 외에 변환이 지원되는 파일 형식은 무엇입니까?
Aspose.HTML은 HTML, PDF, DOCX, 및 PPTX를 포함한 다양한 형식을 지원합니다. 전체 목록은 제품 문서를 참조하십시오.
단일 실행에서 여러 CSV 파일을 변환하려면 어떻게 해야 합니까?
파일 목록을 반복하면서 각 파일에 대해 업로드, 변환 및 다운로드 단계를 호출합니다. SDK의 스트리밍 방식은 배치 처리에 적합합니다.
Excel 출력(예: 열 너비, 스타일)을 사용자 정의할 수 있습니까?
기본 변환은 표준 워크북을 생성합니다. 고급 스타일링이 필요하면 변환 후 Aspose.Cells Cloud를 사용하여 XLSX를 후처리할 수 있습니다.
Aspose.HTML Cloud SDK의 가격 정보는 어디에서 확인할 수 있습니까?
가격 정보는 Aspose 웹사이트에 제공됩니다. 전체 구독을 구매하기 전에 평가용 임시 라이선스로 시작할 수 있습니다.

전체 코드 예제: CSV를 Excel XLSX 변환 (Node.JS)#

cURL 및 REST API를 사용한 CSV에서 XLSX 변환#

필수 조건 및 설정 - Node.JS용 Aspose.HTML Cloud SDK 설치#

결론#

자주 묻는 질문#

더 읽기#

전체 코드 예제: CSV를 Excel XLSX 변환 (Node.JS)

cURL 및 REST API를 사용한 CSV에서 XLSX 변환

필수 조건 및 설정 - Node.JS용 Aspose.HTML Cloud SDK 설치

결론

자주 묻는 질문

더 읽기