在 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 添加庫並設置您的 client ID 和 secret。
```
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);

如果需要特定版本，請從發行頁面下載最新的庫。確保您的環境運行 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';
```

這些選項是 ChangePageOrientationOptions 類別的一部分，該類別在 API 參考中有文件說明。

結論

以程式方式變更 Word 檔案的版面配置相當簡單，只需使用 GroupDocs.Merger Cloud SDK for Node.js。遵循上述步驟，即可 在 Node.JS 中轉換 Word 頁面方向，自動化批量處理，並將方向變更整合到任何文件工作流程中。請務必為正式環境取得適當的授權；產品頁面上提供了價格資訊，您也可以從臨時授權頁面取得臨時授權。安裝並設定好 SDK 後，即可在應用程式中加入彈性的文件操作功能。

FAQs

如何在 Node.js 中更改 Word 文件的頁面方向？
使用來自 GroupDocs.Merger Cloud SDK for Node.js 的 ChangePageOrientationApi，在請求選項中設定所需的 orientation，然後執行 API 呼叫。
是否有辦法在 Node.JS 中匯出 Word 頁面方向而不需要編寫程式碼？
是的，可以透過使用 cURL 命令的 REST API 來執行相同的操作，這對於快速腳本或與其他系統的整合非常有用。
支援哪些 Word 文件的方向？
SDK 透過 Orientation 列舉支援 Portrait 與 Landscape 兩種模式。您也可以指定頁面範圍以選擇性套用變更。
我需要許可證才能在生產環境中運行嗎？
有效的許可證是生產部署的必要條件。您可以從臨時許可證頁面開始使用臨時許可證，隨著使用量的增長再升級為完整許可證。

nodejs word processing on Document Processing REST APIs | GroupDocs Cloud

在 Node.JS 中轉換 Word 頁面方向