💡 Полный рабочий пример доступен на GitHub:
one-line-document-merge-and-split-dotnet
Где на самом деле находятся задачи документооборота в бэк‑офисе
Финансовый бэк‑офис закрывает месяц, скрепляя титульную страницу к PDF‑выписке за прошлый месяц. Команда по контрактам добавляет подписанное приложение к оригинальному соглашению перед отправкой в архив. Помощник отдела продаж извлекает два слайда из шестидесятислайдовой презентации, потому что одному заинтересованному лицу нужна была только страница с ценами. Сотрудник архива удаляет страницу, которую никогда не должно было отправлять, непосредственно перед тем, как файл покинет здание.
Ни один из этих процессов не является проектом объединения. Каждый — это один файл и одна операция, выполняемая одинаково каждый раз, когда задача запускается, обычно кем‑то, у кого нет желания изучать универсальный API для работы с документами лишь бы выполнить задачу.
GroupDocs.Merger.LowCode — это пакет .NET, который превращает такую задачу, будь то объединение, разбиение или удаление страниц, в единственный вызов конструктора, отличающийся от универсального класса Merger, который эти задачи никогда не требует. Каждый из его семи продуктов принимает источник и параметры в конструкторе на C#, и выполняется только один раз, когда вызывается Save, независимо от того, работает ли задача с PDF, документом Word или презентацией PowerPoint.
Почему общие решения здесь не работают
Команды, сталкивающиеся с одной из этих задач, обычно пробуют одно из трёх, прежде чем обратиться к специализированному пакету:
- Выполнять вручную в настольном редакторе: подходит для одного документа, но невозможно запланировать, и никто не одобрит ручной шаг в 2 чут. ночи.
- Писать одноразовый скрипт, используя низкоуровневые API файлов: работает, пока не появится новый формат входных данных, и скрипт превращается в тот самый универсальный клиент, которого пытались избежать.
- Использовать полный класс
Mergerдля единственного вызова: правильно, но добавляет более широкую поверхность API, чем требуется одной операции.
GroupDocs.Merger.LowCode существует именно для этой последней «дыры»: один вызов на операцию, ничего больше не нужно изучать.
Решение: GroupDocs.Merger.LowCode для бэк‑офисных конвейеров
GroupDocs.Merger.LowCode упаковывает семь одноцелевых продуктов в форму «конструктор‑затем‑Save». JoinPdf и JoinDocx добавляют один документ к другому; JoinPptx делает то же самое для презентаций; SplitPdf, SplitDocx и SplitPptx извлекают выбранные страницы или слайды в отдельные файлы; RemovePagesPdf удаляет страницы, не трогая исходный файл. Каждый из семи принимает источник в виде пути или потока и проверяет этот источник, а также каждый переданный файл, на соответствие формату перед записью, поэтому конвейер никогда не будет гадать, почему результат получился неверным.
Чтобы следовать реализации ниже, вам понадобится:
- .NET 6.0 или новее (в этом примере проект нацелен на net8.0)
- Отдельный пакет NuGet
GroupDocs.Merger.LowCode - Временная лицензия, если хотите увидеть результат без ограничений оценки, описанных ниже
dotnet add package GroupDocs.Merger.LowCode
Пакет размещён отдельно на
NuGet от основной библиотеки GroupDocs.Merger.
Реализация шага задачи Reporting‑Pack шаг за шагом
Ниже показана структура, которой следуют все семь продуктов, на примере объединения, которое добавляет титульную страницу к ежемесячному PDF.
Шаг 1: Указать продукту его источник
Конструктор JoinPdf принимает исходный документ, каждый файл для добавления и объект JoinOptions; пока ничего не выполняется.
var join = new JoinPdf("report.pdf", new[] { "appendix.pdf" }, new JoinOptions());
Шаг 2: Определить, куда будет записан результат
Save(outputPath) — это место, где задача действительно сохраняет результат. Относительный путь разрешается относительно текущей рабочей директории процесса, а Save создаёт выходную папку, если её ещё нет, поэтому конвейер, записывающий в папку нового месяца каждый запуск, не нуждается в отдельном шаге её создания.
string outputPath = "output/monthly/report-with-appendix.pdf";
Почему это важно для автоматической задачи:
- Контролируемый путь: формируйте путь вывода из конфигурации или параметра задачи, никогда не берите его напрямую из непроверенного ввода;
SaveбросаетArgumentNullException, если путьnullили пустой. - Создаваемая папка: запланированная задача, записывающая в новое место каждый запуск, не требует отдельного шага «убедиться, что каталог существует».
Шаг 3: Запустить и получить результат
Вызов Save сразу выполняет объединение; отдельного шага «собрать‑затем‑выполнить» нет.
join.Save(outputPath);
var sizeInBytes = new FileInfo(outputPath).Length;
В нашем тестовом запуске с файлами из примера вызов объединил 2‑страничный report.pdf и 2‑страничный appendix.pdf в 4‑страничный файл report-with-appendix.pdf размером 257 987 байт.
Шаг 4: Передать результат обратно в конвейер
Размер файла, считанный сразу после Save, обычно достаточен планировщику перед пометкой задачи как завершённой, либо перед сравнением с минимальным размером, чтобы решить, достаточно ли надёжный результат для дальнейшей обработки.
if (sizeInBytes == 0)
{
throw new InvalidOperationException("Join produced an empty file.");
}
Принимает ли GroupDocs.Merger.LowCode поток вместо пути к файлу?
Да, на входе. Каждый из семи продуктов принимает источник в виде потока в том же месте конструктора, где обычно указывается путь к файлу, что удобно, когда входные данные поступают из блоб‑хранилища или очереди, а не с локального диска. Save по‑прежнему записывает результат в строку пути, независимо от способа передачи входа; потоковый вывод остаётся в полном классе Merger.
Реальный рабочий процесс: отклонение файла до его попадания в архив
Команда по контрактам, добавляющая приложения к подписанным соглашениям, не может позволить себе принимать любой файл, попавший в почтовый ящик; приложение в формате .docx, случайно оказавшееся рядом с PDF‑объединением, сломало бы архив. JoinPdf проверяет исходный файл и каждый добавляемый файл на соответствие формату PDF перед записью и бросает FileTypeNotSupportedException, как только обнаруживает несоответствие.
try
{
new JoinPdf("report.pdf", new[] { "contract.docx" }, new JoinOptions())
.Save("output/mixed.pdf");
}
catch (FileTypeNotSupportedException exception)
{
Console.WriteLine(exception.Message);
}
В примере, где пути формируются из папки resources, сообщение выглядело так: Input format does not match the expected format 'PDF'; the joined file 'resources\contract.docx' is 'Microsoft Word Open XML Document (.docx)'.
Задача выше никогда не создаёт output/mixed.pdf, когда срабатывает catch, поэтому конвейер контрактов может сразу направить это сообщение в уже используемую систему оповещений или тикет‑очередь, вместо того чтобы обнаруживать ошибочный архив спустя несколько дней.
Другие бэк‑офисные сценарии, где подходит такой шаблон
После того как вышеописанное объединение заработало, та же форма «конструктор‑затем‑Save» покрывает несколько задач, которые бэк‑офис выполняет по расписанию:
- Обрезка страницы перед отправкой документа:
RemovePagesPdfудаляет выбранные страницы и записывает новый файл, не трогая исходный, так что оригинал остаётся доступным для аудита после отправки обрезанной копии. В нашем тесте удаление второй страницы изreport.pdfдало 1‑страничный файлreport-without-page-2.pdfразмером 86 647 байт, аreport.pdfостался неизменным. - Разделение презентации для одного заинтересованного лица:
SplitPptxизвлекает запрошенные слайды в отдельные файлы, именуя их по токену{0}в шаблоне вывода или, если токен отсутствует, добавляя порядковый номер в той же папке — тот же шаблон, что используетSplitPdfдля разбиения страниц PDF. - Объединение документов Word вместо PDF:
JoinDocxследует той же структуре «конструктор‑затем‑Save», что иJoinPdf, помещая добавляемый документ после последней страницы исходного.
Без лицензии каждый из этих запусков работает в режиме оценки. В нашем тесте без лицензии объединённые PDF и Word‑файлы были урезаны до 3‑х страниц каждый, хотя все шесть примеров всё равно были созданы; примените лицензию через License.Set перед любыми автоматическими запусками в продакшене.
Как начать использовать в вашем бэк‑офисном конвейере
У вас уже есть работающий шаблон низкокодового объединения документов от начала до конца, плюс доказательство того, что проверка формата происходит при каждом вызове. Дальнейшие шаги:
- Посмотреть полную картину: сопутствующее руководство по сценариям использования подробно разбирает каждую из шести операций примера, шаг за шагом, с полным FAQ.
- Углубиться, когда задача разрастётся: полный API GroupDocs.Merger охватывает гораздо больше, чем нужен этому шаблону, когда конвейер превзойдёт одну операцию.
- Просмотреть код: полный пример на GitHub содержит все входные файлы, использованные выше.
- Установить: страница установки описывает отдельный пакет и поддерживаемые целевые фреймворки.
- Снять ограничения оценки: получите временную лицензию перед запуском в продакшене.
- Вопросы: форум поддержки — место, где команда отвечает на вопросы по реализации.