Node.JS에서 Word 페이지 방향 변환

Wed, 26 Aug 2026 08:28:34 +0000

보고서, 계약서 또는 인쇄 가능한 브로셔를 생성할 때 Word 문서의 레이아웃을 변환하는 경우가 자주 발생합니다. GroupDocs.Merger Cloud SDK for Node.js는 개발자가 몇 줄의 코드만으로 프로그래밍 방식으로 Node.JS에서 Word 페이지 방향을 변환할 수 있게 합니다. 이 가이드는 필요한 단계들을 안내하고, 완전한 작업 예제를 보여주며, 동등한 cURL 호출을 시연하고, 설치 및 구성 방법을 설명하여 페이지 방향 변경을 Node.js 애플리케이션에 통합할 수 있도록 도와줍니다.

Node.JS에서 Word 페이지 방향을 변환하는 단계

SDK를 설치하고 자격 증명을 구성합니다: npm을 사용하여 라이브러리를 추가하고 클라이언트 ID와 비밀 키를 설정합니다.
```
npm install groupdocs-merger-cloud
```
API 인스턴스 생성: ChangePageOrientationApi를 구성 객체와 함께 초기화합니다.

const GroupDocsMergerCloud = require('groupdocs-merger-cloud');
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);
const orientationApi = new GroupDocsMergerCloud.ChangePageOrientationApi(config);

요청 옵션 만들기: 소스 파일, 페이지 범위, 원하는 방향 및 출력 경로를 정의합니다.

const options = new GroupDocsMergerCloud.ChangePageOrientationOptions();
options.fileInfo = new GroupDocsMergerCloud.FileInfo();
options.fileInfo.filePath = 'input.docx';
options.pages = ['1-']; // all pages
options.orientation = GroupDocsMergerCloud.Orientation.Landscape; // or Portrait
options.outputPath = 'output.docx';

방향 변경 실행: 요청을 보내고 응답을 처리합니다.

const request = new GroupDocsMergerCloud.ChangePageOrientationRequest(options);
orientationApi.changePageOrientation(request)
    .then(response => {
        console.log('Page orientation conversion completed.');
        console.log('Output stored at:', response.path);
    })
    .catch(error => {
        console.error('Error during orientation conversion:', error);
    });

(선택 사항) 추가 설정 조정: pages 배열을 수정하여 특정 페이지를 대상으로 하거나 orientation 열거형을 Portrait 로 전환하여 다른 레이아웃을 적용할 수 있습니다.

Word 페이지 방향 변경 - 전체 코드 예제

다음 예제는 GroupDocs.Merger Cloud SDK for Node.js를 사용하여 DOCX 파일의 방향을 변경하는 전체 워크플로를 보여줍니다.

const GroupDocsMergerCloud = require('groupdocs-merger-cloud');

// ==== Configuration ====
// Replace with your actual credentials
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

// ==== API Instance ====
const orientationApi = new GroupDocsMergerCloud.ChangePageOrientationApi(config);

// ==== Request Construction ====
const options = new GroupDocsMergerCloud.ChangePageOrientationOptions();
options.fileInfo = new GroupDocsMergerCloud.FileInfo();
options.fileInfo.filePath = 'input.docx';               // source Word document
options.pages = ['1-'];                                 // apply to all pages (1 to end)
options.orientation = GroupDocsMergerCloud.Orientation.Landscape; // Portrait or Landscape
options.outputPath = 'output.docx';                     // destination file

const request = new GroupDocsMergerCloud.ChangePageOrientationRequest(options);

// ==== Execution ====
orientationApi.changePageOrientation(request)
    .then(response => {
        console.log('Page orientation conversion completed.');
        console.log('Output stored at:', response.path);
    })
    .catch(error => {
        console.error('Error during orientation conversion:', error);
    });

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

Changing Page Orientation via REST API with cURL

순수 HTTP 방식을 선호한다면, 동일한 작업을 GroupDocs.Merger Cloud REST 엔드포인트에 대한 cURL 명령으로 수행할 수 있습니다.

