导出至 Word - 概述

CKEditor 云服务提供快速且高度可扩展的服务，使用户能够将文档导出至 Microsoft Word .docx 文件。该功能作为一项服务提供，可以将 HTML 字符串直接发送至云服务服务器以实现更高级的用途，也可以作为方便的 CKEditor 5 所见即所得编辑器插件，以便在不太苛刻的情况下易于使用。

# 导出至 Word 功能的工作原理

HTML 至 DOCX 转换器提供了一个 API，用于将 HTML 文档转换为 Microsoft Word .docx 文件。该服务生成一个 Word 文件并将其返回给用户，以便用户将其以 .docx 格式保存到磁盘。要将此功能集成到您的环境中，请先查看 快速入门 指南以开始使用它。

您也可以使用 导出至 Word 演示页面 测试此功能。

# HTML 至 DOCX 转换器选项

使用转换器服务时，可以使用以下选项

• html
• css
• config

# HTML

任何符合 HTML5 规范的内容都可以发送至转换器。

# CSS

一个 CSS 样式表，将在 HTML 至 DOCX 转换期间用于对文档内容进行样式设置。

样式可以在 HTML 中直接内联应用，但建议通过 css 选项添加这些样式，以减少 HTTP 请求有效负载的大小。

# 配置

config 选项允许在生成的文档中添加页眉和页脚，并集成协作功能。它提供以下选项

• document – 设置各种文档属性。
• headers – 在生成的 Word 文档中添加页眉。
• footers – 在生成的 Word 文档中添加页脚。
• collaboration_features – 为文档中包含的评论和建议提供元数据。
• base_url – 设置用于图像和链接的所有相对 URL 的基本 URL。
• extra_http_headers – 允许设置需要额外授权的资源的额外 HTTP 标头。
• timezone – 为不支持时区的日期和时间指定时区。
• merge_fields – 为文档中包含的合并域提供配置和数据。
• watermark – 在生成的 Word 文档中添加水印。

您可以在 转换器文档 中了解有关使用选项的更多信息。

# 导出至 Word 插件

导出至 Word CKEditor 插件 允许您轻松地将所见即所得编辑器内容打印到 .docx 文件。启用此功能后，此功能将发送编辑器的内容以及用于显示它的样式到 CKEditor 云服务 HTML 至 Word 转换器服务。然后，该服务将生成一个 Word 文档，用户可以下载该文档。

由于有了这个插件，只需单击一次按钮，就可以获得一个 .docx 文件，其内容格式与 CKEditor 5 所见即所得编辑器中的格式相同。这对于集成来说是一个简单的解决方案，它不需要在编辑数据后进一步处理编辑器数据。

# 存储的数据

导出至 Word 服务是一项服务，它根据客户提供的数据（HTML、CSS）生成 .docx 文件。为了执行转换，它需要从编辑器或数据库发送的数据，但该服务本身是完全无状态的。

数据（尤其是您的敏感数据：HTML、CSS、评论、建议）仅在处理期间使用。但是，我们会存储一些用于计费和维护系统的信息。我们尝试将存储的数据减少到必要的最低限度，目前我们存储的信息包括导出次数和持续时间、最终文档大小、唯一导出次数以及统计数据（使用功能、IP 地址、编辑器版本）。

与处理请求相关的日志仅在出现意外情况时保存，并保存 14 天。日志中的数据包括错误消息、堆栈跟踪和有关请求的信息。