💡 Повний робочий приклад доступний на 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 містить усі вхідні файли, використані вище.
- Встановити пакет: сторінка встановлення описує окремий пакет і підтримувані цільові платформи.
- Зняти обмеження оцінки: отримайте тимчасову ліцензію перед використанням у продакшені.
- Питання: форум підтримки — місце, де команда відповідає на питання щодо реалізації.