💡 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
.msgo.emlda 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,CceBccconDisplayHeadere le relative opzioniDisplay*(CceBccsono nascoste per impostazione predefinita). - Intestazioni localizzate: mappa ogni
EmailFielda una didascalia diversa conFieldTextMap, ad esempio traducendoSubjecteAttachmentsin un’altra lingua. - Formattazione della data: la linea
Sentsegue la cultura della macchina che esegue la conversione, eTimeZoneOffsetimposta l’offset UTC usato per le date del messaggio. - Output solo messaggio: imposta
ConvertOwnedsufalsequando 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?
- Prova una licenza temporanea gratuita
- Esplora la conversione di ogni allegato email in un formato di output diverso (link)
- Leggi il riferimento completo EmailLoadOptions (link)
- Dai un’occhiata al progetto di esempio su GitHub (link)