Node.JS에서 CSV를 JPG로 변환

표 형식 데이터에서 미리보기 이미지를 생성하는 것은 대시보드나 이메일 보고서를 만들 때 흔히 요구되는 작업입니다. GroupDocs.Conversion Cloud SDK for Node.js는 서버 측에서 CSV 파일을 고품질 JPG 이미지로 변환할 수 있는 강력한 API를 제공합니다. 이 문서에서는 라이브러리의 비동기 메서드를 사용하여 Node.JS에서 CSV를 JPG로 변환하는 방법을 배우고, 전체 코드 예제를 확인하며, 동등한 cURL 호출을 살펴보고, 출력물을 미세 조정하기 위한 구성 옵션을 알아봅니다.

Node.JS에서 CSV를 JPG로 변환 - 전체 코드 예제

이 예제에서는 라이브러리의 비동기 API를 사용하여 GroupDocs Cloud 스토리지에 저장된 CSV 파일을 JPG 이미지로 변환하는 방법을 보여줍니다.

const { ConvertApi, ConvertSettings, ConvertOptions, FileInfo } = require("@groupdocs/conversion-cloud");

// Replace with your actual GroupDocs Cloud credentials
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

async function convertCsvToJpg() {
    // Initialize the Conversion API
    const convertApi = new ConvertApi(clientId, clientSecret);

// Source CSV file stored in GroupDocs Cloud storage
    const fileInfo = new FileInfo();
    fileInfo.filePath = "input.csv";

// Conversion options: CSV -> JPG
    const convertOptions = new ConvertOptions();
    convertOptions.fileInfo = fileInfo;
    convertOptions.format = "jpg";

// Conversion settings (output folder in storage)
    const convertSettings = new ConvertSettings();
    convertSettings.outputPath = "output_images";
    convertSettings.convertOptions = [convertOptions];

try {
        const result = await convertApi.convertDocument(convertSettings);
        console.log("Conversion completed. Generated files:");
        result.forEach(file => console.log(file.path));
    } catch (err) {
        console.error("Conversion failed:", err);
    }
}

convertCsvToJpg();

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

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

순수 REST 방식을 선호한다면, 동일한 변환을 일련의 cURL 명령으로 수행할 수 있습니다.

액세스 토큰 얻기 - 클라이언트 자격 증명으로 인증합니다.

curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d '{"client_id":"YOUR_CLIENT_ID","client_secret":"YOUR_CLIENT_SECRET"}'

소스 CSV 업로드 - 파일을 GroupDocs Cloud 스토리지에 배치합니다.

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/upload?path=input.csv" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@/path/to/your/input.csv"

변환 요청 - 대상 형식을 JPG로 지정합니다.

curl -X POST "https://api.groupdocs.cloud/v2.0/conversion/convert?format=jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"fileInfo":{"filePath":"input.csv"}}'

생성된 이미지(들) 다운로드 - 출력 폴더에서 파일을 가져옵니다.

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/download?path=output_images/your_image.jpg" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o your_image.jpg

이 명령은 코드를 작성하지 않고도 전체 CSV‑to‑JPG 워크플로를 보여줍니다. 자세한 내용은 공식 API 문서를 참조하십시오.

Node.JS에서 CSV를 JPG로 변환하는 과정 이해하기

아래는 앞에서 보여준 코드의 단계별 분석입니다:

API 클라이언트 초기화 - new ConvertApi(clientId, clientSecret) 은 인증된 세션을 생성합니다.

const convertApi = new ConvertApi(clientId, clientSecret);

소스 파일 정의 - FileInfo 객체는 GroupDocs Cloud에 저장된 input.csv를 가리킵니다.

const fileInfo = new FileInfo();
fileInfo.filePath = "input.csv";

변환 옵션 설정 - ConvertOptions.format = "jpg" 은 서비스에 JPG 출력물을 생성하도록 지시합니다.

const convertOptions = new ConvertOptions();
convertOptions.fileInfo = fileInfo;
convertOptions.format = "jpg";

출력 설정 구성 - ConvertSettings.outputPath는 이미지가 저장될 위치를 결정합니다.

const convertSettings = new ConvertSettings();
convertSettings.outputPath = "output_images";
convertSettings.convertOptions = [convertOptions];

변환 실행 - convertApi.convertDocument(convertSettings)는 요청을 보내고 생성된 파일 경로 배열을 반환합니다.

