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 アプリケーションにページ向きの変更を統合できます。

Wordページの向きをNode.JSで変換する手順

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）を実際の場所に合わせて更新し、すべての必須依存関係が正しくインストールされていることを確認し、開発環境で徹底的にテストしてください。問題が発生した場合は、公式ドキュメントまたはサポートチームにお問い合わせください。

cURL を使用した REST API でページの向きを変更する

純粋な 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 - 影響を与えるページを定義します（例: 最初の5ページの場合は ['1-5']）。
```
options.pages = ['1-5'];
```
orientation - GroupDocsMergerCloud.Orientation.Portrait または Landscape を選択します。
```
options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
```
outputPath - クラウドストレージ内の保存先パスを指定します。
```
options.outputPath = 'converted/output.docx';
```

これらのオプションは、ChangePageOrientationOptions クラスの一部であり、API リファレンスに記載されています。

結論

Word ファイルのレイアウトをプログラムで変更することは、GroupDocs.Merger Cloud SDK for Node.js を使用すれば簡単です。上記の手順に従うことで、Node.JS で Word ページの向きを変換 でき、バルク処理を自動化し、任意のドキュメントワークフローに向きの変更を組み込むことができます。本番環境で使用するために適切なライセンスを取得することを忘れないでください。価格の詳細は製品ページに掲載されており、一時ライセンスページから一時ライセンスを取得できます。 SDK をインストールし設定すれば、柔軟なドキュメント操作機能でアプリケーションを強化する準備が整います。

よくある質問

Node.js を使用して Word ドキュメントのページ向きを変更するにはどうすればよいですか？
Node.js 用の GroupDocs.Merger Cloud SDK for Node.js の ChangePageOrientationApi を使用し、リクエストオプションで目的の orientation を設定して、API 呼び出しを実行します。
Node.JSでコードを書かずにWordページの向きをエクスポートする方法はありますか？
同じ操作はREST APIを使用してcURLコマンドで実行でき、クイックスクリプトや他のシステムとの統合に便利です。
Word ドキュメントでサポートされている向きは何ですか？
SDK は Orientation 列挙体を介して Portrait と Landscape の両方のモードをサポートしています。ページ範囲を指定して変更を選択的に適用することもできます。
本番環境で実行するにはライセンスが必要ですか？
本番環境へのデプロイには有効なライセンスが必要です。使用量が増えるにつれて、一時ライセンスページから一時ライセンスを取得し、フルライセンスにアップグレードできます。

nodejs word processing on Document Processing REST APIs | GroupDocs Cloud