Кроки для зміни орієнтації сторінки Word у Node.JS

1. Встановіть SDK та налаштуйте облікові дані: Використовуйте npm, щоб додати бібліотеку та налаштувати ваш client ID і secret.

   npm install groupdocs-merger-cloud
   

2. Створіть екземпляр 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);
   

3. Створіть параметри запиту: Визначте вихідний файл, діапазон сторінок, потрібну орієнтацію та шлях виводу.

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';

4. Виконайте зміну орієнтації: Надішліть запит і обробіть відповідь.

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);
    });

5. (Опційно) Налаштуйте додаткові параметри: Ви можете змінити масив pages, щоб орієнтуватися на конкретні сторінки або перемкнути orientation enum на Portrait для іншого макету.

Зміна орієнтації сторінки Word – повний приклад коду

Наступний приклад демонструє повний процес зміни орієнтації файлу DOCX за допомогою GroupDocs.Merger Cloud SDK для 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‑endpoint’ів GroupDocs.Merger Cloud.

1. Отримайте токен доступу

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.

2. Завантажте вихідний файл 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"

3. Запит зміни орієнтації

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"
         }'

4. Завантажте отриманий файл

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 ви готові розширювати свої додатки гнучкими можливостями маніпулювання документами.

Питання та відповіді

• Як змінити орієнтацію сторінки у документах Word за допомогою Node.js?
  Використовуйте ChangePageOrientationApi з GroupDocs.Merger Cloud SDK for Node.js, встановіть потрібну orientation у параметрах запиту та виконайте виклик API.

• Чи існує спосіб експортувати орієнтацію сторінки Word у Node.JS без написання коду?
  Так, ту ж операцію можна виконати через REST API, використовуючи команди cURL, що корисно для швидких скриптів або інтеграції з іншими системами.

• Які орієнтації підтримуються для документів Word?
  SDK підтримує як Portrait, так і Landscape режими через Orientation enum. Ви також можете вказати діапазони сторінок, щоб застосувати зміну вибірково.

• Чи потрібна ліцензія для запуску в продакшн?
  Дійсна ліцензія потрібна для розгортання в продакшн. Ви можете розпочати з тимчасової ліцензії на сторінці тимчасової ліцензії і оновити до повної ліцензії, коли ваші потреби зростатимуть.

Read More

• Захист ZIP‑файлу паролем за допомогою програмного забезпечення для захисту паролем
• Захист Excel паролем за допомогою сервісу захисту паролем
• Як об’єднати кілька документів Word у Node.JS