💡 전체 작업 예제가 GitHub에 있습니다: convert-email-and-attachments-to-pdf-dotnet

Email-to-PDF 변환은 .NET용 GroupDocs.Conversion 워크플로우로, Outlook 메시지와 그 첨부 파일을 하나 이상의 PDF 파일로 변환하며, 하나의 첨부 파일이 다른 파일을 덮어쓰거나 지원되지 않는 파일이 전체 실행을 중단시키지 않게 합니다. 수동으로 내보내고 이름을 바꾸는 절차를 몇 줄의 코드로 대체하며, 각 항목이 어디에서 왔는지, 변환되었는지 여부를 알 수 있습니다.

이전 방식은 고통스러웠다

지원 인박스를 상상해 보세요. 각 사례 이메일에 두세 개의 첨부 파일이 들어 있습니다—여기서는 보고서, 저기서는 스크린샷, 때로는 팀에서 인식하지 못하는 파일 형식도 있습니다. 이는 특이한 일이 아닙니다. 해당 사례를 정리하려면 메시지를 열고, 각 첨부 파일을 수동으로 저장하고, 두 시스템이 모두 report.csv라는 파일을 내보냈기 때문에 충돌하는 파일의 이름을 바꾸고, 그 중 어떤 파일도 PDF 뷰어가 열 수 없는 형식이 없기를 바라야 합니다. 이를 주당 50번씩 수행하면 ‘빠른 내보내기’가 작업 중 가장 느린 부분이 되고, 가장 서두르기 쉬운 부분이 되어 바로 그때 실수가 발생합니다.

수동으로 수행하는 것은 단순히 시간이 드는 것이 아니라 파일이 조용히 사라지는 원인이 되기도 합니다. report.csv라는 이름의 두 첨부 파일을 먼저 이름을 바꾸지 않고 같은 폴더에 저장하면 두 번째 저장이 첫 번째를 덮어씁니다; 9월 데이터가 사라질 때까지 아무도 눈치채지 못합니다. 팀에 변환기가 없는 형식의 첨부 파일 하나만 있어도 전체 내보내기가 중단될 수 있으며, 누군가 처리 방법을 결정할 때까지 멈춰 있습니다.

수동으로 수행할 때의 실제 비용: 이름이 바뀌고 덮어쓴 첨부 파일은 오류를 발생시키지 않고 조용히 사라지며, 사례 파일은 완전해 보이다가 해당 데이터가 필요해질 때 문제가 됩니다.

더 나은 방법이 있습니다

GroupDocs.Conversion for .NET은 이를 몇 줄의 코드로 바꿔줍니다. 수동 이름 변경이 필요 없습니다. EmailLoadOptions 클래스는 메시지, 첨부 파일 또는 둘 다를 변환할지 제어하고, SaveContext 콜백은 모든 출력 항목을 충분히 설명하여 report.csv라는 이름의 두 첨부 파일이 충돌하지 않으며 PDF 변환 경로가 없는 첨부 파일이 나머지 실행을 멈추지 않게 합니다. 해당 콜백이 호출될 때마다 ItemIndex(1부터 시작하는 연속 번호), HierarchyLevel(메시지는 0, 첨부 파일은 1), SourceFileName(원본 파일 이름)를 보고하므로 추가 기록 없이 충돌 없는 출력 이름을 만들기에 충분한 컨텍스트가 제공됩니다.

시작하기 전에 다음이 필요합니다:

  • .NET SDK 8.0 이상
  • GroupDocs.Conversion for .NET 26.10.0 (임시 라이선스 받기 평가 제한을 제거하려면)
  • 변환할 Outlook .msg 또는 .eml 메시지

한 명령으로 설치:

dotnet add package GroupDocs.Conversion --version 26.10.0

새로운 방법: 메시지와 첨부 파일 변환

다음은 동일한 작업을 GroupDocs.Conversion으로 수행한 모습입니다. 아래 예제는 Outlook 메시지와 그 모든 첨부 파일을 각각의 PDF로 변환하며, 파일 이름이 절대 충돌하지 않도록 합니다.

1단계 - 변환 대상 결정

EmailLoadOptions.ConvertOwner와 ConvertOwned는 메시지와 첨부 파일을 각각 켜거나 끌 수 있으며, Depth(기본값 2)는 중첩된 첨부 파일을 따라갈 깊이를 제한합니다.

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

2단계 - SaveContext를 사용해 모든 출력에 이름 지정

Converter.Convert에 고정된 출력 경로 대신 SaveContext 콜백을 전달합니다. 콜백은 항목당 한 번씩 호출되며, 두 첨부 파일이 같은 파일 이름을 공유하더라도 ItemIndex가 각 항목마다 고유합니다.

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

3단계 - PDF 변환 경로가 없는 첨부 파일 처리

모든 첨부 파일이 PDF가 될 수 있는 것은 아닙니다. SaveContext.TargetFormat을 FileType.Unknown과 비교하여 해당 항목을 변환하지 않고 원래 이름으로 저장합니다.

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

