Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Large diffs are not rendered by default.

Original file line number Diff line number Diff line change
@@ -1,55 +1,56 @@
---
date: '2026-01-05'
description: 了解如何使用 GroupDocs.Viewer for Java 重命名电子邮件字段、将电子邮件转换为 HTML,并自定义电子邮件头部。
date: '2026-03-24'
description: 了解如何使用 GroupDocs Viewer for Java 将电子邮件转换为 HTML 并重命名电子邮件字段。本指南展示了使用自定义标题将电子邮件渲染为
HTML。
keywords:
- rename email fields Java
- render emails HTML GroupDocs Viewer
- customize email metadata Java
title: 使用 GroupDocs.Viewer Java 将电子邮件渲染为 HTML 时如何重命名电子邮件字段
title: 将电子邮件转换为HTML并重命名字段 – GroupDocs Viewer Java
type: docs
url: /zh/java/advanced-rendering/rename-email-fields-html-groupdocs-viewer-java/
weight: 1
---

# 如何在使用 GroupDocs.Viewer Java 将电子邮件渲染为 HTML 时重命名电子邮件字段
# 将电子邮件转换为 HTML 并重命名字段 – GroupDocs Viewer Java

您是否想了解在将电子邮件转换为 HTML 时**如何重命名电子邮件**字段?在本指南中,我们将逐步演示如何重命名电子邮件字段、**将电子邮件转换为 HTML**以及使用 GroupDocs.Viewer for Java **自定义电子邮件标题**。完成后,您将获得带有首选标题名称的干净 HTML 表示,使输出更易于阅读并集成到您的应用程序中
如果您需要 **convert email to HTML** 并为电子邮件标题提供自定义外观,您来对地方了。 在本教程中,我们将逐步演示如何重命名电子邮件字段、**convert email to HTML**以及使用 GroupDocs.Viewer for Java 自定义电子邮件标题完成后,您将获得一个干净的 HTML 表示,其中包含您偏好的标题名称,使输出更易阅读并可集成到您的应用程序中

![Rename Email Fields When Converting Emails to HTML with GroupDocs.Viewer for Java](/viewer/advanced-rendering/rename-email-fields-when-converting-emails-to-html-java.png)
![在将电子邮件转换为 HTML 时重命名电子邮件字段 - 使用 GroupDocs.Viewer for Java](/viewer/advanced-rendering/rename-email-fields-when-converting-emails-to-html-java.png)

### 您将学习的内容
- 如何使用 GroupDocs.Viewer for Java **将电子邮件转换为 HTML**。
- 如何 **重命名电子邮件字段**,例如 “From”、 “To”、 “Sent”“Subject”。
### 您将学习
- 如何使用 GroupDocs.Viewer for Java 将 **convert email to HTML**。
- **rename email fields**(如 “From”、 “To”、 “Sent”“Subject”)的技术
- 设置 Maven 和许可证的最佳实践。
- **自定义电子邮件标题** 能增值的真实场景
- 实际场景中 **customizing email headers** 能带来价值

## 快速答案
- **“如何重命名电子邮件”是什么意思?** 它指在渲染过程中将默认的电子邮件标题名称映射为自定义标签
- **哪个库负责转换?** GroupDocs.Viewer for Javav25.2+
- **“convert email to HTML” 是什么意思?** 它表示将电子邮件文件(MSG/EML)渲染为可在网页上显示的 HTML 文档
- **哪个库负责转换?** GroupDocs.Viewer for Java (v25.2+)
- **我需要许可证吗?** 试用版可用于评估;生产环境需要完整许可证。
- **我可以更改任何标题名称吗?** 可以,任何标准电子邮件标题都可以通过 `fieldTextMap` 重新映射。
- **输出是 HTML 还是嵌入资源?** 您可以选择嵌入资源,以获得单个自包含文件。

## 在 GroupDocs.Viewer 上下文中,“如何重命名电子邮件” 是什么?
重命名电子邮件字段是指在将电子邮件渲染为 HTML 时,将默认标签(例如 “From”)替换为自定义文本(例如 “Sender”)。这有助于使输出与企业术语保持一致或提升终端用户的可读性
## 在 GroupDocs.Viewer 中,“convert email to HTML” 是什么?
将电子邮件转换为 HTML 意味着获取原始电子邮件文件并生成一个显示邮件正文及其元数据的 HTML 页面。当您同时 **rename email fields** 时,默认标签(例如 “From”)会被自定义文本(例如 “Sender”)替换,这有助于匹配企业术语或提升 UI 一致性

