💡 Повний робочий приклад доступний на 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?

Додаткові ресурси