Các bước chuyển đổi định hướng trang Word trong Node.JS

1. 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-cloud
   

2. Tạo thể hiện API: Khởi tạo ChangePageOrientationApi vớ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);
   

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

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

5. (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 enum orientation sang Portrait để 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.

1. 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.

2. 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"

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

4. 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.Portrait hoặc Landscape.

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ụng ChangePageOrientationApi từ GroupDocs.Merger Cloud SDK for Node.js, đặt orientation mong 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ế độ Portrait và Landscape thông qua enum Orientation. 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.

Read More

• Bảo vệ tệp ZIP bằng mật khẩu sử dụng phần mềm bảo vệ mật khẩu
• Bảo vệ Excel bằng mật khẩu sử dụng dịch vụ bảo vệ mật khẩu
• Cách kết hợp nhiều tài liệu Word trong Node.JS