💡 Ejemplo completo disponible en GitHub:
convert-email-and-attachments-to-pdf-dotnet
La conversión de Email a PDF es un flujo de trabajo de GroupDocs.Conversion para .NET que transforma un mensaje de Outlook y sus archivos adjuntos en uno o varios archivos PDF sin que un adjunto sobrescriba a otro o que un archivo no compatible interrumpa toda la ejecución. Reemplaza una rutina manual de exportar y renombrar con unas pocas líneas de código que saben, para cada elemento, de dónde proviene y si se convirtió o no.
El método antiguo era doloroso
Imagina una bandeja de entrada de soporte donde cada correo de caso lleva dos o tres archivos adjuntos: un informe aquí, una captura de pantalla allí, a veces un formato de archivo que nadie en el equipo reconoce. Nada de eso es inusual. Archivar ese caso significa abrir el mensaje, guardar cada adjunto manualmente, renombrar los que colisionan porque dos sistemas exportaron un archivo llamado report.csv, y esperar que nada en el conjunto sea un formato que tu visor de PDF no pueda abrir tampoco. Haz eso cincuenta veces a la semana y la “exportación rápida” se convierte en la parte más lenta del trabajo, y la parte más propensa a apresurarse, que es precisamente cuando ocurren los errores.
Hacer esto a mano no solo cuesta tiempo, también es donde los archivos desaparecen silenciosamente. Guarda dos adjuntos ambos llamados report.csv en la misma carpeta sin renombrarlos primero, y el segundo guardado sobrescribe al primero; nadie se da cuenta hasta que los números de septiembre desaparecen. Un mensaje con incluso un solo adjunto en un formato para el que nadie tiene un convertidor puede detener toda la exportación hasta que alguien decida qué hacer con él.
El costo real de hacerlo manualmente: un adjunto renombrado y sobrescrito no lanza un error, simplemente desaparece en silencio, y el archivo del caso parece completo hasta que alguien necesita los datos que contenía.
Existe una forma mejor
GroupDocs.Conversion para .NET convierte esto en unas pocas líneas de código. No se necesita renombrado manual. Su clase EmailLoadOptions controla si el mensaje, los adjuntos o ambos se convierten, y una devolución de llamada SaveContext describe cada elemento de salida lo suficientemente bien como para que dos adjuntos llamados report.csv nunca colisionen y un adjunto sin ruta a PDF nunca detenga el resto de la ejecución. Cada llamada a esa devolución de llamada informa ItemIndex (un recuento que comienza en 1), HierarchyLevel (0 para el mensaje, 1 para un adjunto) y SourceFileName (el nombre original del archivo), lo que brinda el contexto necesario para generar un nombre de salida sin colisiones sin escribir ninguna contabilidad adicional.
Antes de comenzar, necesitarás:
- SDK de .NET 8.0 o posterior
- GroupDocs.Conversion para .NET 26.10.0 (obtener una licencia temporal para eliminar los límites de evaluación)
- Un mensaje de Outlook
.msgo.emlpara convertir
Instala con un solo comando:
dotnet add package GroupDocs.Conversion --version 26.10.0
La nueva forma: convertir un mensaje y sus adjuntos
Así es como se ve la misma tarea con GroupDocs.Conversion. El siguiente ejemplo convierte un mensaje de Outlook y cada uno de sus adjuntos en su propio PDF, con nombres de archivo que nunca colisionan.
Paso 1 - Decidir qué convertir
EmailLoadOptions.ConvertOwner y ConvertOwned activan o desactivan independientemente el mensaje y sus adjuntos; Depth (valor predeterminado 2) limita cuán profundo se siguen los adjuntos anidados.
// Convertir el propio mensaje y cada adjunto que lleva
var loadOptions = new EmailLoadOptions
{
ConvertOwner = true,
ConvertOwned = true,
Depth = 2
};
Paso 2 - Nombrar cada salida desde SaveContext
Pasa una devolución de llamada SaveContext a Converter.Convert en lugar de una ruta de salida fija. La devolución de llamada se dispara una vez por elemento, con ItemIndex único por elemento incluso cuando dos adjuntos comparten un nombre de archivo.
using (var converter = new Converter(messagePath, (LoadContext _) => loadOptions))
{
converter.Convert((SaveContext item) =>
{
// ItemIndex es 1 para el mensaje, luego cuenta por cada adjunto
string name = $"{item.ItemIndex:D2}-{item.SourceFileName}.pdf";
return File.Create(Path.Combine(outputFolder, name));
}, new PdfConvertOptions());
}
Paso 3 - Manejar adjuntos sin ruta a PDF
No todos los adjuntos pueden convertirse en PDF. Comprueba SaveContext.TargetFormat contra FileType.Unknown y guarda ese elemento bajo su propio nombre en lugar de 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());
Apunta este código a un correo de soporte de ejemplo con dos adjuntos ambos llamados report.csv y un adjunto en un formato no compatible. Obtendrás tres PDFs: el mensaje y ambos informes CSV. El archivo no compatible también se guarda, sin tocar; ábrelo junto al original y cada uno de sus 32 bytes coincidirá.
¿Cómo evito sobrescribir adjuntos que comparten un nombre de archivo?
Un nombre de archivo por sí solo no puede servir como clave segura para la salida, porque dos adjuntos pueden llevar exactamente el mismo. Incorpora SaveContext.ItemIndex al nombre junto con SaveContext.SourceFileName, y dos adjuntos llamados report.csv dejan de competir por la misma posición en disco; cada uno recibe su propio prefijo con ceros a la izquierda (02- y 03- en el ejemplo, después del 01- del mensaje) y su propio archivo, sea cual sea el nombre original.
Comparación lado a lado: antes vs. después
| Antes (Manual) | Después (GroupDocs.Conversion) | |
|---|---|---|
| Tiempo | Minutos por mensaje, manualmente | Unas pocas líneas de código, cualquier número de mensajes |
| Nombres duplicados | Sobrescritos silenciosamente | Mantidos separados mediante ItemIndex |
| Adjunto no compatible | Rompe toda la conversión (pre‑26.10) | Guardado bajo su propio nombre, la ejecución continúa |
| Salida | Lo que tu visor de PDF pueda guardar | PDFs estructurados que puedes archivar o indexar |
El correo de soporte del ejemplo está construido exactamente con esa combinación: dos exportaciones mensuales CSV con el mismo nombre y un archivo de captura que ningún convertidor reconoce.
Ejemplo del mundo real: archivado de casos de soporte
Un equipo de soporte registra cada caso de cliente como un correo con uno o más adjuntos de hoja de cálculo, y el sistema de seguimiento de casos necesita que cada adjunto se archive como su propio PDF buscable, separado del mensaje. Ejecutar el mensaje a través de KeepAttachmentsWithoutPdfRoute una vez por caso entrante convierte el mensaje y sus adjuntos en un conjunto numerado de archivos, sin que ningún adjunto sobrescriba a otro incluso cuando dos informes comparten nombre. Un correo de caso con dos exportaciones mensuales report.csv y un archivo de captura en un formato que nadie convierte produce cuatro archivos: el mensaje, ambos informes CSV como PDFs y el archivo de captura guardado bajo su propio nombre — nada se pierde, nada se fusiona, nada se sobrescribe silenciosamente.
// Una llamada por correo de caso – sin exportación manual, sin duplicados renombrados
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);
¿Qué más puedes hacer con GroupDocs.Conversion para .NET?
Más allá de separar un mensaje de sus adjuntos, EmailLoadOptions cubre más del propio mensaje:
- Visibilidad de campos: muestra u oculta el encabezado y sus líneas
From,To,CcyBccconDisplayHeadery las opciones relacionadasDisplay*(CcyBccestán ocultos por defecto). - Encabezados localizados: asigna cada
EmailFielda un título diferente conFieldTextMap, por ejemplo traduciendoSubjectyAttachmentsa otro idioma. - Formato de fecha: la línea
Sentsigue la cultura de la máquina que ejecuta la conversión, yTimeZoneOffsetestablece el desplazamiento UTC usado para las fechas del mensaje. - Salida solo del mensaje: establece
ConvertOwnedenfalsecuando el PDF solo necesita representar el mensaje, manteniendo los nombres de los adjuntos listados en el encabezado como referencia.
Consulta la referencia completa de EmailLoadOptions para cada opción.
Conclusión
Lo que antes significaba abrir un mensaje, guardar los adjuntos manualmente y volver a comprobar duplicados sobrescritos ahora se reduce a una devolución de llamada SaveContext y unas pocas líneas de código. GroupDocs.Conversion para .NET asigna a cada elemento de salida —el mensaje y cada adjunto— un nombre que nunca colisiona, y conserva un adjunto sin ruta a PDF en lugar de fallar la ejecución. Los mismos tres bloques de construcción —ConvertOwner, ConvertOwned y la devolución de llamada SaveContext— escalan desde un único PDF resumido hasta una descomposición completa y segura contra colisiones de un mensaje y todos sus adjuntos, de modo que puedes comenzar pequeño y crecer hasta el flujo de trabajo completo según lo requiera tu bandeja de entrada.
¿Listo para automatizar tu flujo de trabajo de email a PDF?
- Prueba una licencia temporal gratuita
- Explora convertir cada adjunto de correo a un formato de salida diferente
- Lee la referencia completa de EmailLoadOptions
- Consulta el proyecto de ejemplo en GitHub