Chuyển đổi bố cục của tài liệu Word là một nhu cầu thường gặp khi tạo báo cáo, hợp đồng hoặc tờ rơi có thể in. GroupDocs.Merger Cloud SDK for Node.js cho phép các nhà phát triển chuyển đổi Định hướng trang Word trong Node.JS một cách lập trình với chỉ vài dòng mã. Hướng dẫn này sẽ đưa bạn qua các bước cần thiết, hiển thị một ví dụ hoàn chỉnh hoạt động, trình bày các lệnh cURL tương đương, và giải thích cách cài đặt và cấu hình để bạn có thể tích hợp việc thay đổi định hướng trang vào các ứng dụng Node.js của mình.
Các bước chuyển đổi định hướng trang Word trong Node.JS
Cài đặt SDK và cấu hình thông tin xác thực: Sử dụng npm để thêm thư viện và thiết lập client ID và secret của bạn.
npm install groupdocs-merger-cloudTạo thể hiện API: Khởi tạo
ChangePageOrientationApivới đối tượng cấu hình.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);Xây dựng các tùy chọn yêu cầu: Xác định tệp nguồn, phạm vi trang, hướng mong muốn và đường dẫn đầu ra.
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';
- Thực hiện việc thay đổi hướng trang: Gửi yêu cầu và xử lý phản hồi.
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);
});
- (Tùy chọn) Điều chỉnh cài đặt bổ sung: Bạn có thể sửa đổi mảng
pagesđể nhắm mục tiêu các trang cụ thể hoặc chuyển enumorientationsangPortraitđể có bố cục khác.
Thay đổi hướng trang Word - Ví dụ mã hoàn chỉnh
Ví dụ sau đây trình bày quy trình đầy đủ để thay đổi hướng của tệp DOCX bằng cách sử dụng GroupDocs.Merger Cloud SDK cho 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);
});
Ghi chú: Ví dụ mã này minh họa chức năng cốt lõi. Trước khi sử dụng trong dự án của bạn, hãy chắc chắn cập nhật các đường dẫn tệp (
input.docx,output.docx) để phù hợp với vị trí tệp thực tế của bạn, xác minh rằng tất cả các phụ thuộc cần thiết đã được cài đặt đúng cách, và kiểm tra kỹ lưỡng trong môi trường phát triển của bạn. Nếu bạn gặp bất kỳ vấn đề nào, vui lòng tham khảo tài liệu chính thức hoặc liên hệ với đội hỗ trợ để được trợ giúp.
Thay đổi hướng trang qua REST API với cURL
Nếu bạn thích một cách tiếp cận thuần HTTP, cùng một thao tác có thể được thực hiện bằng các lệnh cURL đối với các endpoint REST của GroupDocs.Merger Cloud.
- Lấy token truy cập
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"}'
Phản hồi chứa access_token.
- Tải lên tệp DOCX nguồn
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"
- Yêu cầu thay đổi hướng trang
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"
}'
- Tải xuống tệp kết quả
curl -X GET "https://api.groupdocs.cloud/v1.0/merger/storage/download?path=/output.docx" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o output.docx
Để biết thêm chi tiết về payload yêu cầu và các tham số được hỗ trợ, xem tài liệu API chính thức.
Cài đặt và cấu hình GroupDocs.Merger Cloud SDK for Node.js
Để bắt đầu, hãy cài đặt gói từ npm và cấu hình thông tin xác thực của bạn.
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);
Tải xuống thư viện mới nhất từ trang phát hành nếu bạn cần một phiên bản cụ thể. Đảm bảo môi trường của bạn chạy Node.js 12 hoặc cao hơn và bạn có tài khoản GroupDocs Cloud hợp lệ.
Cấu hình các tùy chọn hướng trang
SDK cung cấp một số thuộc tính mà bạn có thể điều chỉnh:
- pages - Xác định các trang cần áp dụng (ví dụ,
['1-5']cho năm trang đầu tiên).
options.pages = ['1-5'];
- orientation - Chọn
GroupDocsMergerCloud.Orientation.PortraithoặcLandscape.
options.orientation = GroupDocsMergerCloud.Orientation.Portrait;
- outputPath - Chỉ định đường dẫn đích trong bộ nhớ đám mây của bạn.
options.outputPath = 'converted/output.docx';
Các tùy chọn này là một phần của lớp ChangePageOrientationOptions được ghi trong tài liệu API.
Kết luận
Việc thay đổi bố cục của các tệp Word một cách lập trình là đơn giản với GroupDocs.Merger Cloud SDK for Node.js. Bằng cách làm theo các bước ở trên, bạn có thể chuyển đổi hướng trang Word trong Node.JS, tự động hoá xử lý hàng loạt và tích hợp các thay đổi hướng vào bất kỳ quy trình làm việc tài liệu nào. Hãy nhớ đảm bảo có giấy phép phù hợp cho việc sử dụng trong môi trường sản xuất; chi tiết giá cả có sẵn trên trang sản phẩm, và bạn có thể nhận giấy phép tạm thời từ trang giấy phép tạm thời. Với SDK đã được cài đặt và cấu hình, bạn đã sẵn sàng nâng cao ứng dụng của mình với khả năng thao tác tài liệu linh hoạt.
FAQs
Làm thế nào để thay đổi hướng trang trong tài liệu Word bằng Node.js?
Sử dụngChangePageOrientationApitừ GroupDocs.Merger Cloud SDK for Node.js, đặtorientationmong muốn trong các tùy chọn yêu cầu và thực thi lời gọi API.Có cách nào để xuất hướng trang Word trong Node.JS mà không cần viết mã không?
Có, cùng một thao tác có thể được thực hiện qua REST API bằng các lệnh cURL, điều này hữu ích cho các script nhanh hoặc tích hợp với các hệ thống khác.What orientations are supported for Word documents?
SDK hỗ trợ cả chế độPortraitvàLandscapethông qua enumOrientation. Bạn cũng có thể chỉ định phạm vi trang để áp dụng thay đổi một cách chọn lọc.Tôi có cần giấy phép để chạy điều này trong môi trường sản xuất không?
Cần có giấy phép hợp lệ cho các triển khai trong môi trường sản xuất. Bạn có thể bắt đầu với giấy phép tạm thời từ trang giấy phép tạm thời và nâng cấp lên giấy phép đầy đủ khi nhu cầu sử dụng của bạn tăng lên.