## 为什么将电子邮件转换为 HTML 并自定义电子邮件标题
- **一致的品牌形象:** 在所有通信中匹配组织的语言
- **提升可搜索性:** 自定义标题可以在归档系统中更有效地建立索引
- **更好的 UI 集成:** 定制 HTML 片段,使其无缝嵌入网页门户或支持仪表板
## 为什么要将电子邮件转换为 HTML 并重命名电子邮件字段
- **Consistent branding:** 将输出与组织的语言保持一致
- **Improved searchability:** 在归档系统中,定制的标题可以更有效地被索引
- **Better UI integration:** 定制 HTML 片段,使其无缝集成到网页门户或支持仪表板中

## 前置条件
## 前提条件

### 必需的库、版本和依赖项
- **GroupDocs.Viewer for Java** – 版本 25.2 或更高。
- **Java Development Kit (JDK)** – 版本 8+。

### 环境搭建要求
### 环境设置要求
- **Maven** 用于依赖管理。
- IDE,例如 IntelliJ IDEA、Eclipse 或 VS Code。
- IDE IntelliJ IDEA、Eclipse 或 VS Code。

### 知识前提
具备基本的 Java 和 Maven 知识将帮助您快速跟进
基础的 Java 和 Maven 知识将帮助您快速跟随教程

## 设置 GroupDocs.Viewer for Java