위 코드를 두 개의 report.csv 첨부 파일과 지원되지 않는 형식의 첨부 파일이 있는 샘플 지원 이메일에 적용해 보세요. 세 개의 PDF가 생성됩니다: 메시지와 두 개의 CSV 보고서. 지원되지 않는 파일도 그대로 저장됩니다—원본과 나란히 열어 보면 32바이트 각각이 정확히 일치합니다.

파일 이름이 같은 첨부 파일이 덮어쓰이는 것을 어떻게 방지할 수 있나요?

파일 이름만으로는 출력에 대한 안전한 키가 될 수 없습니다. 두 첨부 파일이 정확히 같은 이름을 가질 수 있기 때문입니다. SaveContext.ItemIndex를 SaveContext.SourceFileName과 결합해 이름에 포함시키면 report.csv라는 두 첨부 파일이 디스크상의 동일 슬롯을 경쟁하지 않게 됩니다; 각각은 자체적인 0패딩 접두사(샘플에서는 메시지의 01-뒤에02-와 03-`)와 원본이 사용한 이름을 그대로 가진 파일을 갖게 됩니다.

비교: 이전 vs. 이후

이전 (수동) 이후 (GroupDocs.Conversion)
시간 메시지당 몇 분, 수동 몇 줄의 코드로, 메시지 수에 제한 없음
중복 이름 조용히 덮어쓰기 ItemIndex로 별도 유지
지원되지 않는 첨부 파일 전체 변환 중단 (26.10 이전) 그 자체 이름으로 저장, 실행 계속
출력 PDF 뷰어가 저장할 수 있는 모든 것 파일하거나 색인할 수 있는 구조화된 PDF

샘플 지원 이메일은 바로 그 조합으로 구성됩니다: 같은 이름을 가진 두 개의 월간 CSV 내보내기와 변환기가 인식하지 못하는 하나의 캡처 파일.

실제 사례: 지원 사례 보관

지원 팀은 모든 고객 사례를 하나 이상의 스프레드시트 첨부 파일이 있는 이메일로 기록하고, 사례 추적 시스템은 각 첨부 파일을 메시지와 별도로 검색 가능한 PDF로 저장해야 합니다. 들어오는 각 사례에 대해 KeepAttachmentsWithoutPdfRoute를 한 번 실행하면 메시지와 첨부 파일이 번호가 매겨진 파일 집합으로 변환되며, 두 보고서가 같은 이름을 공유하더라도 첨부 파일이 서로 덮어쓰이지 않습니다. 두 개의 월간 report.csv 내보내기와 변환되지 않는 형식의 캡처 파일이 포함된 사례 이메일은 네 개의 파일로 출력됩니다: 메시지, 두 CSV 보고서 PDF, 그리고 캡처 파일은 자체 이름으로 저장됩니다—삭제도, 병합도, 조용히 덮어쓰기도 없습니다.

// 각 사례 이메일당 한 번 호출 - 수동 내보내기 없음, 이름 변경된 중복 없음
int kept = KeepAttachmentsWithoutPdfRoute(caseMessagePath, caseOutputFolder);

GroupDocs.Conversion for .NET로 할 수 있는 다른 일은 무엇인가요?

메시지를 첨부 파일과 분리하는 것 외에도, EmailLoadOptions는 메시지 자체에 대한 추가 옵션을 제공합니다:

  • 필드 가시성: DisplayHeader와 관련 Display* 옵션을 사용해 헤더와 From, To, Cc, Bcc 라인을 표시하거나 숨깁니다(Cc와 Bcc는 기본적으로 숨김).
  • 현지화된 헤더: FieldTextMap을 사용해 각 EmailField를 다른 캡션으로 매핑합니다. 예를 들어 Subject와 Attachments를 다른 언어로 번역할 수 있습니다.
  • 날짜 형식 지정: Sent 라인은 변환을 실행하는 머신의 문화권을 따르며, TimeZoneOffset은 메시지 날짜에 사용되는 UTC 오프셋을 설정합니다.
  • 메시지만 출력: PDF가 메시지만을 대체하면 되고 첨부 파일 이름은 헤더에 참고용으로 남겨두려면 ConvertOwned를 false로 설정합니다.

모든 옵션에 대한 전체 EmailLoadOptions 참조를 확인하세요.

결론

이전에는 메시지를 열고, 첨부 파일을 수동으로 저장하고, 덮어쓴 중복 파일을 다시 확인해야 했지만, 이제는 SaveContext 콜백과 몇 줄의 코드만 있으면 됩니다. GroupDocs.Conversion for .NET은 모든 출력 항목—메시지와 각 첨부 파일—에 충돌 없는 이름을 부여하고, PDF 변환 경로가 없는 첨부 파일은 실행을 중단시키지 않고 유지합니다. 동일한 세 가지 구성 요소—ConvertOwner, ConvertOwned, SaveContext 콜백—는 단일 요약 PDF에서 메시지와 모든 첨부 파일을 충돌 없이 분해하는 전체 작업까지 확장되므로, 인박스 요구에 따라 작게 시작해 전체 워크플로우로 확장할 수 있습니다.

이메일을 PDF로 변환하는 워크플로우를 자동화할 준비가 되셨나요?

추가 리소스