💡 Полный рабочий пример доступен на GitHub: convert-email-and-attachments-to-pdf-dotnet

Конвертация Email в PDF — это рабочий процесс GroupDocs.Conversion для .NET, который превращает сообщение Outlook и его вложения в один или несколько PDF‑файлов без перезаписи одного вложения другим и без того, чтобы один неподдерживаемый файл ломал весь процесс. Он заменяет ручную процедуру экспорта и переименования несколькими строками кода, которые знают, откуда каждый элемент пришёл и был ли он конвертирован.

Старый способ был болезненным

Представьте почтовый ящик поддержки, где каждое письмо‑запрос содержит два‑три вложения — отчёт здесь, скриншот там, иногда файл в формате, который никто в команде не распознаёт. В этом нет ничего необычного. Обработать такой запрос значит открыть сообщение, сохранить каждое вложение вручную, переименовать те, что конфликтуют, потому что две системы экспортировали файл с именем report.csv, и надеяться, что ни один из файлов не окажется в формате, который ваш PDF‑просмотрщик не может открыть. Делайте это пятьдесят раз в неделю, и «быстрый экспорт» становится самой медленной частью работы, а также той, где чаще всего спешат, что и приводит к ошибкам.

Выполняя это вручную, вы не только тратите время — вы также создаёте условия, при которых файлы тихо исчезают. Сохраните два вложения с одинаковым именем report.csv в одну папку без предварительного переименования, и второе сохранение перезапишет первое; никто не заметит, пока сентябрьские цифры не исчезнут. Сообщение с даже одним вложением в формате, для которого нет конвертера, может остановить весь экспорт, пока кто‑то не решит, что с ним делать.

Настоящие издержки ручного выполнения: переименованное и перезаписанное вложение не выдаёт ошибку — оно просто тихо исчезает, и файл запроса выглядит полным, пока кто‑то не понадобится данные, которые в нём были.

Есть лучший способ

GroupDocs.Conversion for .NET превращает это в несколько строк кода. Ручное переименование не требуется. Класс EmailLoadOptions управляет тем, будет ли конвертировано сообщение, вложения или оба, а обратный вызов SaveContext описывает каждый выходной элемент настолько подробно, что два вложения с именем report.csv никогда не конфликтуют, а вложение без пути к PDF не останавливает остальную часть процесса. Каждый вызов этого обратного вызова сообщает ItemIndex (нумерация, начинающаяся с 1), HierarchyLevel (0 для сообщения, 1 для вложения) и SourceFileName (исходное имя файла), чего достаточно, чтобы построить уникальное имя вывода без дополнительного учёта.

Прежде чем начать, вам понадобится:

Установите одной командой:

dotnet add package GroupDocs.Conversion --version 26.10.0

Новый способ: конвертация сообщения и его вложений

Вот как выглядит та же задача с GroupDocs.Conversion. Приведённый пример конвертирует сообщение Outlook и каждое его вложение в отдельный PDF, с именами файлов, которые никогда не конфликтуют.

Шаг 1 — Определить, что конвертировать

EmailLoadOptions.ConvertOwner и ConvertOwned независимо включают или выключают сообщение и его вложения; Depth (по умолчанию 2) ограничивает глубину вложенных вложений.

// Convert the message itself and every attachment it carries
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 is 1 for the message, then counts up per attachment
        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 и файл захвата, сохранённый под собственным именем — ничего не потеряно, ничего не объединено, ничего не перезаписано тихо.

// One call per case e-mail - no manual export, no renamed duplicates
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);

Что ещё можно сделать с GroupDocs.Conversion for .NET?

Помимо разделения сообщения и его вложений, EmailLoadOptions охватывает больше аспектов самого сообщения:

  • Видимость полей: показывать или скрывать заголовок и его строки From, To, Cc и Bcc с помощью DisplayHeader и связанных параметров Display* (Cc и Bcc скрыты по умолчанию).
  • Локализованные заголовки: сопоставьте каждый EmailField с другим заголовком через FieldTextMap, например, переведите Subject и Attachments на другой язык.
  • Форматирование даты: строка Sent следует культуре машины, на которой выполняется конвертация, а TimeZoneOffset задаёт смещение UTC, используемое для дат сообщения.
  • Вывод только сообщения: установите ConvertOwned в false, когда PDF нужен только как замена сообщению, при этом имена вложений всё равно будут перечислены в заголовке для справки.

См. полную справку по EmailLoadOptions для каждого параметра.

Заключение

То, что раньше означало открытие сообщения, ручное сохранение вложений и повторную проверку на перезаписанные дубликаты, теперь сводится к обратному вызову SaveContext и нескольким строкам кода. GroupDocs.Conversion for .NET даёт каждому выходному элементу — сообщению и каждому вложению — имя, которое никогда не конфликтует, и сохраняет вложение без пути к PDF вместо того, чтобы прервать процесс. Те же три строительных блока — ConvertOwner, ConvertOwned и обратный вызов SaveContext — масштабируются от одного сводного PDF до полного, безопасного от конфликтов разбора сообщения и всех его вложений, так что вы можете начинать с малого и расти до полного рабочего процесса по мере роста нагрузки вашего ящика.

Готовы автоматизировать ваш процесс конвертации электронной почты в PDF?

Дополнительные ресурсы