액세스 토큰 얻기

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

응답에 access_token이 포함됩니다.

소스 DOCX 파일 업로드

curl -X POST "https://api.groupdocs.cloud/v1.0/merger/storage/upload" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@input.docx" \
        -F "path=/input.docx"

요청 방향 변경

curl -X POST "https://api.groupdocs.cloud/v1.0/merger/words/changePageOrientation" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "/input.docx" },
           "pages": ["1-"],
           "orientation": "Landscape",
           "outputPath": "/output.docx"
         }'

결과 파일 다운로드

curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.docx

요청 페이로드 및 지원되는 매개변수에 대한 자세한 내용은 공식 API 문서를 참조하십시오.

GroupDocs.Merger Cloud SDK for Node.js 설치 및 구성

시작하려면 npm에서 패키지를 설치하고 자격 증명을 구성합니다.

npm install groupdocs-merger-cloud

const GroupDocsMergerCloud = require('groupdocs-merger-cloud');
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const config = new GroupDocsMergerCloud.Configuration(clientId, clientSecret);

특정 버전이 필요한 경우 최신 라이브러리를 release page에서 다운로드하십시오. 환경이 Node.js 12 이상에서 실행되고 유효한 GroupDocs Cloud 계정이 있는지 확인하십시오.

페이지 방향 옵션 구성

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

pages - 영향을 줄 페이지를 정의합니다 (예: 처음 다섯 페이지에 대해 ['1-5']).

options.pages = ['1-5'];

orientation - GroupDocsMergerCloud.Orientation.Portrait 또는 Landscape 중 선택합니다.

options.orientation = GroupDocsMergerCloud.Orientation.Portrait;

outputPath - 클라우드 스토리지의 대상 경로를 지정합니다.

options.outputPath = 'converted/output.docx';

이 옵션은 API 참조에 문서화된 ChangePageOrientationOptions 클래스의 일부입니다.

결론

Word 파일의 레이아웃을 프로그래밍 방식으로 변경하는 것은 GroupDocs.Merger Cloud SDK for Node.js를 사용하면 간단합니다. 위 단계들을 따라 하면 Node.JS에서 Word 페이지 방향을 변환하고, 대량 처리를 자동화하며, 문서 워크플로우에 방향 변경을 통합할 수 있습니다. 프로덕션 사용을 위해 적절한 라이선스를 확보하는 것을 기억하세요; 가격 세부 정보는 제품 페이지에서 확인할 수 있으며, 임시 라이선스 페이지에서 임시 라이선스를 얻을 수 있습니다. SDK가 설치되고 구성되면 유연한 문서 조작 기능으로 애플리케이션을 강화할 준비가 된 것입니다.

FAQs

Node.js를 사용하여 Word 문서에서 페이지 방향을 어떻게 변경합니까?
ChangePageOrientationApi를 GroupDocs.Merger Cloud SDK for Node.js에서 사용하고, 요청 옵션에서 원하는 orientation을 설정한 뒤 API 호출을 실행합니다.
Node.JS에서 코드를 작성하지 않고 Word 페이지 방향을 내보내는 방법이 있나요?
예, 동일한 작업을 REST API를 통해 cURL 명령으로 수행할 수 있으며, 이는 빠른 스크립트나 다른 시스템과의 통합에 유용합니다.
Word 문서에서 지원되는 방향은 무엇인가요?
SDK는 Portrait 및 Landscape 모드를 Orientation 열거형을 통해 지원합니다. 또한 페이지 범위를 지정하여 변경을 선택적으로 적용할 수 있습니다.
프로덕션에서 실행하려면 라이선스가 필요합니까?
프로덕션 배포에는 유효한 라이선스가 필요합니다. 임시 라이선스 페이지에서 임시 라이선스로 시작하고, 사용량이 증가함에 따라 정식 라이선스로 업그레이드할 수 있습니다.

nodejs word processing on Document Processing REST APIs | GroupDocs Cloud