【onlyoffice中文指南】1-onlyoffice的工作原理

作者	日期
雨中星辰	2018-12-20

在ONLYOFFICE文档服务器中处理文档文件是一个非常简单的过程，但它需要了解当您单击文档链接以在浏览器中打开它时发生的情况，或者保存文档或将其从计算机上传到文档服务器。

用户文档交互在客户端和服务器端完成。

下面解释了当前文档中使用的主要概念。

客户方包括：

• 文档管理器 - 用户浏览器中显示的文档列表，用户可以在其中选择所需文档并使用它执行某些操作（根据提供的权限，用户可以打开文档查看或编辑，与之共享文档其他用户）。
• 文档编辑器 - 文档查看和编辑界面，具有所有最常用的文档编辑功能，用作用户和文档编辑服务之间的媒介。

服务器端包括：

• 文档存储服务 - 存储具有适当访问权限的用户可用的所有文档的服务器服务。它将文档ID和这些文档的链接提供给用户在浏览器中看到的文档管理器。
• 文档编辑服务 - 允许执行文档查看和编辑的服务器服务（如果用户具有相应的权限）。该文档编辑器界面来访问所有的文档编辑服务功能。
• 文档命令服务 - 允许使用文档编辑服务执行其他命令的服务器服务。
• 文档转换服务 - 允许将文档文件转换为适当的Office Open XML格式（文档文档的docx，电子表格的xlsx和演示文稿的pptx）以进行编辑或下载的服务器服务。

请注意，ONLYOFFICE文件服务器包括文档编辑器，文档编辑服务，文档命令服务和文档转换服务。该文档管理和文档存储服务都可能包含在以社区服务器或必须由谁自己的服务器上使用ONLYOFFICE文件服务器软件集成来实现。

onlyoffice的工作原理

下面取用 onlyoffice-confluence项目来说明onlyoffice的工作原理，关于更多onlyoffice-confluence的信息可查看githup.

ONLYOFFICE集成遵循此处记录的APIhttps://api.onlyoffice.com/editors/basic：

• 用户导航到Confluence附件并选择Edit in ONLYOFFICE操作。
• Confluence向OnlyOfficeEditorServlet发出请求（表单的URL :) /plugins/servlet/onlyoffice/doceditor?attachmentId=$attachment.id。
• Confluence将文档发送到ONLYOFFICE文档存储服务并接收临时链接。
• Confluence准备具有以下属性的JSON对象：
  • fileUrl：ONLYOFFICE文档服务器用于下载文档的临时链接，
  • callbackUrl：ONLYOFFICE文档服务器通知文档编辑状态的URL，
  • docserviceApiUrl：客户端需要回复ONLYOFFICE文档服务器的URL（由files.docservice.url.api属性提供），
  • key：UUID指示ONLYOFFICE文件服务器是否再次下载文件，
  • fileName：文档标题（名称）。
• Confluence接受此对象并从freemarker模板构造一个页面，填充所有这些值，以便客户端浏览器可以加载编辑器。
• 客户端浏览器从ONLYOFFICE文档服务器请求javascript库，并向ONLYOFFICE文档服务器发送带有上述属性的docEditor配置。
• 然后ONLYOFFICE文档服务器从文档存储下载文档，用户开始编辑。
• 当所有用户和客户端浏览器完成编辑后，它们将关闭编辑窗口。
• 在10秒不活动后，ONLYOFFICE文档服务器向callbackURL 发送POST，让Confluence知道客户端已完成编辑文档并关闭它。
• Confluence下载新版本的文档，替换旧版本。

onlyoffice中文指南 目录

【onlyoffice中文指南】0-基本概念
【onlyoffice中文指南】1-onlyoffice的工作原理
【onlyoffice中文指南】2-打开文件
【onlyoffice中文指南】3-保存文件
【onlyoffice中文指南】4-协同编辑
【onlyoffice中文指南】5-转换和下载文件
【onlyoffice中文指南】6-文档历史
【onlyoffice中文指南】7-安全
【onlyoffice中文指南】8-高级参数
【onlyoffice中文指南】9-回调处理程序
【onlyoffice中文指南】10-Document配置
【onlyoffice中文指南】11-问题及排除

本文翻译自官方文档