跳到主要内容

转换和下载文件

文档转换服务是ONLYOFFICE 文档的一部分。它在支持的格式之间转换文档文件——用于准备编辑或以用户需要的格式导出。

文档编辑器使用编辑器的原生格式处理文件:文本文档为.docx,电子表格为.xlsx,演示文稿为.pptx,PDF为.pdf

默认行为

文档编辑服务打开文件时会自动将其转换为原生格式——集成商无需调用转换API。保存时,assemblyFormatAsOrigin服务器设置(默认启用)确保文件被转换回其原始格式。有关详细信息,请参阅以原始格式保存

编辑前转换

如果集成商需要在将文件传递给编辑器之前进行转换——例如,以原生格式存储文件——可以显式使用转换API

以下图示和步骤解释了此过程。

编辑前转换

  1. 用户选择要上传到文档管理器的文件。
  2. 文档管理器将文件上传到文档存储服务
  3. 文档存储服务使用转换API将文件发送到文档转换服务,以将其转换为适当的原生格式。
  4. 文档转换服务将文件转换为原生格式。
  5. 文档存储服务下载已转换的文件。

下载时转换

当用户需要以非原生格式下载文件时——无论是从文档管理器还是直接从文档编辑器——文档转换服务会在下载前进行转换。

从文档管理器

以下图示和步骤解释了从文档管理器下载的过程。

文档导出

  1. 用户在文档管理器中选择文件并选择下载格式。
  2. 文档管理器将请求发送到文档存储服务
  3. 文档存储服务使用转换API将文件发送到文档转换服务,以将其转换为请求的格式。
  4. 文档转换服务将文件转换为请求的格式。
  5. 转换完成后,文档存储服务下载已转换的文件。
  6. 文档存储服务将已转换的文件发送到文档管理器
  7. 文档管理器将已转换的文件提供给用户下载。

从文档编辑器

  1. 用户在文档编辑器中选择下载格式。
  2. 文档编辑器将当前文档状态发送到文档编辑服务
  3. 文档编辑服务将文件发送到文档转换服务,以将其转换为请求的格式。
  4. 文档转换服务将文件转换为请求的格式。
  5. 文档编辑服务将已转换的文件发送到文档编辑器
  6. 文档编辑器将已转换的文件提供给用户下载。