const result = await convertApi.convertDocument(convertSettings);

전체 클래스 및 속성 목록은 API 참조를 참조하십시오.

필수 조건 및 설정

Node.js runtime - 버전 12 이상이 필요합니다.
GroupDocs Cloud account - GroupDocs 포털에서 clientId와 clientSecret을 얻으세요.
Install the SDK - 다음 명령을 실행하세요 (공식 릴리스 페이지에서 패키지를 다운로드).

npm install groupdocs-conversion-cloud

SDK 가져오기 프로젝트에:

const { ConvertApi, ConvertSettings, ConvertOptions, FileInfo } = require("@groupdocs/conversion-cloud");

설치에 대한 자세한 내용은 다운로드 페이지를 참조하십시오.

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

SDK는 조정할 수 있는 여러 속성을 제공합니다:

Output Path - JPG 파일이 저장되는 폴더를 제어합니다.

convertSettings.outputPath = "output_images";

대상 형식 - “jpg"를 “jpeg"로 변경하면 JPEG 변형이 필요합니다.

convertOptions.format = "jpeg";

맞춤 차원 - 지원되는 경우 너비와 높이를 지정하여 정확한 크기의 이미지를 생성할 수 있습니다.

convertOptions.width = 800;   // example width in pixels
convertOptions.height = 600;  // example height in pixels

비동기 실행 - SDK 메서드는 프로미스를 반환하여 이벤트 루프를 차단하지 않고 비동기 워크플로에 변환을 통합할 수 있게 합니다.

await convertApi.convertDocument(convertSettings);

이 옵션을 사용하면 CSV‑to‑JPG 워크플로를 특정 자동화 또는 통합 요구 사항에 맞게 조정할 수 있습니다.

결론

Node.JS에서 CSV를 JPG로 변환하는 것은 GroupDocs.Conversion Cloud SDK for Node.js를 사용하면 간단합니다. 이 라이브러리는 클라우드에서 무거운 작업을 처리해 주어 비즈니스 로직 및 통합에 집중할 수 있게 합니다. 클라우드 자격 증명을 안전하게 보호하고, 적절한 출력 형식(JPG 또는 JPEG)을 선택하며, 워크플로에 맞게 차원이나 출력 경로와 같은 설정을 조정하는 것을 기억하세요. 프로덕션 배포를 위해서는 유료 라이선스가 필요합니다; 가격 세부 정보를 확인하고 임시 라이선스 페이지에서 임시 라이선스를 얻을 수 있습니다. 제공된 코드와 cURL 예제를 사용하면 CSV‑to‑JPG 자동화를 모든 백엔드 서비스에 추가할 준비가 된 것입니다.

자주 묻는 질문

Node.JS에서 사용자 정의 파싱 로직을 작성하지 않고 CSV를 JPG로 변환하려면 어떻게 해야 하나요?
SDK는 CSV를 GroupDocs Cloud 스토리지에서 직접 읽어 각 행을 이미지로 렌더링하므로 외부 도구가 필요하지 않습니다. 코드 예제 또는 cURL 워크플로를 따라하면 됩니다.
CSV를 JPEG가 아니라 JPG로 백엔드에서 변환할 수 있나요?
예. 코드에서 convertOptions.format = "jpeg"을 설정하거나 REST 요청에 format=jpeg를 사용하십시오. 두 형식 모두 Node.JS에서 백엔드 변환을 지원합니다.
변환을 비동기적으로 실행하여 서버가 차단되는 것을 방지할 수 있나요?
물론입니다. 모든 SDK 메서드는 프로미스를 반환하므로 await을 사용하거나 .then() 핸들러를 연결할 수 있습니다. 이를 통해 논블로킹이며 확장 가능한 CSV‑to‑JPG 자동화를 구현할 수 있습니다.
CSV를 이미지로 변환하는 추가 예제는 어디서 찾을 수 있나요?
공식 문서에는 추가 샘플이 포함되어 있으며, 커뮤니티 포럼인 GroupDocs Conversion Forum은 질문하기에 좋은 장소입니다.

Node.JS에서 CSV를 JPG로 변환 - 전체 코드 예제#

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

Node.JS에서 CSV를 JPG로 변환하는 과정 이해하기#

필수 조건 및 설정#

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

결론#

자주 묻는 질문#

Read More#