转换和下载文件
文档转换服务是ONLYOFFICE 文档的一部分。它在支持的格式之间转换文档文件——用于准备编辑或以用户需要的格式导出。
文档编辑器使用编辑器的原生格式处理文件:文本文档为.docx,电子表格为.xlsx,演示文稿为.pptx,PDF为.pdf。
默认行为
文档编辑服务在打开文件时会自动将其转换为原生格式——集成商无需调用转换API。保存时,assemblyFormatAsOrigin服务器设置(默认启用)确保文件被转换回其原始格式。有关详细信息,请参阅以原始格式保存。
编辑前转换
如果集成商需要在将文件传递给编辑器之前进行转换——例如,以原生格式存储文件——可以显式使用转换API。
以下图示和步骤解释了此过程。

- 用户选择要上传到文档管理器的文件。
- 文档管理器将文件上传到文档存储服务。
- 文档存储服务使用转换API将文件发送到文档转换服务,以将其转换为适当的原生格式。
- 文档转换服务将文件转换为原生格式。
- 文档存储服务下载已转换的文件。
下载时转换
当用户需要以非原生格式下载文件时——无论是从文档管理器还是直接从文档编辑器——文档转换服务会在下载前进行转换。
从文档管理器
以下图示和步骤解释了从文档管理器下载的过程。

- 用户在文档管理器中选择文件并选择下载格式。
- 文档管理器将请求发送到文档存储服务。
- 文档存储服务使用转换API将文件发送到文档转换服务,以将其转换为请求的格式。
- 文档转换服务将文件转换为请求的格式。
- 转换完成后,文档存储服务下载已转换的文件。
- 文档存储服务将已转换的文件发送到文档管理器。
- 文档管理器将已转换的文件提供给用户下载。
从文档编辑器
- 用户在文档编辑器中选择下载格式。
- 文档编辑器将当前文档状态发送到文档编辑服务。
- 文档编辑服务将文件发送到文档转换服务,以将其转换为请求的格式。
- 文档转换服务将文件转换为请求的格式。
- 文档编辑服务将已转换的文件发送到文档编辑器。
- 文档编辑器将已转换的文件提供给用户下载。