💡 Повний робочий приклад доступний на GitHub:
convert-email-and-attachments-to-pdf-dotnet
Перетворення Email‑to‑PDF — це робочий процес GroupDocs.Conversion для .NET, який перетворює повідомлення Outlook та його вкладення в один або кілька PDF‑файлів, не дозволяючи одному вкладенню перезаписати інше і не допускаючи, щоб один непідтримуваний файл зупинив весь процес. Це замінює ручну процедуру експорту та перейменування кількома рядками коду, які знають, звідки походить кожен елемент і чи був він успішно конвертований.
Старий спосіб був болючим
Уявіть собі поштову скриньку підтримки, де кожен лист‑запит містить два‑три вкладення — звіт тут, скріншот там, іноді файл у форматі, який ніхто в команді не розпізнає. У цьому нічого незвичного. Обробка такого запиту означає відкриття повідомлення, ручне збереження кожного вкладення, перейменування тих, що конфліктують, бо дві системи експортували файл з назвою report.csv, і сподівання, що жоден з файлів не має формату, який ваш PDF‑переглядач не зможе відкрити. Робіть це п’ятдесят разів на тиждень, і «швидкий експорт» стає найповільнішою частиною роботи, а також тією, яку найчастіше прискорюють, саме коли і трапляються помилки.
Робота вручну не лише забирає час — саме тут файли тихо зникають. Збережіть два вкладення з однаковою назвою report.csv у одну папку без попереднього перейменування, і друге збереження перезаписує перше; ніхто не помічає, доки не зникають вересневі дані. Повідомлення навіть з одним вкладенням у форматі, для якого немає конвертера, може зупинити весь експорт, доки хтось не вирішить, що з ним робити.
Справжня вартість ручної роботи: перейменоване‑і‑перезаписане вкладення не генерує помилку — воно просто безшумно зникає, і файл справи виглядає повним, доки хтось не потребує даних, що в ньому були.
Є кращий спосіб
GroupDocs.Conversion для .NET перетворює це на кілька рядків коду. Ручне перейменування не потрібне. Клас EmailLoadOptions керує тим, чи конвертуються повідомлення, вкладення або обидва, а зворотний виклик SaveContext описує кожен вихідний елемент настільки докладно, що два вкладення з назвою report.csv ніколи не конфліктують, а вкладення без шляху до PDF не зупиняє решту процесу. Кожен виклик цього зворотного виклику передає ItemIndex (поточний лічильник, починаючи з 1), HierarchyLevel (0 для повідомлення, 1 для вкладення) та SourceFileName (початкова назва файлу) — цього достатньо, щоб сформувати унікальну назву без колізій, не додаючи зайвого коду.
Перш ніж почати, вам знадобиться:
- .NET SDK 8.0 або новіший
- GroupDocs.Conversion для .NET 26.10.0 (отримати тимчасову ліцензію, щоб зняти обмеження оцінки)
- Повідомлення Outlook у форматі
.msgабо.emlдля конвертації
Встановіть одним командою:
dotnet add package GroupDocs.Conversion --version 26.10.0
Новий спосіб: конвертація повідомлення та його вкладень
Ось як виглядає те саме завдання за допомогою GroupDocs.Conversion. Наведений приклад конвертує повідомлення Outlook та кожне його вкладення у окремий PDF, причому назви файлів ніколи не конфліктують.
Крок 1 — Визначте, що конвертувати
EmailLoadOptions.ConvertOwner і ConvertOwned незалежно вмикають або вимикають повідомлення та його вкладення; Depth (за замовчуванням 2) обмежує глибину обходу вкладених вкладень.
// Конвертуємо саме повідомлення та всі його вкладення
var loadOptions = new EmailLoadOptions
{
ConvertOwner = true,
ConvertOwned = true,
Depth = 2
};
Крок 2 — Іменуйте кожен вихід за допомогою SaveContext
Передайте зворотний виклик SaveContext у Converter.Convert замість фіксованого шляху виводу. Виклик спрацьовує один раз для кожного елементу, причому ItemIndex унікальний навіть коли два вкладення мають однакову назву файлу.
using (var converter = new Converter(messagePath, (LoadContext _) => loadOptions))
{
converter.Convert((SaveContext item) =>
{
// ItemIndex = 1 для повідомлення, далі зростає для кожного вкладення
string name = $"{item.ItemIndex:D2}-{item.SourceFileName}.pdf";
return File.Create(Path.Combine(outputFolder, name));
}, new PdfConvertOptions());
}
Крок 3 — Обробка вкладень без шляху до PDF
Не кожне вкладення може стати PDF. Перевірте SaveContext.TargetFormat проти FileType.Unknown і збережіть такий елемент під його власною назвою без конвертації.
converter.Convert((SaveContext item) =>
{
bool passedThrough = item.TargetFormat == FileType.Unknown;
string baseName = $"{item.ItemIndex:D2}-{item.SourceFileName}";
string name = passedThrough
? baseName
: $"{baseName}.{item.TargetFormat.Extension}";
return File.Create(Path.Combine(outputFolder, name));
}, new PdfConvertOptions());
Запустіть цей код на зразковому листі підтримки з двома вкладеннями, обидва названі report.csv, і одним вкладенням у непідтримуваному форматі. Отримаєте три PDF: повідомлення та обидва CSV‑звіти. Непідтримуваний файл також збережеться, не змінений — відкрийте його поруч з оригіналом, і всі 32 байти збігаються.
Як уникнути перезапису вкладень з однаковою назвою?
Назва файлу сама по собі не може слугувати безпечним ключем для виводу, бо два вкладення можуть мати абсолютно однакову назву. Додайте SaveContext.ItemIndex до назви разом із SaveContext.SourceFileName, і два вкладення report.csv перестануть змагатися за один і той же слот на диску; кожне отримає власний префікс з нульовим заповненням (02- і 03- у прикладі, після 01- для повідомлення) і власний файл, незалежно від назви джерела.
Порівняння: до і після
| До (ручний) | Після (GroupDocs.Conversion) | |
|---|---|---|
| Час | Хвилини на повідомлення вручну | Кілька рядків коду, будь‑яка кількість листів |
| Дублікати імен | Тихо перезаписуються | Зберігаються окремо завдяки ItemIndex |
| Непідтримуване вкладення | Зупиняє всю конвертацію (до 26.10) | Зберігається під власною назвою, процес продовжується |
| Вихід | Що завгодно може зберегти ваш PDF‑переглядач | Структуровані PDF, які можна архівувати або індексувати |
Зразковий лист підтримки створений саме з такою комбінацією: два щомісячних CSV‑експорта з однаковою назвою та один файл‑захват, який не розпізнає жоден конвертер.
Реальний приклад: архівування випадків підтримки
Команда підтримки реєструє кожен випадок клієнта як лист‑запит з одним або кількома вкладеннями‑таблицями, і система відстеження випадків потребує зберігати кожне вкладення як окремий пошуковий PDF, окремо від повідомлення. Виклик KeepAttachmentsWithoutPdfRoute один раз для кожного вхідного листа перетворює повідомлення та його вкладення у нумерований набір файлів, жодне вкладення не перезаписується, навіть коли два звіти мають однакову назву. Лист‑запит з двома щомісячними report.csv та одним файлом‑захватом у непідтримуваному форматі виводиться як чотири файли: повідомлення, обидва CSV‑звіти у PDF та файл‑захват, збережений під власною назвою — нічого не втрачено, нічого не злито, нічого не перезаписано без повідомлення.
// Один виклик на лист‑запит — без ручного експорту, без перейменованих дублікатів
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);
Що ще можна робити з GroupDocs.Conversion для .NET?
Окрім розділення повідомлення та його вкладень, EmailLoadOptions охоплює більше параметрів самого повідомлення:
- Видимість полів: показати або сховати заголовок та його рядки
From,To,CcіBccза допомогоюDisplayHeaderта пов’язаних параметрівDisplay*(CcіBccза замовчуванням приховані). - Локалізовані заголовки: зіставте кожен
EmailFieldз іншим підписом за допомогоюFieldTextMap, наприклад, перекладітьSubjectіAttachmentsіншою мовою. - Форматування дати: рядок
Sentслідує культурі машини, що виконує конвертацію, аTimeZoneOffsetзадає зміщення UTC, що використовується для дат повідомлення. - Вивід лише повідомлення: встановіть
ConvertOwnedуfalse, коли PDF потрібен лише як заміна повідомлення, залишаючи назви вкладень у заголовку для довідки.
Перегляньте повну EmailLoadOptions reference для всіх параметрів.
Висновок
Те, що раніше означало відкриття повідомлення, ручне збереження вкладень і повторну перевірку на перезаписані дублікати, тепер здійснюється за допомогою зворотного виклику SaveContext і кількох рядків коду. GroupDocs.Conversion для .NET надає кожному вихідному елементу — повідомленню та кожному вкладенню — унікальну назву без колізій і зберігає вкладення без шляху до PDF замість того, щоб зупиняти процес. Ті ж три будівельні блоки — ConvertOwner, ConvertOwned і зворотний виклик SaveContext — масштабуються від одного підсумкового PDF до повного, безколізійного розбиття повідомлення та всіх його вкладень, тож ви можете почати з малого і розширювати робочий процес у міру зростання навантаження вашої скриньки.
Готові автоматизувати ваш процес Email‑to‑PDF?
- Спробувати безкоштовну тимчасову ліцензію
- Дослідити конвертацію кожного вкладення листа в інший вихідний формат
- Прочитати повну EmailLoadOptions reference
- Переглянути зразковий проєкт на GitHub