Tính năng Page Builder chuyển đổi việc hợp nhất tài liệu bằng cách cho phép người dùng kết hợp các trang từ các tài liệu khác nhau một cách liền mạch với độ chính xác và dễ dàng. Nó cho phép hợp nhất các trang theo bất kỳ thứ tự nào, mang lại quyền kiểm soát hoàn toàn về cấu trúc của tài liệu cuối cùng. Dù là hợp nhất một vài trang chính hay tạo ra một tài liệu toàn diện, công cụ này đảm bảo tính linh hoạt và hiệu quả. Bằng cách giảm bớt nỗ lực thủ công, nó đơn giản hóa quy trình tạo ra các tài liệu tùy chỉnh, tiết kiệm thời gian quý báu và tăng cường năng suất tổng thể trong cả quy trình làm việc cá nhân và chuyên nghiệp.

Page Builder - cách hợp nhất các trang từ tài liệu

Các chủ đề sau đây được thảo luận ở đây:

Nếu bạn quan tâm đến Merging documents online, hãy truy cập Online Merging Tool được cung cấp bởi GroupDocs.

Hiểu về Trình xây dựng trang

Tính năng Trình xây dựng Trang giới thiệu một cách tiếp cận tinh gọn để tạo tài liệu tùy chỉnh bằng cách kết hợp các trang từ nhiều tài liệu nguồn khác nhau. Tính năng này cho phép các nhà phát triển xây dựng một tài liệu mới từng bước, thêm các trang theo bất kỳ thứ tự nào từ hai tài liệu trở lên. Đây là cách mà quy trình hoạt động:

  • Bắt đầu bằng cách tải tài liệu Word nguồn sử dụng lớp Merger và truyền cho bộ xây dựng một trong các tài liệu nguồn.
  • Join the documents one by one to merge using the Join method.
  • Khởi tạo Page Builder. Qua phương thức CreatePageBuilder từ thể hiện Merger Đây là điểm khởi đầu để xây dựng tài liệu mới của bạn.
  • Phương thức AddPage của thể hiện Page Builder cho phép thêm vào tài liệu đích bất kỳ trang nào của các tài liệu đã được liên kết trước đó.
  • chọn các trang cụ thể mà bạn muốn đưa vào quản lý danh mục cho mọi tài liệu nguồn;
  • add these pages to the new document in the desired sequence. You can mix and match pages from different documents to meet your needs;
  • lặp lại quá trình này cho các tài liệu nguồn bổ sung, đảm bảo rằng bạn có sự linh hoạt để kết hợp các trang theo cách phù hợp nhất với yêu cầu của bạn;
  • Sử dụng ApplyPageBuilder phương pháp để áp dụng các thay đổi từ phiên bản Page Builder
  • Lưu tài liệu đã hợp nhất đến bất kỳ đích đến nào. Sau khi tất cả các trang cần thiết đã được thêm vào, hãy lưu tài liệu mới. Đầu ra cuối cùng sẽ là một tệp hoàn toàn tùy chỉnh chứa các trang từ nhiều nguồn, được tổ chức chính xác như bạn muốn.

Cách tiếp cận từng bước này giúp dễ dàng tạo ra các tài liệu được điều chỉnh cho các trường hợp sử dụng cụ thể, chẳng hạn như biên soạn báo cáo, tạo các bài thuyết trình cá nhân hóa, hoặc lắp ráp các tài liệu pháp lý. Với Page Builder, các nhà phát triển có toàn quyền kiểm soát thứ tự và nội dung trang, loại bỏ sự cần thiết cho các chỉnh sửa thủ công tốn thời gian và đảm bảo độ chính xác trong đầu ra cuối cùng.

Sample case and code implementation

Hãy chứng minh cách sử dụng tính năng Page Builder trong GroupDocs.Merger với một ví dụ thực tế. Để đơn giản hóa trường hợp, giả sử chúng ta có hai tài liệu:

  • Document A với 4 trang.
  • Document B với 4 trang.

Chúng tôi nhằm tạo một tài liệu mới bằng cách hợp nhất các trang từ hai tài liệu này theo những trình tự khác nhau dựa trên các kịch bản cụ thể.

Page Builder - Cấu trúc tài liệu A và B mẫu với 4 trang mỗi tài liệu

Ở đây chúng tôi đã đánh dấu mỗi trang tài liệu bằng chữ cái A, B và số trang. Từ tài liệu A và B, chúng tôi cần nhận tài liệu C được tùy chỉnh với cấu trúc sau

Page Builder - Cấu trúc tài liệu A và B mẫu với 4 trang mỗi tài liệu

