💡 Exemple complet fonctionnel disponible sur GitHub : convert-email-and-attachments-to-pdf-dotnet
La conversion Email‑vers‑PDF est un workflow GroupDocs.Conversion pour .NET qui transforme un message Outlook et ses pièces jointes en un ou plusieurs fichiers PDF sans qu’une pièce jointe n’écrase une autre ou qu’un fichier non pris en charge ne bloque l’ensemble du processus. Elle remplace une routine manuelle d’exportation‑et‑renommage par quelques lignes de code qui savent, pour chaque élément, d’où il vient et s’il a bien été converti.
L’ancienne méthode était pénible
Imaginez une boîte de réception de support où chaque e‑mail de cas comporte deux ou trois pièces jointes — un rapport ici, une capture d’écran là, parfois un format de fichier que personne dans l’équipe ne reconnaît. Rien de cela n’est inhabituel. Traiter ce cas signifie ouvrir le message, enregistrer chaque pièce jointe à la main, renommer celles qui entrent en conflit parce que deux systèmes ont tous deux exporté un fichier nommé report.csv, et espérer qu’aucun des fichiers ne soit dans un format que votre lecteur PDF ne peut pas ouvrir. Faites cela cinquante fois par semaine et « l’export rapide » devient la partie la plus lente du travail, et la partie la plus susceptible d’être bâclée, moment où les erreurs surviennent.
Faire cela à la main ne coûte pas seulement du temps — c’est aussi là que les fichiers disparaissent silencieusement. Enregistrez deux pièces jointes toutes deux nommées report.csv dans le même dossier sans les renommer d’abord, et le deuxième enregistrement écrase le premier ; personne ne s’en rend compte avant que les chiffres de septembre ne soient introuvables. Un message contenant ne serait‑ce qu’une pièce jointe dans un format pour lequel personne n’a de convertisseur peut bloquer toute l’exportation jusqu’à ce que quelqu’un décide quoi en faire.
Le vrai coût d’une manipulation manuelle : une pièce jointe renommée et écrasée ne génère pas d’erreur — elle disparaît simplement en silence, et le dossier du cas semble complet jusqu’à ce que quelqu’un ait besoin des données qu’elle contenait.
Il existe une meilleure façon
GroupDocs.Conversion pour .NET transforme cela en quelques lignes de code. Aucun renommage manuel n’est nécessaire. Sa classe EmailLoadOptions contrôle si le message, les pièces jointes, ou les deux sont convertis, et un rappel SaveContext décrit chaque élément de sortie suffisamment pour que deux pièces jointes nommées report.csv ne se percutent jamais et qu’une pièce jointe sans voie PDF n’arrête pas le reste du processus. Chaque appel à ce rappel fournit ItemIndex (un compteur démarrant à 1), HierarchyLevel (0 pour le message, 1 pour une pièce jointe) et SourceFileName (le nom de fichier d’origine), ce qui suffit à créer un nom de sortie sans collision sans écrire de logique supplémentaire.
Avant de commencer, vous aurez besoin de :
- .NET SDK 8.0 ou ultérieur
- GroupDocs.Conversion pour .NET 26.10.0 (obtenez une licence temporaire pour supprimer les limites d’évaluation)
- Un message Outlook
.msgou.emlà convertir
Installez avec une seule commande :
dotnet add package GroupDocs.Conversion --version 26.10.0
La nouvelle méthode : conversion d’un message et de ses pièces jointes
Voici à quoi ressemble la même tâche avec GroupDocs.Conversion. L’exemple suivant convertit un message Outlook et chacune de ses pièces jointes en son propre PDF, avec des noms de fichiers qui ne se chevauchent jamais.
Étape 1 - Décider quoi convertir
EmailLoadOptions.ConvertOwner et ConvertOwned activent ou désactivent indépendamment le message et ses pièces jointes ; Depth (par défaut 2) limite la profondeur des pièces jointes imbriquées suivies.
// Convert the message itself and every attachment it carries
var loadOptions = new EmailLoadOptions
{
ConvertOwner = true,
ConvertOwned = true,
Depth = 2
};
Étape 2 - Nommer chaque sortie à partir de SaveContext
Passez un rappel SaveContext à Converter.Convert au lieu d’un chemin de sortie fixe. Le rappel s’exécute une fois par élément, avec ItemIndex unique même lorsque deux pièces jointes partagent le même nom de fichier.
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());
}
Étape 3 - Gérer les pièces jointes sans voie PDF
Toutes les pièces jointes ne peuvent pas devenir un PDF. Vérifiez SaveContext.TargetFormat contre FileType.Unknown et enregistrez cet élément sous son propre nom au lieu de le convertir.
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());
Pointez ce code sur un e‑mail de support d’exemple contenant deux pièces jointes toutes deux nommées report.csv et une pièce jointe dans un format non pris en charge. Trois PDF sont générés : le message et les deux rapports CSV. Le fichier non pris en charge est également généré, intact — ouvrez‑le à côté de l’original et chacun de ses 32 octets correspond.
Comment éviter d’écraser les pièces jointes qui partagent le même nom de fichier ?
Un nom de fichier à lui seul ne peut pas servir de clé sûre pour la sortie, car deux pièces jointes peuvent porter exactement le même nom. Intégrez SaveContext.ItemIndex dans le nom avec SaveContext.SourceFileName, et les deux pièces jointes nommées report.csv cessent de se concurrencer pour le même emplacement disque ; chacune reçoit son propre préfixe à zéro remplissage (02- et 03- dans l’exemple, après le 01- du message) et son propre fichier, quel que soit le nom d’origine.
Comparaison côte à côte : avant vs. après
| Avant (Manuel) | Après (GroupDocs.Conversion) | |
|---|---|---|
| Temps | Minutes par message, manuellement | Quelques lignes de code, n’importe quel nombre de messages |
| Noms en double | Écrasés silencieusement | Conservés séparés via ItemIndex |
| Pièce jointe non prise en charge | Interrompt toute la conversion (pré-26.10) | Enregistrée sous son propre nom, le processus continue |
| Sortie | Ce que votre lecteur PDF peut enregistrer | PDF structurés que vous pouvez classer ou indexer |
L’e‑mail de support de l’exemple est construit à partir de ce mélange exact : deux exportations CSV mensuelles portant le même nom, et un fichier de capture qu’aucun convertisseur ne reconnaît.
Exemple réel : archivage des cas de support
Une équipe de support consigne chaque cas client sous forme d’e‑mail avec une ou plusieurs pièces jointes de type feuille de calcul, et le système de suivi des cas doit classer chaque pièce jointe comme son propre PDF consultable, séparé du message. Exécuter le message via KeepAttachmentsWithoutPdfRoute une fois par cas entrant transforme le message et ses pièces jointes en un ensemble numéroté de fichiers, sans qu’aucune pièce ne soit jamais écrasée même lorsque deux rapports partagent le même nom. Un e‑mail de cas contenant deux exportations mensuelles report.csv et un fichier de capture dans un format que personne ne convertit donne quatre fichiers : le message, les deux rapports CSV en PDF, et le fichier de capture enregistré sous son propre nom — rien n’est perdu, rien n’est fusionné, rien n’est écrasé silencieusement.
// One call per case e-mail - no manual export, no renamed duplicates
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);
Que pouvez‑vous faire d’autre avec GroupDocs.Conversion pour .NET ?
Au‑delà de la séparation d’un message et de ses pièces jointes, EmailLoadOptions couvre davantage le message lui‑même :
- Visibilité des champs : afficher ou masquer l’en‑tête et ses lignes
From,To,CcetBccavecDisplayHeaderet les options associéesDisplay*(CcetBccsont masqués par défaut). - En‑têtes localisés : associer chaque
EmailFieldà une légende différente avecFieldTextMap, par exemple traduireSubjectetAttachmentsdans une autre langue. - Formatage des dates : la ligne
Sentsuit la culture de la machine qui exécute la conversion, etTimeZoneOffsetdéfinit le décalage UTC utilisé pour les dates du message. - Sortie uniquement du message : définissez
ConvertOwnedàfalselorsque le PDF ne doit représenter que le message, les noms des pièces jointes restant listés dans l’en‑tête à titre de référence.
Voir la référence complète de EmailLoadOptions pour chaque option.
Conclusion
Ce qui consistait auparavant à ouvrir un message, enregistrer les pièces jointes à la main et revérifier les doublons écrasés nécessite maintenant un rappel SaveContext et quelques lignes de code. GroupDocs.Conversion pour .NET attribue à chaque élément de sortie — le message et chaque pièce jointe — un nom qui ne se chevauche jamais, et conserve une pièce jointe sans voie PDF au lieu d’interrompre le processus. Les mêmes trois blocs de construction — ConvertOwner, ConvertOwned et le rappel SaveContext — s’étendent d’un PDF récapitulatif unique à une décomposition complète, sans collision, d’un message et de toutes ses pièces jointes, vous permettant de commencer petit et de grandir jusqu’au workflow complet selon les besoins de votre boîte de réception.
Prêt à automatiser votre flux de travail e‑mail‑vers‑PDF ?
- Essayez une licence temporaire gratuite
- Explorez la conversion de chaque pièce jointe d’e‑mail vers un format de sortie différent
- Lisez la référence complète de EmailLoadOptions
- Découvrez le projet d’exemple sur GitHub