💡 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 .msg ou .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, Cc et Bcc avec DisplayHeader et les options associées Display* (Cc et Bcc sont masqués par défaut).
  • En‑têtes localisés : associer chaque EmailField à une légende différente avec FieldTextMap, par exemple traduire Subject et Attachments dans une autre langue.
  • Formatage des dates : la ligne Sent suit la culture de la machine qui exécute la conversion, et TimeZoneOffset définit le décalage UTC utilisé pour les dates du message.
  • Sortie uniquement du message : définissez ConvertOwned à false lorsque 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 ?

Ressources supplémentaires