이메일을 HTML로 변환 및 필드 이름 바꾸기 – GroupDocs Viewer Java

이메일 헤더에 사용자 지정 모양을 적용하면서 이메일을 HTML로 변환해야 한다면, 여기가 바로 맞는 곳입니다. 이 튜토리얼에서는 이메일 필드 이름을 바꾸고, 이메일을 HTML로 변환하며, GroupDocs.Viewer for Java를 사용해 이메일 헤더를 사용자 지정하는 정확한 단계를 안내합니다. 최종적으로 원하는 헤더 이름이 적용된 깔끔한 HTML 표현을 얻어, 출력물을 더 쉽게 읽고 애플리케이션에 통합할 수 있습니다.

GroupDocs.Viewer for Java를 사용해 이메일을 HTML로 변환할 때 이메일 필드 이름 바꾸기

배울 내용

GroupDocs.Viewer for Java를 사용해 이메일을 HTML로 변환하는 방법.
“From”, “To”, “Sent”, “Subject”와 같은 이메일 필드 이름을 바꾸는 기술.
Maven 및 라이선스 설정을 위한 모범 사례.
이메일 헤더 사용자 지정이 가치를 더하는 실제 시나리오.

빠른 답변

“이메일을 HTML로 변환”이란 무엇인가요? 이메일 파일(MSG/EML)을 웹에 바로 사용할 수 있는 HTML 문서로 렌더링하는 것을 의미합니다.
어떤 라이브러리가 변환을 담당하나요? GroupDocs.Viewer for Java (v25.2+).
라이선스가 필요합니까? 평가용으로는 체험판을 사용할 수 있지만, 프로덕션에서는 정식 라이선스가 필요합니다.
헤더 이름을 모두 변경할 수 있나요? 네, 표준 이메일 헤더는 fieldTextMap을 통해 재매핑할 수 있습니다.
출력이 HTML인가요, 아니면 임베디드 리소스인가요? 단일 자체 포함 파일을 위해 임베디드 리소스를 선택할 수 있습니다.

GroupDocs.Viewer 컨텍스트에서 “이메일을 HTML로 변환”이란?

이메일을 HTML로 변환한다는 것은 원시 이메일 파일을 받아 메시지 본문과 메타데이터를 표시하는 HTML 페이지를 생성하는 것을 의미합니다. 또한 이메일 필드 이름을 바꾸면, 기본 라벨(예: “From”)이 사용자 지정 텍스트(예: “Sender”)로 교체되어 기업 용어에 맞추거나 UI 일관성을 향상시킬 수 있습니다.

왜 이메일을 HTML로 변환하고 필드 이름을 바꾸어야 할까요?

일관된 브랜딩: 출력물을 조직의 언어에 맞게 정렬합니다.
검색성 향상: 사용자 지정 헤더는 아카이브 시스템에서 더 효율적으로 인덱싱될 수 있습니다.
향상된 UI 통합: HTML 스니펫을 웹 포털이나 지원 대시보드에 원활히 맞출 수 있도록 맞춤화합니다.

사전 요구 사항

필수 라이브러리, 버전 및 종속성

GroupDocs.Viewer for Java – 버전 25.2 이상.
Java Development Kit (JDK) – 버전 8 이상.

환경 설정 요구 사항

Maven – 종속성 관리를 위해.
IntelliJ IDEA, Eclipse, VS Code와 같은 IDE.

지식 사전 요구 사항

기본적인 Java와 Maven에 대한 이해가 있으면 빠르게 따라올 수 있습니다.

GroupDocs.Viewer for Java 설정

Maven 구성

<repositories>
   <repository>
      <id>repository.groupdocs.com</id>
      <name>GroupDocs Repository</name>
      <url>https://releases.groupdocs.com/viewer/java/</url>
   </repository>
</repositories>
<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-viewer</artifactId>
      <version>25.2</version>
   </dependency>
</dependencies>

라이선스 획득 단계

무료 체험: GroupDocs Releases에서 무료 체험판을 다운로드합니다.
임시 라이선스: 제한 없이 전체 기능을 탐색하려면 GroupDocs Temporary License에서 임시 라이선스를 획득합니다.
구매: 지속적인 사용을 위해 GroupDocs Purchase에서 라이선스를 구매하는 것을 고려하십시오.

기본 초기화 및 설정

import com.groupdocs.viewer.Viewer;

public class ViewerSetup {
    public static void main(String[] args) {
        try (Viewer viewer = new Viewer("path/to/your/document.msg")) {
            // Perform operations here
        }
    }
}

파일 경로를 .msg 파일을 가리키도록 조정하십시오.

이메일을 HTML로 변환하고 필드 이름을 바꾸는 단계별 방법

1. 출력 디렉터리 경로 설정

import java.nio.file.Path;

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");

