💡 Esempio completo funzionante disponibile su GitHub: convert-email-and-attachments-to-pdf-dotnet

La conversione da Email a PDF è un flusso di lavoro GroupDocs.Conversion per .NET che trasforma un messaggio Outlook e i relativi allegati in uno o più file PDF senza che un allegato sovrascriva un altro o che un file non supportato interrompa l’intera esecuzione. Sostituisce una routine manuale di esportazione e rinomina con poche righe di codice che sanno, per ogni elemento, da dove proviene e se è stato convertito.

Il Vecchio Metodo Era Doloroso

Immagina una casella di supporto dove ogni email di caso contiene due o tre allegati – un report qui, uno screenshot lì, a volte un formato di file che nessuno del team riconosce. Nulla di tutto ciò è insolito. Archiviare quel caso significa aprire il messaggio, salvare manualmente ogni allegato, rinominare quelli che entrano in conflitto perché due sistemi hanno esportato entrambi un file chiamato report.csv, e sperare che nulla nel set sia in un formato che il tuo visualizzatore PDF non possa aprire. Fai questo cinquanta volte a settimana e la “esportazione rapida” diventa la parte più lenta del lavoro, e la parte più soggetta a fretta, proprio quando si verificano gli errori.

Fare ciò manualmente non costa solo tempo – è anche il punto in cui i file scompaiono silenziosamente. Salva due allegati entrambi chiamati report.csv nella stessa cartella senza rinominarli prima, e il secondo salvataggio sovrascrive il primo; nessuno se ne accorge finché i numeri di settembre non sono più reperibili. Un messaggio con anche un solo allegato in un formato per il quale nessuno ha un convertitore può bloccare l’intera esportazione finché qualcuno non decide cosa fare con esso.

Il vero costo del farlo manualmente: un allegato rinominato e sovrascritto non genera un errore – scompare semplicemente in silenzio, e il file del caso sembra completo finché qualcuno non ha bisogno dei dati che conteneva.

C’è un Modo Migliore

GroupDocs.Conversion per .NET trasforma tutto questo in poche righe di codice. Non è necessario rinominare manualmente. La sua classe EmailLoadOptions controlla se il messaggio, gli allegati o entrambi vengono convertiti, e una callback SaveContext descrive ogni elemento di output in modo sufficientemente dettagliato affinché due allegati chiamati report.csv non entrino mai in conflitto e un allegato senza percorso verso PDF non fermi il resto dell’esecuzione. Ogni chiamata a quella callback restituisce ItemIndex (un contatore progressivo a partire da 1), HierarchyLevel (0 per il messaggio, 1 per un allegato) e SourceFileName (il nome file originale), che è un contesto sufficiente per generare un nome di output privo di collisioni senza scrivere alcuna contabilità aggiuntiva.

Prima di iniziare, avrai bisogno di:

  • .NET SDK 8.0 o successivo
  • GroupDocs.Conversion per .NET 26.10.0 (ottieni una licenza temporanea) per rimuovere i limiti di valutazione
  • Un messaggio Outlook .msg o .eml da convertire

Installa con un solo comando:

dotnet add package GroupDocs.Conversion --version 26.10.0

Il Nuovo Metodo: Convertire un Messaggio e i Suoi Allegati

Ecco come appare lo stesso compito con GroupDocs.Conversion. L’esempio seguente converte un messaggio Outlook e ciascuno dei suoi allegati in un proprio PDF, con nomi file che non entrano mai in conflitto.

Passo 1 – Decidere Cosa Convertire

EmailLoadOptions.ConvertOwner e ConvertOwned attivano o disattivano indipendentemente il messaggio e i suoi allegati; Depth (predefinito 2) limita fino a che punto vengono seguiti gli allegati annidati.

// Convert the message itself and every attachment it carries
var loadOptions = new EmailLoadOptions
{
    ConvertOwner = true,
    ConvertOwned = true,
    Depth = 2
};

Passo 2 – Nominare Ogni Output da SaveContext

Passa una callback SaveContext a Converter.Convert invece di un percorso di output fisso. La callback viene eseguita una volta per elemento, con ItemIndex unico per elemento anche quando due allegati condividono lo stesso nome file.

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());
}

Passo 3 – Gestire gli Allegati Senza Percorso PDF

Non tutti gli allegati possono diventare PDF. Verifica SaveContext.TargetFormat rispetto a FileType.Unknown e salva quell’elemento con il proprio nome invece di convertirlo.

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());

