💡 Повний робочий приклад доступний на 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‑сторінковий, 257987‑байтовий report-with-appendix.pdf.

Крок 4: Повернути результат у конвеєр

Розмір файлу, зчитаний одразу після Save, зазвичай достатній для планувальника, щоб позначити завдання завершеним або порівняти його з мінімальним розміром і вирішити, чи можна довіряти вихідному файлу.

if (sizeInBytes == 0)
{
    throw new InvalidOperationException("Join produced an empty file.");
}

Чи приймає GroupDocs.Merger.LowCode потік замість шляху до файлу?

Так, на вході. Кожен із семи продуктів приймає джерело у вигляді потоку в тому ж параметрі конструктора, де зазвичай вказується шлях до файлу, що зручно, коли вхідні дані надходять із сховища BLOB або черги замість локального диска. 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 видаляє вказані сторінки і записує новий файл, не змінюючи джерело, тому оригінал залишається доступним для аудиту після відправки скороченої копії. У нашому тесті видалення сторінки 2 з report.pdf дало 1‑сторінковий, 86647‑байтовий report-without-page-2.pdf, а report.pdf залишився без змін.
  • Розділення презентації для окремого зацікавленого: SplitPptx витягує потрібні слайди у окремі файли, названі за токеном {0} у шаблоні вихідного шляху або, за відсутності токену, додає номер частини в тій самій папці, за тим же шаблоном, що й SplitPdf для розділення сторінок PDF.
  • Злиття Word‑документів замість PDF: JoinDocx слідує точно тій же формі «конструктор‑потім‑Save», що й JoinPdf, розташовуючи доданий документ після останньої сторінки джерела.

Без ліцензії кожне з цих завдань працює в режимі оцінки. У нашому тесті без ліцензії об’єднані PDF та Word‑виходи були скорочені до 3‑х сторінок кожен, хоча всі шість прикладів файлів все ж були створені; застосуйте ліцензію через License.Set перед будь‑яким автоматичним запуском у продакшені.


Перші кроки у вашому бек‑офісному конвеєрі

У вас вже є один шаблон low‑code злиття документів, який працює від початку до кінця, і довідка, що перевірка формату виконується при кожному виклику. Далі можна:

  • Переглянути повну картину: супровідний посібник з використанням покроково розглядає кожну з шести операцій прикладу, включаючи розгорнуті FAQ.
  • Поглибитися, коли завдання розростається: повний API GroupDocs.Merger охоплює більше можливостей, ніж потрібен цей шаблон, коли конвеєр перевищує одну операцію.
  • Переглянути код: повний приклад на GitHub містить усі вхідні файли, використані вище.
  • Встановити пакет: сторінка встановлення описує окремий пакет і підтримувані цільові платформи.
  • Зняти обмеження оцінки: отримайте тимчасову ліцензію перед використанням у продакшені.
  • Питання: форум підтримки — місце, де команда відповідає на питання щодо реалізації.

Ресурси