"YOUR_OUTPUT_DIRECTORY"를 HTML 파일을 저장하고 싶은 폴더 경로로 교체하십시오.

2. 페이지 파일 경로 형식 정의

Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");

렌더링 중에 {0}이 페이지 번호로 대체됩니다.

3. 이메일 필드와 새 이름 매핑 만들기

import com.groupdocs.viewer.options.Field;
import java.util.HashMap;
import java.util.Map;

Map<Field, String> fieldTextMap = new HashMap<>();
fieldTextMap.put(Field.FROM, "Sender");
fieldTextMap.put(Field.TO, "Receiver");
fieldTextMap.put(Field.SENT, "Date");
fieldTextMap.put(Field.SUBJECT, "Topic");

여기서 기본 라벨을 사용자 지정 라벨로 변경합니다.

4. HTML 보기 옵션 구성

import com.groupdocs.viewer.options.HtmlViewOptions;

HtmlViewOptions viewOptions = HtmlViewOptions.forEmbeddedResources(pageFilePathFormat);
viewOptions.getEmailOptions().setFieldTextMap(fieldTextMap);

forEmbeddedResources는 CSS/JS를 HTML 내부에 번들링하고, setFieldTextMap은 사용자 지정 헤더 이름을 적용합니다.

5. 이메일을 HTML로 렌더링

try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MSG")) {
    viewer.view(viewOptions);
}

"YOUR_DOCUMENT_DIRECTORY/SAMPLE_MSG"를 실제 MSG 파일 경로로 교체하십시오.

문제 해결 팁

출력 디렉터리에 쓰기 권한이 있는지 확인하십시오.
입력 MSG 파일이 존재하고 경로가 올바른지 확인하십시오.
Maven에 선언된 것과 동일한 GroupDocs.Viewer 버전(25.2)을 사용하십시오.

실용적인 적용 사례

맞춤형 이메일 보고서: 이메일 헤더를 기업 용어에 맞추어 보다 명확한 보고서를 제공합니다.
이메일 아카이빙 시스템: 표준화된 헤더 이름을 사용해 검색성을 향상시킵니다.
고객 지원 플랫폼: 티켓을 개인화된 헤더 라벨로 표시해 에이전트 경험을 개선합니다.

성능 고려 사항

Viewer 객체를 try‑with‑resources 구문으로 해제하여 메모리를 즉시 해제합니다.
대용량 배치를 프로파일링하고 필요 시 병렬 스트림으로 이메일을 처리하는 것을 고려하십시오.

결론

이제 GroupDocs.Viewer for Java를 사용해 이메일을 HTML로 변환하고 이메일 필드 이름을 바꾸며 이메일 헤더를 사용자 지정하는 방법을 알게 되었습니다. 이 기술을 통해 HTML 출력물에서 이메일 메타데이터의 표시를 완전히 제어할 수 있습니다.

다음 단계

추가 필드 매핑(예: CC, BCC)을 실험해 보십시오.
PDF 또는 PNG와 같은 다른 렌더링 형식을 탐색하십시오.
더 깊은 API 통찰을 위해 GroupDocs Documentation을 방문하십시오.

자주 묻는 질문

Q: 이 방법이 EML과 같은 다른 이메일 형식에도 적용되나요?
A: 네, GroupDocs.Viewer는 MSG와 EML 파일 모두를 지원하며 동일한 필드 매핑 로직이 적용됩니다.

Q: 임베디드 리소스 없이 HTML을 출력할 수 있나요?
A: 별도의 CSS/JS 파일을 원한다면 HtmlViewOptions.forExternalResources(...)를 사용할 수 있습니다.

Q: 어떤 버전의 GroupDocs.Viewer를 테스트했나요?
A: 코드는 GroupDocs.Viewer 25.2 버전으로 테스트되었습니다.

Q: 사용자 지정 헤더의 글꼴이나 스타일을 변경할 수 있나요?
A: 렌더링 후 CSS를 통해 스타일을 적용하거나 HtmlViewOptions.getResourcesPath()를 사용해 사용자 지정 CSS를 삽입할 수 있습니다.

Q: 생성된 HTML 파일 경로를 프로그래밍 방식으로 어떻게 가져오나요?
A: 파일 경로는 pageFilePathFormat에 정의된 패턴을 따르며, 페이지 번호와 함께 String.format을 사용해 구성할 수 있습니다.

리소스

Documentation: 포괄적인 가이드는 GroupDocs Documentation에서 확인할 수 있습니다.
API Reference: 자세한 API 정보는 GroupDocs API Reference에서 확인할 수 있습니다.
Download GroupDocs.Viewer: 최신 버전은 Downloads Page에서 다운로드할 수 있습니다.

Last Updated: 2026-03-24
Tested With: GroupDocs.Viewer 25.2
Author: GroupDocs