Punta questo codice a una email di supporto di esempio con due allegati entrambi chiamati report.csv e un allegato in un formato non supportato. Ottieni tre PDF: il messaggio e entrambi i report CSV. Il file non supportato viene anch’esso salvato, intatto – aprilo accanto all’originale e tutti i suoi 32 byte corrispondono.

Come Evitare di Sovrascrivere gli Allegati che Condividono lo Stesso Nome File?

Un nome file da solo non può fungere da chiave sicura per l’output, poiché due allegati possono avere esattamente lo stesso nome. Inserisci SaveContext.ItemIndex nel nome insieme a SaveContext.SourceFileName, e due allegati chiamati report.csv smettono di competere per la stessa posizione su disco; ciascuno ottiene il proprio prefisso a zero padding (02- e 03- nell’esempio, dopo il 01- del messaggio) e il proprio file, qualunque sia il nome originale.

Confronto: Prima vs. Dopo

Prima (Manuale) Dopo (GroupDocs.Conversion)
Tempo Minuti per messaggio, manualmente Poche righe di codice, qualsiasi numero di messaggi
Nomi duplicati Sovrascritti silenziosamente Mantenuti separati tramite ItemIndex
Allegato non supportato Interrompe l’intera conversione (pre-26.10) Salvato con il proprio nome, l’esecuzione continua
Output Qualunque cosa il tuo visualizzatore PDF possa salvare PDF strutturati che puoi archiviare o indicizzare

L’email di supporto dell’esempio è costruita esattamente con quella combinazione: due esportazioni CSV mensili con lo stesso nome e un file di acquisizione che nessun convertitore riconosce.

Esempio Reale: Archiviazione dei Casi di Supporto

Un team di supporto registra ogni caso cliente come una email con uno o più allegati di foglio di calcolo, e il sistema di tracciamento dei casi necessita che ogni allegato sia archiviato come un proprio PDF ricercabile, separato dal messaggio. Eseguire il messaggio attraverso KeepAttachmentsWithoutPdfRoute una volta per ogni caso in arrivo trasforma il messaggio e i suoi allegati in un insieme numerato di file, senza che alcun allegato sovrascriva un altro anche quando due report condividono lo stesso nome. Un’email di caso con due esportazioni mensili report.csv e un file di acquisizione in un formato che nessuno converte produce quattro file: il messaggio, entrambi i report CSV come PDF, e il file di acquisizione salvato con il proprio nome – nulla è stato eliminato, nulla è stato unito, nulla è stato sovrascritto silenziosamente.

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

Cos’altro puoi fare con GroupDocs.Conversion per .NET?

Oltre a separare un messaggio dai suoi allegati, EmailLoadOptions copre più aspetti del messaggio stesso:

  • Visibilità dei campi: mostra o nascondi l’intestazione e le sue linee From, To, Cc e Bcc con DisplayHeader e le relative opzioni Display* (Cc e Bcc sono nascoste per impostazione predefinita).
  • Intestazioni localizzate: mappa ogni EmailField a una didascalia diversa con FieldTextMap, ad esempio traducendo Subject e Attachments in un’altra lingua.
  • Formattazione della data: la linea Sent segue la cultura della macchina che esegue la conversione, e TimeZoneOffset imposta l’offset UTC usato per le date del messaggio.
  • Output solo messaggio: imposta ConvertOwned su false quando il PDF deve rappresentare solo il messaggio, con i nomi degli allegati ancora elencati nell’intestazione come riferimento.

Consulta il riferimento completo riferimento EmailLoadOptions per ogni opzione.

Conclusione

Ciò che prima significava aprire un messaggio, salvare manualmente gli allegati e ricontrollare i duplicati sovrascritti ora richiede una callback SaveContext e poche righe di codice. GroupDocs.Conversion per .NET assegna a ogni elemento di output – il messaggio e ciascun allegato – un nome che non collida, e conserva un allegato senza percorso PDF invece di far fallire l’esecuzione. Gli stessi tre blocchi costitutivi – ConvertOwner, ConvertOwned e la callback SaveContext – si adattano da un singolo PDF riepilogativo a una suddivisione completa e priva di collisioni di un messaggio e di tutti i suoi allegati, così puoi iniziare in piccolo e crescere fino al flusso di lavoro completo man mano che la tua casella di posta lo richiede.

Pronto a automatizzare il tuo flusso di lavoro email‑to‑PDF?

Risorse Aggiuntive