Преобразовать ориентацию страницы Word в Node.JS

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

Преобразование макета документа Word часто требуется при создании отчетов, контрактов или печатных брошюр. GroupDocs.Merger Cloud SDK for Node.js позволяет разработчикам программно конвертировать ориентацию страниц Word в Node.JS всего несколькими строками кода. Это руководство проведёт вас через необходимые шаги, покажет полностью рабочий пример, продемонстрирует эквивалентные вызовы cURL и объяснит установку и настройку, чтобы вы могли интегрировать изменения ориентации страниц в свои приложения на Node.js.

Шаги по изменению ориентации страниц Word в Node.JS

Установите 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 - Полный пример кода

Следующий пример демонстрирует полный процесс изменения ориентации файла DOCX с использованием GroupDocs.Merger Cloud SDK for Node.js.

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) в соответствии с фактическим расположением, проверьте, что все необходимые зависимости правильно установлены, и тщательно протестируйте в вашей среде разработки. Если возникнут проблемы, обратитесь к официальной документации или свяжитесь с командой поддержки для получения помощи.

Изменение ориентации страницы через REST API с помощью cURL

Если вы предпочитаете чистый HTTP‑подход, ту же операцию можно выполнить с помощью команд cURL к REST‑конечным точкам GroupDocs.Merger Cloud.

Получите токен доступа

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. Следуя описанным выше шагам, вы можете конвертировать ориентацию страниц Word в Node.JS, автоматизировать массовую обработку и интегрировать изменения ориентации в любой документооборот. Не забудьте обеспечить наличие корректной лицензии для использования в продакшене; детали ценообразования доступны на странице продукта, а временную лицензию можно получить со страницы временной лицензии. После установки и настройки SDK вы готовы расширять свои приложения гибкими возможностями манипуляции документами.

FAQs

Как изменить ориентацию страницы в документах Word, используя Node.js?
Используйте ChangePageOrientationApi из GroupDocs.Merger Cloud SDK for Node.js, задайте нужную orientation в параметрах запроса и выполните вызов API.
Есть ли способ экспортировать ориентацию страниц Word в Node.JS без написания кода?
Да, ту же операцию можно выполнить через REST API, используя команды cURL, что удобно для быстрых скриптов или интеграции с другими системами.
Какие ориентации поддерживаются для документов Word?
SDK поддерживает как режимы Portrait, так и Landscape через перечисление Orientation. Вы также можете указать диапазоны страниц, чтобы применить изменение выборочно.
Нужна ли лицензия для запуска в продакшн?
Для развертываний в продакшн требуется действующая лицензия. Вы можете начать с временной лицензии со страницы временной лицензии и перейти на полную лицензию по мере роста использования.

page orientation conversion on Document Processing REST APIs | GroupDocs Cloud