Конструктор сторінок документів - як об'єднати певні сторінки документів

Функція Page Builder перетворює злиття документів, дозволяючи користувачам безшовно поєднувати сторінки з різних документів з точністю та легкістю. Вона дозволяє злиття сторінок у будь-якій послідовності, надаючи повний контроль над структурою фінального документа. Будь то злиття кількох ключових сторінок або створення всебічного документа, цей інструмент забезпечує гнучкість і ефективність. Завдяки зменшенню трудомісткості процесу, він спрощує процес створення індивідуалізованих документів, економлячи дорогоцінний час і підвищуючи загальну продуктивність як у особистих, так і в професійних робочих процесах.

Page Builder - як об'єднати сторінки з документів

Ось тут обговорюються такі теми:

Розуміння конструктора сторінок
Sample case and code implementation
Вказівка діапазону необхідних сторінок
Висновок

If you are interested in Merging documents online, visit the Online Merging Tool that is powered by GroupDocs.

Розуміння конструктора сторінок

Функція Page Builder вводить спрощений спосіб створення індивідуальних документів, поєднуючи сторінки з кількох вихідних документів. Ця функція дозволяє розробникам створювати новий документ крок за кроком, додаючи сторінки в будь-якій послідовності з двох або більше документів. Ось як працює процес:

Почніть з завантаження вихідного документу Word за допомогою класу Merger і передайте в конструктор один із вихідних документів.
Приєднайте документи один за одним для об’єднання, використовуючи метод Join.
Ініціалізуйте Page Builder. Використайте метод CreatePageBuilder з екземпляра Merger. Це слугує відправною точкою для створення нового документа.
Метод AddPage екземпляра Page Builder дозволяє додавати у цільовий документ будь-яку конкретну сторінку приєднаних документів раніше.
для кожного вихідного документа виберіть конкретні сторінки, які хочете включити в зміст;
додайте ці сторінки до нового документа в потрібній послідовності. Ви можете змішувати та поєднувати сторінки з різних документів, щоб задовольнити ваші потреби;
повторіть цей процес для додаткових вихідних документів, забезпечуючи собі гнучкість поєднувати сторінки так, щоб це найкраще відповідало вашим вимогам;
Використовуючи ApplyPageBuilder метод для застосування змін з екземпляра Page Builder
Збережіть об’єднаний документ у будь-яке місце призначення. Як тільки всі необхідні сторінки будуть додані, збережіть новий документ. Остаточний результат буде повністю налаштованим файлом, що містить сторінки з декількох джерел, організованими точно так, як ви хочете.

Цей покроковий підхід спрощує створення документів, адаптованих до конкретних випадків використання, таких як складання звітів, створення персоналізованих презентацій або складання юридичних документів. Завдяки Page Builder, розробники мають повний контроль над порядком сторінок і вмістом, усуваючи потребу в затратних за часом ручних змінах і забезпечуючи точність у фінальному результаті.

Приклади випадків та імплементація коду

Давайте продемонструємо, як використовувати функцію Page Builder у GroupDocs.Merger на практичному прикладі. Щоб спростити випадок, припустимо, що у нас є два документи:

Document A з 4 сторінок.
Document B з 4 сторінок.

Ми маємо на меті створити новий документ, об’єднуючи сторінки з цих двох документів в різних послідовностях на основі конкретних сценаріїв.

Page Builder - приклад структури документів A та B з 4 сторінками кожен

Тут ми позначили кожну сторінку документа літерами A, B та номером сторінки. З документів A та B нам потрібно отримати адаптований документ C з такою структурою

Наступний фрагмент вихідного коду демонструє, як об’єднати певні сторінки з кількох документів у підсумковому документі.

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

Вказуючи діапазон потрібних сторінок

Коли ви працюєте з маніпулюванням документами, ефективне додавання кількох сторінок є важливим для обробки складних робочих процесів. Замість того, щоб додавати сторінки поодинці, ви можете використовувати метод AddPageRange, який приймає масив об’єктів IPageInfo, кожен з яких представляє конкретну сторінку. Цей підхід спрощує процес, зменшує кількість повторюваного коду та покращує продуктивність, дозволяючи пакетні операції. Нижче наведено приклад коду, що демонструє, як використати цей метод для додавання кількох сторінок з різних документів в одну, спрощену операцію.

Ось кроки для об’єднання кількох сторінок з різних документів, вказуючи їх як діапазон:

Створіть об’єкт Merger і надайте шлях або потік вихідного файлу.
Використовуйте Join для додавання ще одного вихідного документа. Повторіть цей крок для кожного документа, який ви хочете об’єднати.
Створіть об’єкт PageBuilder, викликавши метод CreatePageBuilder.
Викликайте метод AddPageRange і передайте масив обєктів [IPageInfo][14], які описують відповідні сторінки. Зверніть увагу, що обєкти IPageInfo використовують нумерацію, що починається з нуля, для вихідних документів і номерів сторінок.
Використовуйте метод ApplyPageBuilder для застосування зазначеного порядку сторінок до об’єднаного документа.
Збережіть отриманий документ, викликавши Save метод і вказавши шлях до файлу.

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

Висновок

Ці приклади ілюструють універсальність функції Page Builder. Розробники можуть легко комбінувати сторінки з кількох документів у різних послідовностях, щоб створити індивідуальні виходи. Ця функція значно зменшує ручну працю і забезпечує точність у створенні документів, що робить її незамінним інструментом для різноманітних випадків використання.

Отримайте безкоштовну ліцензію API

Ви можете get a free temporary license щоб використовувати API без обмежень оцінювання.

Створіть власний конструктор сторінок злиття

Ось кілька важливих посилань, які допоможуть вам у створенні власного додатку для порівняння документів.

Документація | API Справочник | Підтримувані Формати Файлів

Приклад пробігу – GitHub | Безкоштовний форум підтримки | Примітки до випуску

Дивіться також

Для отримання додаткової інформації та ресурсів, вам можуть бути корисні наступні посилання:

Розуміння конструктора сторінок#

Приклади випадків та імплементація коду#

Вказуючи діапазон потрібних сторінок#

Висновок#

Отримайте безкоштовну ліцензію API#

Створіть власний конструктор сторінок злиття#

Дивіться також#