| 作者 | 日期 |
|---|---|
| 雨中星辰 | 2018-12-20 |
在ONLYOFFICE文檔服務(wù)器中處理文檔文件是一個(gè)非常簡(jiǎn)單的過程槐瑞，但它需要了解當(dāng)您單擊文檔鏈接以在瀏覽器中打開它時(shí)發(fā)生的情況，或者保存文檔或?qū)⑵鋸挠?jì)算機(jī)上傳到文檔服務(wù)器踱讨。
用戶文檔交互在客戶端和服務(wù)器端完成稚铣。
下面解釋了當(dāng)前文檔中使用的主要概念。
客戶方包括：
- 文檔管理器 - 用戶瀏覽器中顯示的文檔列表肖揣，用戶可以在其中選擇所需文檔并使用它執(zhí)行某些操作（根據(jù)提供的權(quán)限，用戶可以打開文檔查看或編輯浮入，與之共享文檔其他用戶）龙优。
- 文檔編輯器 - 文檔查看和編輯界面，具有所有最常用的文檔編輯功能事秀，用作用戶和文檔編輯服務(wù)之間的媒介彤断。
服務(wù)器端包括：
- 文檔存儲(chǔ)服務(wù) - 存儲(chǔ)具有適當(dāng)訪問權(quán)限的用戶可用的所有文檔的服務(wù)器服務(wù)野舶。它將文檔ID和這些文檔的鏈接提供給用戶在瀏覽器中看到的文檔管理器。
- 文檔編輯服務(wù) - 允許執(zhí)行文檔查看和編輯的服務(wù)器服務(wù)（如果用戶具有相應(yīng)的權(quán)限）宰衙。該文檔編輯器界面來訪問所有的文檔編輯服務(wù)功能平道。
- 文檔命令服務(wù) - 允許使用文檔編輯服務(wù)執(zhí)行其他命令的服務(wù)器服務(wù)。
- 文檔轉(zhuǎn)換服務(wù) - 允許將文檔文件轉(zhuǎn)換為適當(dāng)?shù)腛ffice Open XML格式（文檔文檔的docx供炼，電子表格的xlsx和演示文稿的pptx）以進(jìn)行編輯或下載的服務(wù)器服務(wù)一屋。
請(qǐng)注意，ONLYOFFICE文件服務(wù)器包括文檔編輯器袋哼，文檔編輯服務(wù)冀墨，文檔命令服務(wù)和文檔轉(zhuǎn)換服務(wù)。該文檔管理和文檔存儲(chǔ)服務(wù)都可能包含在以社區(qū)服務(wù)器或必須由誰自己的服務(wù)器上使用ONLYOFFICE文件服務(wù)器軟件集成來實(shí)現(xiàn)涛贯。
onlyoffice的工作原理
下面取用 onlyoffice-confluence項(xiàng)目來說明onlyoffice的工作原理轧苫，關(guān)于更多onlyoffice-confluence的信息可查看githup.
ONLYOFFICE集成遵循此處記錄的APIhttps://api.onlyoffice.com/editors/basic：
- 用戶導(dǎo)航到Confluence附件并選擇
Edit in ONLYOFFICE操作。 - Confluence向OnlyOfficeEditorServlet發(fā)出請(qǐng)求（表單的URL :)
/plugins/servlet/onlyoffice/doceditor?attachmentId=$attachment.id疫蔓。 - Confluence將文檔發(fā)送到ONLYOFFICE文檔存儲(chǔ)服務(wù)并接收臨時(shí)鏈接含懊。
- Confluence準(zhǔn)備具有以下屬性的JSON對(duì)象：
- fileUrl：ONLYOFFICE文檔服務(wù)器用于下載文檔的臨時(shí)鏈接，
- callbackUrl：ONLYOFFICE文檔服務(wù)器通知文檔編輯狀態(tài)的URL衅胀，
- docserviceApiUrl：客戶端需要回復(fù)ONLYOFFICE文檔服務(wù)器的URL（由files.docservice.url.api屬性提供）岔乔，
- key：UUID指示ONLYOFFICE文件服務(wù)器是否再次下載文件，
- fileName：文檔標(biāo)題（名稱）滚躯。
- Confluence接受此對(duì)象并從freemarker模板構(gòu)造一個(gè)頁面雏门，填充所有這些值，以便客戶端瀏覽器可以加載編輯器掸掏。
- 客戶端瀏覽器從ONLYOFFICE文檔服務(wù)器請(qǐng)求javascript庫茁影，并向ONLYOFFICE文檔服務(wù)器發(fā)送帶有上述屬性的docEditor配置。
- 然后ONLYOFFICE文檔服務(wù)器從文檔存儲(chǔ)下載文檔丧凤，用戶開始編輯募闲。
- 當(dāng)所有用戶和客戶端瀏覽器完成編輯后，它們將關(guān)閉編輯窗口愿待。
- 在10秒不活動(dòng)后浩螺，ONLYOFFICE文檔服務(wù)器向
callbackURL 發(fā)送POST，讓Confluence知道客戶端已完成編輯文檔并關(guān)閉它仍侥。 - Confluence下載新版本的文檔要出，替換舊版本。
onlyoffice中文指南 目錄
【onlyoffice中文指南】0-基本概念
【onlyoffice中文指南】1-onlyoffice的工作原理
【onlyoffice中文指南】2-打開文件
【onlyoffice中文指南】3-保存文件
【onlyoffice中文指南】4-協(xié)同編輯
【onlyoffice中文指南】5-轉(zhuǎn)換和下載文件
【onlyoffice中文指南】6-文檔歷史
【onlyoffice中文指南】7-安全
【onlyoffice中文指南】8-高級(jí)參數(shù)
【onlyoffice中文指南】9-回調(diào)處理程序
【onlyoffice中文指南】10-Document配置
【onlyoffice中文指南】11-問題及排除
本文翻譯自官方文檔
