Перетворення макету 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, щоб орієнтуватися на конкретні сторінки або перемкнутиorientationenum на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.
- Отримайте токен доступу
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 ви готові розширювати свої додатки гнучкими можливостями маніпулювання документами.
Питання та відповіді
Як змінити орієнтацію сторінки у документах Word за допомогою Node.js?
ВикористовуйтеChangePageOrientationApiз GroupDocs.Merger Cloud SDK for Node.js, встановіть потрібнуorientationу параметрах запиту та виконайте виклик API.Чи існує спосіб експортувати орієнтацію сторінки Word у Node.JS без написання коду?
Так, ту ж операцію можна виконати через REST API, використовуючи команди cURL, що корисно для швидких скриптів або інтеграції з іншими системами.Які орієнтації підтримуються для документів Word?
SDK підтримує якPortrait, так іLandscapeрежими черезOrientationenum. Ви також можете вказати діапазони сторінок, щоб застосувати зміну вибірково.Чи потрібна ліцензія для запуску в продакшн?
Дійсна ліцензія потрібна для розгортання в продакшн. Ви можете розпочати з тимчасової ліцензії на сторінці тимчасової ліцензії і оновити до повної ліцензії, коли ваші потреби зростатимуть.