Expand All @@ -71,10 +72,10 @@ weight: 1
</dependencies>
```

### 获取许可证的步骤
- **免费试用:** 从 [GroupDocs Releases](https://releases.groupdocs.com/viewer/java/) 下载免费试用版。
- **临时许可证:** 在 [GroupDocs Temporary License](https://purchase.groupdocs.com/temporary-license/) 获取临时许可证,以无限制地探索全部功能。
- **购买:** 如需持续使用,请通过 [GroupDocs Purchase](https://purchase.groupdocs.com/buy) 购买许可证。
### 获取许可证步骤
- **Free Trial:** 从 [GroupDocs Releases](https://releases.groupdocs.com/viewer/java/) 下载免费试用版。
- **Temporary License:** 在 [GroupDocs Temporary License](https://purchase.groupdocs.com/temporary-license/) 获取临时许可证,以无限制地探索全部功能。
- **Purchase:** 若需持续使用,请通过 [GroupDocs Purchase](https://purchase.groupdocs.com/buy) 购买许可证。

### 基本初始化和设置
```java
Expand All @@ -90,25 +91,23 @@ public class ViewerSetup {
```
将文件路径调整为指向您的 `.msg` 文件。

## 实现指南
## 如何将电子邮件转换为 HTML 并重命名字段 – 步骤详解

### 重命名电子邮件字段 – 步骤详解

#### 1. 设置输出目录路径
### 1. 设置输出目录路径
```java
import java.nio.file.Path;

Path outputDirectory = Utils.getOutputDirectoryPath("YOUR_OUTPUT_DIRECTORY");
```
*将 `"YOUR_OUTPUT_DIRECTORY"` 替换为您希望保存 HTML 文件的文件夹。*

#### 2. 定义页面文件路径格式
### 2. 定义页面文件路径格式
```java
Path pageFilePathFormat = outputDirectory.resolve("page_{0}.html");
```
*渲染时,`{0}` 将被页面编号替换。*

#### 3. 创建电子邮件字段到新名称的映射
### 3. 创建电子邮件字段到新名称的映射
```java
import com.groupdocs.viewer.options.Field;
import java.util.HashMap;
Expand All @@ -122,7 +121,7 @@ fieldTextMap.put(Field.SUBJECT, "Topic");
```
*此处将默认标签更改为自定义标签。*

#### 4. 配置 HTML 视图选项
### 4. 配置 HTML 视图选项
```java
import com.groupdocs.viewer.options.HtmlViewOptions;

Expand All @@ -131,7 +130,7 @@ viewOptions.getEmailOptions().setFieldTextMap(fieldTextMap);
```
*`forEmbeddedResources` 将 CSS/JS 打包到 HTML 中,而 `setFieldTextMap` 应用自定义标题名称。*

#### 5. 将电子邮件渲染为 HTML
### 5. 将电子邮件渲染为 HTML
```java
try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MSG")) {
viewer.view(viewOptions);
Expand All @@ -142,49 +141,49 @@ try (Viewer viewer = new Viewer("YOUR_DOCUMENT_DIRECTORY/SAMPLE_MSG")) {
#### 故障排除提示
- 确认输出目录可写。
- 确保输入的 MSG 文件存在且路径正确。
- 使用与 Maven 中声明的相同 GroupDocs.Viewer 版本(25.2)。
- 使用与 Maven 中声明的相同的 GroupDocs.Viewer 版本(25.2)。

## 实际应用
1. **自定义电子邮件报告:** 将电子邮件标题与企业术语对齐,以获得更清晰的报告。
2. **电子邮件归档系统:** 使用标准化的标题名称提升可搜索性
3. **客户支持平台:** 使用个性化的标题标签呈现工单,以提升客服体验。
1. **Custom Email Reports:** 将电子邮件标题与企业术语对齐,以获得更清晰的报告。
2. **Email Archiving Systems:** 通过使用标准化的标题名称提升可搜索性
3. **Customer Support Platforms:** 使用个性化的标题标签呈现工单,以提升客服体验。

## 性能考虑因素
- 使用 try‑with‑resources 释放 `Viewer` 对象,以及时释放内存
- 对大批量进行性能分析,并在需要时考虑使用并行流处理电子邮件
## 性能考虑
- 使用 try‑with‑resources 释放 `Viewer` 对象,以快速回收内存
- 对大批量进行性能分析,必要时考虑使用并行流处理电子邮件

## 结论
您现在已经了解如何在使用 GroupDocs.Viewer for Java **将电子邮件转换为 HTML** 的同时 **重命名电子邮件** 字段以及 **自定义电子邮件标题**。此技术让您能够全面控制 HTML 输出中电子邮件元数据的呈现方式。
您现在了解了如何使用 GroupDocs.Viewer for Java **convert email to HTML**、**rename email fields** 和 **customize email headers**。此技术让您完全掌控 HTML 输出中电子邮件元数据的呈现方式。

### 后续步骤
- 尝试其他字段映射(例如 CC、BCC)。
### 下一步
- 尝试更多字段映射(例如 CC、BCC)。
- 探索其他渲染格式,如 PDF 或 PNG。
- 访问 [GroupDocs Documentation](https://docs.groupdocs.com/viewer/java/) 获取更深入的 API 见解。

## 常见问答
## 常见问题

**问:此方法是否适用于其他电子邮件格式,如 EML?**
答:是的,GroupDocs.Viewer 支持 MSG 和 EML 文件;相同的字段映射逻辑适用。
**Q: 此方法是否适用于其他电子邮件格式,如 EML?**
A: 是的,GroupDocs.Viewer 支持 MSG 和 EML 文件;相同的字段映射逻辑适用。

**问:我可以输出不带嵌入资源的 HTML 吗?**
答:如果您更喜欢分离的 CSS/JS 文件,可以使用 `HtmlViewOptions.forExternalResources(...)`。
**Q: 我可以输出不包含嵌入资源的 HTML 吗?**
A: 如果您更喜欢使用独立的 CSS/JS 文件,可以使用 `HtmlViewOptions.forExternalResources(...)`。

**问:测试使用的 GroupDocs.Viewer 版本是什么?**
答:代码在 GroupDocs.Viewer **25.2** 上进行测试
**Q: 测试使用的 GroupDocs.Viewer 版本是什么?**
A: 代码已在 GroupDocs.Viewer **25.2** 上测试

**问:是否可以更改自定义标题的字体或样式?**
答:可以在渲染后通过 CSS 应用样式,或使用 `HtmlViewOptions.getResourcesPath()` 注入自定义 CSS。
**Q: 能否更改自定义标题的字体或样式?**
A: 渲染后可通过 CSS 应用样式,或使用 `HtmlViewOptions.getResourcesPath()` 注入自定义 CSS。

**问:如何以编程方式获取生成的 HTML 文件路径?**
答:文件路径遵循 `pageFilePathFormat` 中定义的模式;您可以使用 `String.format` 并传入页面编号来构建路径
**Q: 如何以编程方式获取生成的 HTML 文件路径?**
A: 文件路径遵循 `pageFilePathFormat` 中定义的模式;您可以使用 `String.format` 并传入页码来构建它

## 资源
- **文档:** 完整指南可在 [GroupDocs Documentation](https://docs.groupdocs.com/viewer/java/) 查看。
- **API 参考:** 详细的 API 信息可在 [GroupDocs API Reference](https://reference.groupdocs.com/viewer/java/) 找到。
- **下载 GroupDocs.Viewer** 通过 [Downloads Page](https://releases.groupdocs.com/viewer/java/) 获取最新版本。
- **Documentation:** 完整指南可在 [GroupDocs Documentation](https://docs.groupdocs.com/viewer/java/) 查看。
- **API Reference:** 详细的 API 信息可在 [GroupDocs API Reference](https://reference.groupdocs.com/viewer/java/) 找到。
- **Download GroupDocs.Viewer:** 可通过 [Downloads Page](https://releases.groupdocs.com/viewer/java/) 获取最新版本。

---

**最后更新:** 2026-01-05
**最后更新:** 2026-03-24
**测试版本:** GroupDocs.Viewer 25.2
**作者:** GroupDocs
Loading
Loading