스프레드시트 데이터를 일반 텍스트로 변환하는 것은 레거시 시스템이나 간단한 파서에 정보를 전달하려는 경우 자주 필요합니다. Aspose.Cells Cloud SDK for Node.js는 서버 측에서 무거운 작업을 처리하는 강력한 라이브러리를 제공합니다. 이 가이드에서는 완전한 작동 예제, REST API용 cURL 워크플로우, 설치 단계, 구성 옵션 및 모범 사례 팁을 통해 Node.JS에서 CSV를 TXT로 변환하는 과정을 손쉽고 안정적으로 수행하는 방법을 보여줍니다.

Node.JS에서 CSV를 TXT로 변환하는 전체 작업 예제

이 예제는 Cells API를 호출하고 변환된 TXT 파일을 로컬에 저장하는 방법을 보여줍니다.

const fs = require('fs');
const path = require('path');
const { CellsApi, ApiClient } = require('@aspose/cells-cloud');

async function convertCsvToTxt() {
    // Aspose Cloud authentication
    const clientId = 'YOUR_CLIENT_ID';
    const clientSecret = 'YOUR_CLIENT_SECRET';
    const config = new ApiClient();
    config.clientId = clientId;
    config.clientSecret = clientSecret;
    config.basePath = 'https://api.aspose.cloud';

const cellsApi = new CellsApi(config);

// File paths
    const inputFile = path.resolve(__dirname, 'input.csv');
    const outputFile = path.resolve(__dirname, 'output.txt');

// Prepare request
    const fileStream = fs.createReadStream(inputFile);
    const request = {
        file: fileStream,
        format: 'txt' // target format
    };

try {
        // Convert CSV to TXT
        const response = await cellsApi.postConvertWorkbook(request);
        // response.body is a Buffer containing the TXT data
        fs.writeFileSync(outputFile, response.body);
        console.log(`Conversion completed. TXT saved to ${outputFile}`);
    } catch (err) {
        console.error('Conversion failed:', err);
    }
}

convertCsvToTxt();

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

Node.JS에서 CSV를 TXT로 분해하기

코드는 몇 가지 논리적 단계로 작동합니다:

  1. API 클라이언트 초기화 - new ApiClient()는 자격 증명과 기본 URL로 구성됩니다.
const config = new ApiClient();
config.clientId = clientId;
config.clientSecret = clientSecret;
config.basePath = 'https://api.aspose.cloud';
  1. CellsApi 인스턴스 생성 - 이 객체는 변환 메서드를 노출합니다.
const cellsApi = new CellsApi(config);
  1. CSV 파일을 스트림으로 읽기 - fs.createReadStream는 API에 필요한 바이너리 데이터를 제공합니다.
const fileStream = fs.createReadStream(inputFile);
  1. 요청 객체 빌드 - format 속성은 서비스에 TXT를 출력하도록 지시합니다.
const request = {
    file: fileStream,
    format: 'txt'
};
  1. Call postConvertWorkbook - API는 변환된 텍스트를 포함하는 Buffer를 반환하고, 이를 디스크에 기록합니다.
const response = await cellsApi.postConvertWorkbook(request);
fs.writeFileSync(outputFile, response.body);

각 구성 요소를 이해하면 오류 처리 추가나 여러 파일 처리와 같이 흐름을 맞춤 설정할 수 있습니다.

환경 준비하기

  1. npm으로 SDK를 설치합니다:
npm install asposecellscloud

  1. Node.js 14 이상 버전이 설치되어 있는지 확인하십시오.

  2. 수동 설치를 선호하는 경우 공식 릴리스 페이지에서 최신 패키지를 다운로드하십시오: Aspose.Cells Cloud SDK for Node.js 다운로드.

  3. 무료 Aspose Cloud 계정을 생성하여 client ID와 client secret을 얻으세요.

이러한 전제 조건이 충족되면, 변환 스크립트를 즉시 실행할 수 있습니다.

cURL 및 REST API를 사용하여 CSV를 TXT로 변환