Đoạn mã nguồn sau đây cho thấy cách hợp nhất các trang cụ thể từ nhiều tài liệu trong tài liệu kết quả.

string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
    // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    
    pageBuilder.AddPage(docA.Pages[0]); // document A, page 1 or Page A-1
    pageBuilder.AddPage(docB.Pages[0]); // document B, page 1 or Page B-1
    pageBuilder.AddPage(docB.Pages[1]); // document B, page 2 or Page B-2
    pageBuilder.AddPage(docB.Pages[2]); // document B, page 3 or Page B-3
    pageBuilder.AddPage(docA.Pages[1]); // document A, page 2 or Page A-2
    pageBuilder.AddPage(docA.Pages[3]); // document A, page 4 or Page A-4
    
    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

Chỉ định phạm vi của các trang cần thiết

Khi làm việc với thao tác tài liệu, việc thêm nhiều trang một cách hiệu quả là rất quan trọng để xử lý các quy trình phức tạp. Thay vì thêm các trang một cách riêng lẻ, bạn có thể sử dụng phương thức AddPageRange, phương thức này chấp nhận một mảng các đối tượng IPageInfo, mỗi đối tượng đại diện cho một trang cụ thể. Cách tiếp cận này đơn giản hóa quy trình, giảm mã lặp lại và cải thiện hiệu suất bằng cách cho phép các thao tác theo lô. Dưới đây là một ví dụ về mã minh họa cách sử dụng phương thức này để thêm nhiều trang từ các tài liệu khác nhau trong một thao tác duy nhất, hợp nhất.

Dưới đây là các bước để kết hợp một số trang từ nhiều tài liệu khác nhau xác định chúng là một khoảng:

  • Tạo một Merger đối tượng và cung cấp đường dẫn hoặc luồng của tệp nguồn.
  • Sử dụng Join để thêm một tài liệu nguồn khác. Lặp lại bước này cho mỗi tài liệu bạn muốn sáp nhập.
  • Tạo một PageBuilder đối tượng bằng cách gọi phương thức CreatePageBuilder.
  • Gọi phương thức AddPageRange và truyền một mảng các đối tượng IPageInfo mô tả các trang thích hợp. Xin lưu ý rằng các đối tượng IPageInfo sử dụng ký hiệu bắt đầu từ 0 cho tài liệu nguồn và số trang.
  • Sử dụng phương thức ApplyPageBuilder để áp dụng thứ tự trang đã chỉ định cho tài liệu đã gộp.
  • Lưu tài liệu kết quả bằng cách gọi phương thức Save và cung cấp một đường dẫn tệp.
string documentA = @"documentA.pdf";
string documentB = @"documentB.pdf";
string documentC = @"documentC.pdf";

using (Merger merger = new Merger(documentA))
{
    merger.Join(documentB);

    PageBuilder pageBuilder = merger.CreatePageBuilder();
     // get documents A and B references
    var docA = pageBuilder.Documents[0];
    var docB = pageBuilder.Documents[1];
    // Specify a range of pages
    IPageInfo[] range = new IPageInfo[] {
        docA.Pages[0], // Page A-1 from the document A
        docB.Pages[0], // Page B-1 from the document B
        docB.Pages[1], // Page B-2 from the document B
        docB.Pages[2], // Page B-3 from the document B
        docA.Pages[1], // Page A-2 from the document A
        docA.Pages[3], // Page A-4 from the document A                    
    };
    // Append a page of pages
    pageBuilder.AddPageRange(range);

    // Apply the page order
    merger.ApplyPageBuilder(pageBuilder);

    merger.Save(documentC);
}

Kết luận

Các ví dụ này minh họa sự linh hoạt của tính năng Page Builder. Các nhà phát triển có thể dễ dàng kết hợp các trang từ nhiều tài liệu trong nhiều trình tự khác nhau để tạo ra các kết quả tùy chỉnh. Tính năng này giảm thiểu đáng kể công việc thủ công và đảm bảo độ chính xác trong việc tạo tài liệu, biến nó thành một công cụ thiết yếu cho nhiều trường hợp sử dụng khác nhau.

Nhận Giấy phép API Miễn Phí

Bạn có thể get a free temporary license để sử dụng API mà không có các hạn chế đánh giá.

Tạo Ứng dụng Trình tạo Trang Ghép của Bạn

Dưới đây là một số liên kết quan trọng sẽ giúp bạn trong việc xây dựng ứng dụng so sánh tài liệu của riêng bạn.

Documentation | API Reference | Supported File Formats

Running Examples – GitHub | Free Support Forum | Release Notes

See Also

Để biết thêm thông tin và tài nguyên bổ sung, bạn có thể thấy các liên kết sau đây hữu ích: