Обзор

Объединение документов Word — это распространенная необходимость во многих приложениях, будь то комбинирование отчетов, консолидация информации или просто упрощение управления документами. В этой статье мы рассмотрим, как объединять файлы DOCX с помощью Python и библиотеки GroupDocs.Merger. Эта мощная библиотека позволяет разработчикам легко программно обрабатывать документы Word, обеспечивая при этом высокую производительность и точность.

В этом руководстве будет рассмотрено:

Как объединить несколько файлов DOCX

Объединение нескольких файлов DOCX с библиотекой GroupDocs.Merger происходит просто. Ниже мы описываем ключевые шаги, участвующие в этом процессе:

  1. Импортируйте пакет GroupDocs.Merger: Начните с импорта необходимой библиотеки.
  2. Создайте экземпляр Merger: Создайте экземпляр класса Merger, используя путь к первому файлу DOCX.
  3. Присоедините дополнительные документы: Используйте метод join, чтобы добавить другие файлы DOCX, которые вы хотите объединить.
  4. Сохраните объединенный документ: Наконец, вызовите метод save, чтобы записать объединенный документ в указанное выходное местоположение.

Вот пример кода на Python, демонстрирующий эти шаги:

import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Пример базового использования] # MultipleDocumentOperations # Merge : Docx")

    # Шаг 1: Создайте объект Merger с первым документом
    with gm.Merger(constants.sample_docx) as merger:
        print(f"Информация о документе успешно получена")
        
        # Шаг 2: Присоедините другой файл DOCX для объединения
        merger.join(constants.sample_docx)
        
        # Шаг 3: Сохраните объединенный документ
        merger.save(constants.output_docx)
        print(f"Объединение в: {constants.output_docx}")
    
    print(f"----------------------------------------------------------------------------")

Объединение документов DOCX без разрывов секций

Иногда объединение документов требует, чтобы содержимое было соединено без вставки разрывов секций. Это может помочь сохранить поток информации между объединяемыми документами.

  1. Создайте экземпляр Merger: Точно так же инициализируйте класс Merger.
  2. Установите параметры объединения: Определите WordJoinOptions и установите свойство mode в DISABLE_SECTION_BREAKS.
  3. Присоедините документы: Добавьте дополнительный документ для объединения.
  4. Сохраните результат: Запишите окончательный выход в новый файл DOCX.

Вот как вы можете это сделать:

import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Пример базового использования] # MultipleDocumentOperations # Merge # Word : MergeWordDocumentsWithoutSectionBreaks")

    # Шаг 1: Создайте объект Merger с исходным документом
    with gm.Merger(constants.sample_doc) as merger:
        print(f"Информация о документе успешно получена")
        
        # Шаг 2: Определите параметры объединения Word для отключения разрывов секций
        word_join_options = gm.domain.options.WordJoinOptions()
        word_join_options.mode = gm.domain.options.WordJoinMode.DISABLE_SECTION_BREAKS
        
        # Шаг 3: Объедините документ без разрывов секций
        merger.join(constants.sample_doc, word_join_options)
        
        # Шаг 4: Сохраните объединенный документ
        merger.save(constants.output_doc_without_section_breaks)
        print(f"Объединение в: {constants.output_doc_without_section_breaks}")
    
    print(f"----------------------------------------------------------------------------")

Объединение документов DOCX с предопределенными режимами соблюдения

Для конкретных случаев использования документы могут потребовать соблюдения определенных стандартов. GroupDocs.Merger позволяет объединять документы с предопределенными режимами соблюдения, чтобы гарантировать, что выходные данные, например, соответствуют стандартам ISO.

  1. Создайте экземпляр Merger: Инициализируйте класс Merger с вашим базовым документом.
  2. Установите режим соблюдения: Создайте объект WordJoinOptions и установите свойство compliance.
  3. Присоедините документы: Добавьте дополнительный документ, используя метод join.
  4. Сохраните окончательный документ: Сохраните его в желаемом месте.

Вот код для этой операции:

import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Пример базового использования] # MultipleDocumentOperations # Merge # Word : MergeWordDocumentsWithPredefinedComplianceMode")

    # Шаг 1: Создайте объект Merger с документом
    with gm.Merger(constants.sample_docx) as merger:
        print(f"Информация о документе успешно получена")
        
        # Шаг 2: Определите параметры объединения Word с предопределенным режимом соблюдения
        word_join_options = gm.domain.options.WordJoinOptions()
        word_join_options.compliance = gm.domain.options.WordJoinCompliance.ISO_29500_2008_STRICT
        
        # Шаг 3: Объедините другой документ с режимом соблюдения
        merger.join(constants.sample_docx, word_join_options)
        
        # Шаг 4: Сохраните объединенный документ
        merger.save(constants.output_docx_with_predefined_compliance_mode)
        print(f"Объединение в: {constants.output_docx_with_predefined_compliance_mode}")
    
    print(f"----------------------------------------------------------------------------")

