| 作者 | 日期 |
|---|---|
| 雨中星辰 | 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-問題及排除
本文翻譯自官方文檔