코드를 작성하지 않고도 Aspose.Cells Cloud REST 엔드포인트를 직접 호출하여 동일한 결과를 얻을 수 있습니다.

  1. 액세스 토큰 얻기 - 클라이언트 자격 증명을 JWT로 교환합니다.
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. 소스 CSV 파일을 업로드 스토리지에.
curl -X PUT "https://api.aspose.cloud/v3.0/cells/storage/file/input.csv" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: text/csv" \
  --data-binary @input.csv
  1. 변환 요청 TXT 형식으로.
curl -X POST "https://api.aspose.cloud/v3.0/cells/convert?format=txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@input.csv"
  1. 결과 TXT 파일 다운로드.
curl -X GET "https://api.aspose.cloud/v3.0/cells/storage/file/output.txt" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -o output.txt

각 엔드포인트에 대한 자세한 내용은 Aspose.Cells API Reference를 참조하십시오.

변환 설정: 옵션 및 매개변수

예제에서는 두 개의 매개변수만 사용하지만, API는 추가 설정을 지원합니다:

  • format - 대상 파일 유형을 지정합니다. 여기서는 'txt' 로 설정됩니다. 이 값을 변경하면 서비스에서 지원하는 다른 일반 텍스트 형식으로 내보낼 수 있습니다.
  • file - 소스 CSV를 나타내는 스트림입니다. 필요에 따라 스트림을 Buffer 또는 base64 문자열로 교체할 수 있습니다.

지원되는 매개변수의 전체 목록은 postConvertWorkbook에 대한 API Reference 페이지를 참조하십시오.

CSV를 TXT로 내보내기 위한 실용 팁

  • 입력 파일을 검증하고 API에 보내기 전에 예기치 않은 변환 오류를 방지합니다.
  • API 클라이언트를 재사용하여 여러 변환에 걸쳐 인증 오버헤드를 줄입니다.
  • 대용량 CSV 파일 스트리밍을 사용하여 메모리에 전체를 로드하는 대신; fs.createReadStream 은 이미 이를 수행합니다.
  • 응답 Buffer 처리를 적절한 인코딩(utf8)으로 수행하여 변환 후 텍스트를 조작해야 할 경우에 대비합니다.
  • 자격 증명 보안을 위해 clientId와 clientSecret을 환경 변수나 비밀 관리자를 통해 저장합니다.

이러한 관행을 따르면 애플리케이션을 효율적이고 안전하게 유지할 수 있습니다.

결론

Node.JS에서 CSV를 TXT로 변환하는 작업이 Aspose.Cells Cloud SDK for Node.js를 사용하면 간단해집니다. 이 라이브러리는 저수준 세부 사항을 추상화하여 비즈니스 로직에 집중하면서도 안정적인 결과를 제공합니다. 프로덕션 사용을 위해 유효한 라이선스를 확보해야 함을 기억하십시오; 구독을 구매하거나 임시 라이선스 페이지에서 임시 라이선스를 얻을 수 있습니다. 이 문서의 코드 샘플, cURL 워크플로우 및 모범 사례 가이드를 통해 CSV를 TXT로 내보내는 기능을 모든 Node.JS 솔루션에 통합할 준비가 되었습니다.

자주 묻는 질문

Node.JS에서 Aspose.Cells Cloud를 사용하여 CSV를 TXT로 변환하려면 어떻게 해야 하나요?
Node.js용 Aspose.Cells Cloud SDK를 사용하여 postConvertWorkbook 메서드를 호출합니다. CSV 파일 스트림을 제공하고 형식을 'txt'로 설정합니다. 위의 전체 코드 예제를 참조하십시오.

한 번의 요청으로 여러 CSV 파일을 TXT로 변환할 수 있나요?
API는 요청당 하나의 파일만 처리합니다. Node.JS에서 파일들을 반복하고 각 파일에 대해 변환 메서드를 호출하십시오.

CSV를 TXT로 내보내기 위해 Node.JS에서 필요한 인증은 무엇인가요?
Aspose Cloud 계정에서 클라이언트 ID와 클라이언트 비밀을 받아야 합니다. SDK가 이를 자동으로 액세스 토큰으로 교환합니다.

변환 옵션에 대한 자세한 내용을 어디서 찾을 수 있나요?
공식 문서는 Aspose.Cells Cloud SDK for Node.js Documentation를, API 참조는 Aspose.Cells API Reference를 확인하십시오.

Read More