Как объединить DOCX из потоков

Вы также можете объединять DOCX файлы из потоков в памяти, что может быть полезно при работе с динамически создаваемыми документами.

  1. Получите поток файла: Откройте свой документ в бинарном режиме, чтобы получить поток.
  2. Создайте экземпляр Merger: Инициализируйте класс Merger, используя поток.
  3. Выполните операцию объединения: Объедините по мере необходимости и сохраните результат.

Вот как вы бы реализовали это:

from turtle import update
import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Пример продвинутого использования] # Loading # LoadDocumentFromStream")

    # Шаг 1: Получите поток документа
    stream = get_file_stream()
    
    # Шаг 2: Создайте экземпляр Merger, используя поток
    with gm.Merger(stream) as merger:
        print(f"Документ успешно загружен из потока")
    
    print(f"----------------------------------------------------------------------------")

def get_file_stream():
    file_path = constants.sample_docx
    return open(file_path, "rb")

Дополнительные ресурсы

Для получения более подробной информации вы можете исследовать следующие ресурсы:

Вы также можете скачать бесплатную пробную версию с releases.groupdocs.com и получить временную лицензию, чтобы попробовать библиотеку без ограничений на Приобретение временной лицензии.

Примеры кода

Вот дополнительные примеры, которые помогут вам понять процесс объединения с библиотекой GroupDocs.Merger для Python:

Объединение документов Word без начала с новой страницы

Этот пример демонстрирует, как объединять документы так, чтобы последняя страница первого документа непосредственно следовала за первой страницей следующего документа, без вставки новой страницы между ними.

import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Пример базового использования] # MultipleDocumentOperations # Merge # Word : MergeWordDocumentsWithoutStartingFromNewPage")

    # Шаг 1: Создайте объект Merger с документом
    with gm.Merger(constants.sample_doc) as merger:
        print(f"Информация о документе успешно получена")
        
        # Шаг 2: Определите параметры объединения Word для непрерывного режима
        word_join_options = gm.domain.options.WordJoinOptions()
        word_join_options.mode = gm.domain.options.WordJoinMode.CONTINUOUS
        
        # Шаг 3: Объедините документы без вставки новой страницы
        merger.join(constants.sample_doc, word_join_options)
        
        # Шаг 4: Сохраните объединенный документ
        merger.save(constants.output_doc_without_starting_from_new_page)
        print(f"Объединение в: {constants.output_doc_without_starting_from_new_page}")
    
    print(f"----------------------------------------------------------------------------")

Объединение нескольких документов с пользовательскими параметрами объединения

Вот как объединять файлы DOCX, устанавливая конкретные параметры объединения, такие как соблюдение конкретного стандарта ISO.

import groupdocs.merger as gm
import constants

def run():
    print(f"----------------------------------------------------------------------------")
    print(f"[Пример продвинутого использования] # Объединение с пользовательскими параметрами объединения")

    # Шаг 1: Создайте объект Merger с базовым документом
    with gm.Merger(constants.sample_docx) as merger:
        print(f"Информация о документе успешно получена")
        
        # Шаг 2: Установите пользовательские параметры объединения с предопределенным режимом соблюдения
        word_join_options = gm.domain.options.WordJoinOptions()
        word_join_options.compliance = gm.domain.options.WordJoinCompliance.ISO_29500_2008_STRICT
        
        # Шаг 3: Объедините другой документ с параметрами соблюдения
        merger.join(constants.sample_docx, word_join_options)
        
        # Шаг 4: Сохраните объединенный документ
        merger.save(constants.output_docx_with_predefined_compliance_mode)
        print(f"Объединение в: {constants.output_docx_with_predefined_compliance_mode}")
    
    print(f"----------------------------------------------------------------------------")

Дополнительные ресурсы

Чтобы узнать больше о GroupDocs.Merger и его функциональных возможностях, вы можете ознакомиться со следующими ресурсами:

Бесплатная пробная версия и временная лицензия

Вы можете скачать бесплатную пробную версию GroupDocs.Merger с нашей страницы релизов. Кроме того, вы можете получить временную лицензию для оценочных целей на Приобретение временной лицензии. Эта временная лицензия позволяет вам попробовать библиотеку без каких-либо ограничений и полностью оценить ее возможности.