將電子郵件轉換為 HTML 並重新命名欄位 – GroupDocs Viewer Java

如果您需要 將電子郵件轉換為 HTML 並為電子郵件標頭提供自訂外觀，您來對地方了。在本教學中，我們將逐步說明如何重新命名電子郵件欄位、將電子郵件轉換為 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 是指將原始的電子郵件檔案（MSG 或 EML）轉換成一個 HTML 頁面，該頁面同時顯示訊息內容與其中繼資料。當您同時 重新命名電子郵件欄位 時，預設的標籤（例如 “From”）會被自訂文字（例如 “Sender”）取代，這有助於符合企業用語或提升 UI 一致性。

為什麼要將電子郵件轉換為 HTML 並重新命名欄位？

將電子郵件轉換為 HTML 並重新命名其欄位，可讓您完整掌控訊息在最終使用者面前的呈現方式。自訂標頭能使輸出符合企業用語、提升搜尋索引效果，並且能無縫整合至網站入口或支援儀表板；HTML 格式則確保在各種瀏覽器與裝置上的相容性。

• 一致的品牌形象： 讓輸出符合貴組織的語言慣例。
• 提升搜尋能見度： 自訂標頭可在歸檔系統中更有效率地被索引。
• 更佳的 UI 整合： 調整 HTML 片段以無縫嵌入網站或支援儀表板。
• 效能優勢： GroupDocs.Viewer 可在標準伺服器上於 2 秒內處理高達 500 頁的電子郵件，且支援 50+ 種輸入與輸出格式，包括 MSG、EML、PDF 與 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 購買授權。

基本初始化與設定

Viewer 類別是 GroupDocs.Viewer for Java 中所有渲染操作的入口點。它會自動管理檔案載入、格式偵測與資源清理。

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 並重新命名欄位 – 步驟說明

載入電子郵件、定義欄位對映字典、設定 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 檢視選項

HtmlViewOptions 類別控制最終 HTML 的產生方式。設定 forEmbeddedResources 會將 CSS/JS 內嵌於 HTML 中，而 setFieldTextMap 則套用您先前定義的自訂標頭名稱。

import com.groupdocs.viewer.options.HtmlViewOptions;

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

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）。

實務應用

1. 自訂電子郵件報表： 讓電子郵件標頭符合企業用語，產出更清晰的報表。
2. 電子郵件歸檔系統： 透過標準化的標頭名稱提升搜尋能見度。
3. 客戶支援平台： 為工單呈現個性化的標頭標籤，提升客服人員的使用體驗。

效能考量

• 使用 try‑with‑resources 釋放 Viewer 物件，以即時回收記憶體。
• 若需處理大量批次，可考慮使用平行串流 (parallel streams) 進行並行處理。
• 由於採用串流架構，GroupDocs.Viewer 能在不將整個文件載入記憶體的情況下渲染 最高 200 MB 的電子郵件檔案。

結論

您現在已掌握 將電子郵件轉換為 HTML、重新命名電子郵件欄位 以及 自訂電子郵件標頭 的完整流程，並可在 GroupDocs.Viewer for Java 中靈活運用。此技巧讓您能全權控制 HTML 輸出中電子郵件中繼資料的呈現方式。

後續步驟

• 嘗試加入其他欄位對映（例如 CC、BCC）。
• 探索其他渲染格式，如 PDF 或 PNG。
• 前往 GroupDocs Documentation 瞭解更深入的 API 資訊。

常見問題

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 並傳入頁碼來組合完整路徑。

資源

• 文件說明： 完整指南請參閱 GroupDocs Documentation。
• API 參考： 詳細的 API 資訊可在 GroupDocs API Reference 找到。
• 下載 GroupDocs.Viewer： 前往 Downloads Page 取得最新版本。

最後更新： 2026-09-15
測試環境： GroupDocs.Viewer 25.2
作者： GroupDocs

相關教學

• 在 Java 中使用 GroupDocs.Viewer 將 EML 轉換為 HTML 並自訂日期時間
• java 轉換 msg 為 pdf – 使用 GroupDocs.Viewer 最佳化 Email 到 PDF 的渲染
• 使用 GroupDocs.Viewer Java 渲染文件附件為 HTML – 步驟指南