ONLYOFFICE Docs 如何與 Alfresco 連接集成

• 關(guān)于 ONLYOFFICE 和 Alfresco 的集成
  • 主要功能特征
  • 支持的格式
  • 6.0.0 版新特性
• ONLYOFFICE Docs 與 Alfresco 連接集成
  • 需求依賴項
  • 安裝 ONLYOFFICE 和 Alfresco Module 包
  • 配置 ONLYOFFICE 和 Alfresco Module 包
  • 為 ONLYOFFICE 和 Alfresco 的連接開啟 JWT 功能
  • 連接示例 ONLYOFFICE Docs
• 開始使用 ONLYOFFICE Docs 與 Alfresco 的集成功能

關(guān)于 ONLYOFFICE 和 Alfresco 的集成

ONLYOFFICE 提供一個官方的連接器，可以把 ONLYOFFICE Docs 和 Alfresco 連接集成起來，在文檔庫中創(chuàng)建、編輯以及轉(zhuǎn)換辦公文檔。你可以從官方Alfresco 插件庫[1]或ONLYOFFICE 的 GitHub 頁面[2]下載。

注解：關(guān)于 ONLYOFICE 和 Alfresco 連接集成的底層工作原理細(xì)節(jié)請參考API 文檔[3]

主要功能特征

• 創(chuàng)建、編輯、查看文檔、表格和幻燈片

• 轉(zhuǎn)換文件格式

• 實時協(xié)作處理文檔：兩種協(xié)作模式，快速模式和嚴(yán)格模式，跟蹤文檔變化、批注、內(nèi)建聊天功能

• JWT 支持，加密通信，賦予訪問權(quán)限的用戶之外，禁止任何其他人訪問文檔。

支持的格式

• 創(chuàng)建、編輯和閱覽功能支持的格式：DOCX、PPTX、XLSX

• 處理表單的格式：OFORM、DOCXF

• 格式轉(zhuǎn)換支持的格式：ODT、ODP、ODS、DOC、XLS、PPT、RTF

• 通過轉(zhuǎn)換為 OOXML 格式來編輯的格式：ODP、ODS、ODT、RTF、CSV、TXT

• 閱讀支持的格式：PDF

6.0.0 版新特性

功能增加：

• 文檔編輯器里創(chuàng)建新文件

• 文檔編輯器從文檔模板創(chuàng)建新文件

• 文檔管理器里增加了“下載”功能

• 與存儲的文檔比較

• 從存儲合并郵件

• 從存儲區(qū)插入圖像

• 增加了文件改變歷史功能，高亮顯示不同版本的修改細(xì)節(jié)

• 自定義文檔編輯器視圖畫面

• 從文檔編輯器中標(biāo)記為收藏

• 文檔編輯器增加了 goBack 返回 url 連接的功能

• 編輯器根據(jù)文檔類型改變顯示圖標(biāo)

• 檢測手機(jī)瀏覽器

• 加利西亞文的文件模板

功能修訂：

• 在文檔屬性詳細(xì)頁面加載預(yù)覽

• CONTRIBUTOR 貢獻(xiàn)者權(quán)限的用戶無法加入編輯的 bug 已被修復(fù)

• Document Server 文檔服務(wù)器的 v6.0 以前版本不再支持

完整的升級說明文檔見這里[4]

ONLYOFFICE Docs 與 Alfresco 連接集成

需求依賴項

• ONLYOFFICE Document Server 文檔服務(wù)器 v7.1 以上版本 需要一個已經(jīng)安裝部署好的文檔服務(wù)器，可以被 Alfresco 以及其它任意客戶端解析訪問， 且文檔服務(wù)器可以向 Alfresco 服務(wù)器發(fā)起 POST

注解：關(guān)于如何安裝 ONLYOFFICE Docs 可以參考官方文檔[5]

• Alfresco v5.2 - 7.2

• ONLYOFFICE Connector 連接器 v6.0.0

安裝 ONLYOFFICE 和 Alfresco Module 包

可以在GitHub 上下載最新的已編譯的安裝包[6]，你需要 onlyoffice-integration-repo.jar和 onlyoffice-integration-share.jar文件。如果想要自行從源碼編譯安裝該模塊，例如修改源代碼，請參考開發(fā)指南[7]

在 repo和 share路徑下載已編譯的安裝包

cd?onlyoffice-alfresco/ mvn?clean?install

上傳已編譯的*.jar 文件至 alfresco 服務(wù)器的相對應(yīng)路徑中

• 從 onlyoffice-alfresco/repo/target/到 /webapps/alfresco/WEB-INF/lib/

• 從 onlyoffice-alfresco/share/target/到 /webapps/share/WEB-INF/lib/

可選操作，因為 Alfresco 和共享功能被部署為兩個不同的網(wǎng)絡(luò)服務(wù)，修改編輯配置文件alfresco-global.properties，設(shè)定主機(jī)地址、端口、協(xié)議

alfresco.host=<hostname> alfresco.port=443 alfresco.protocol=httpsshare.host=<hostname> share.port=443 share.protocol=https

重啟 Alfresco 服務(wù)器

sudo?./alfresco.sh?stop sudo?./alfresco.sh?start

檢查該模塊是否出現(xiàn)在列表 /share/page/console/admin-console/module-package中

配置 ONLYOFFICE 和 Alfresco Module 包

找到Alfresco Administration Console管理面板，打開 http://<alfrescohost>/alfresco/s/onlyoffice/onlyoffice-config設(shè)定下列參數(shù)。

Document Server 文檔服務(wù)器設(shè)置：

• Document Editing Service address文檔服務(wù)器地址：輸入文檔服務(wù)器的 URL 地址

• Secret Key密鑰：設(shè)定加密數(shù)據(jù)傳輸?shù)拿荑€，更多細(xì)節(jié)請參考本文的啟用 ONLYOFFICE 和 Alfresco 集成的 JWT 功能[8]

高級服務(wù)器設(shè)置：

• Document Editing Service address for internal requests from the Alfresco server：Alfresco 服務(wù)器內(nèi)部訪問文檔服務(wù)器的地址。

• Alfresco server address for internal requests from the Document Editing Service：文檔服務(wù)器內(nèi)部訪問 Alfresco 服務(wù)器的地址。

一般設(shè)置：

• Ignore SSL Certificate：關(guān)閉 SSL 安全連接功能

• Enable Force Save：開啟強(qiáng)制保存，這樣當(dāng)點擊保存按鈕后，就會保存進(jìn)入 Alfresco 的存儲，而關(guān)閉該選項則只是保存在編輯器的緩存中，直到關(guān)閉編輯器再保存進(jìn) Alfresco 的存儲中。

• Save docx, xlsx, pptx as a new version of the original file after conversion：文件格式轉(zhuǎn)換后，docx、xlsx、pptx 保存為舊格式文件的新版本，而關(guān)閉該選項則會在文件所在的文件夾內(nèi)創(chuàng)建一個新的獨立文件。

• Open the file for editing：允許系統(tǒng)管理員選擇哪些文件格式可以通過轉(zhuǎn)換為 OOXML 格式來支持編輯功能。

配置界面

為 ONLYOFFICE 和 Alfresco 的連接開啟 JWT 功能

為了保護(hù)文檔不受未授權(quán)的訪問，ONLYOFFICE 編輯器使用 JSON Web Token 網(wǎng)絡(luò)令牌 JWT 技術(shù)，在文檔編輯器初始化時這個token令牌加入到配置中，貫穿于 ONLYOFFICE 文檔服務(wù)進(jìn)程的數(shù)據(jù)傳輸全過程，secret key密鑰用來簽署 JSON 網(wǎng)絡(luò)令牌，驗證請求文檔服務(wù)的合法性。

為保護(hù)文檔，需要在 ONLYOFFICE Docs 配置文件中開啟令牌驗證并且設(shè)定自己的密鑰，在連接器設(shè)置中輸入該密鑰。

第一步：配置 ONLYOFFICE Docs

使用任意編輯器打開編輯 local.json文件

• Linux 系統(tǒng)下：/etc/onlyoffice/documentserver/local.json

• Wndows 系統(tǒng)下：%ProgramFiles%\ONLYOFFICE\DocumentServer\config\local.json

• Docker 方式：進(jìn)入 ONLYOFFICE Docs 容器：

  docker?exec?-it?<containerID>?bash

  打開文件 /etc/onlyoffice/documentserver/local.json

開啟令牌驗證功能，把下面三個條目從 false改為 true

• services.CoAuthoring.token.enable.browser

• services.CoAuthoring.token.enable.request.inbox

• services.CoAuthoring.token.enable.request.outbox

設(shè)定自己的密鑰，替換下面三個條目中密鑰值，這三者必須保持一致

• services.CoAuthoring.token.enable.request.outbox

• services.CoAuthoring.secret.outbox.string

• services.CoAuthoring.secret.session.string

{"services":?{"CoAuthoring":?{"token":?{"enable":?{"request":?{"inbox":?true,"outbox":?true},"browser":?true}},"secret":?{"inbox":?{"string":?"yoursecret"},"outbox":?{"string":?"yoursecret"},"session":?{"string":?"yoursecret"}}}} }

保存修改

重啟服務(wù)使修改生效：

supervisorctl?restart?all

第二步：在連接器的設(shè)置中設(shè)定同樣的密鑰 在連接器的設(shè)置里，在Secret key中設(shè)定同樣的密鑰，保存。

連接示例 ONLYOFFICE Docs

從 ONLYOFFICE 連接器 v5.0.0 版本開始，可以在安裝自己的 ONLYOFFICE Docs 之前免費(fèi)試用連接在線版本的 ONLYOFFICE 編輯器。

選中Connect to demo ONLYOFFICE Document Server連接示例 ONLYOFFICE Document 服務(wù)器選擇框，點擊save保存按鈕。

注解：這是一個公開的測試服務(wù)器，僅有 30 天試用期，不要分享敏感保密信息。

開始使用 ONLYOFFICE Docs 與 Alfresco 的集成功能

新建文檔：

打開一個文件夾

點擊Create...新建按鈕

選擇文件類型：文檔、表格或幻燈片

新建文檔

編輯或閱覽一個文檔：

找到需要打開的文檔

點擊Edit in ONLYOFFICE在 ONLYOFFICE 中編輯按鈕。

編輯文檔

把一個非 XML 文檔轉(zhuǎn)換為 XML 格式（docx、xlsx、pptx）

找到需要轉(zhuǎn)換格式的文檔

點擊Convert using ONLYOFFICE使用 ONLYOFFICE 轉(zhuǎn)換按鈕 文檔會被自動轉(zhuǎn)換為 XML 格式，保存在原文件夾中，可以配置針對一個文件夾的自動轉(zhuǎn)換規(guī)則，更多細(xì)節(jié)請參考官方 Alfresco 文檔[9]

格式轉(zhuǎn)換

下載文件為指定格式

找到需要下載的文件

點擊Download as...下載為按鈕，選擇所需要的格式

下載為

查看文件修改歷史：

點擊文件名或圖標(biāo)，打開文件屬性信息

在右側(cè)面板中找到Version History版本歷史

可用的區(qū)域是：最新版本和以往版本，文件的改變高亮顯示

上傳新版本請點擊右上角對應(yīng)的圖標(biāo)

快速查看當(dāng)前版本，將光標(biāo)移動到文件上，對應(yīng)的版本號將自動顯示在文件名右側(cè)，例如 1.0

文件歷史版本

或

在文檔編輯器中打開File文件子菜單

在子菜單中選擇Version History文件歷史選項

在文檔編輯器中新建文件：

打開File文件子菜單

點擊Create New新建選項

一個新的 .docx文件創(chuàng)建在新的標(biāo)簽頁。

創(chuàng)建自定義模板：

用創(chuàng)建 Alfresco 的管理員賬號登陸

依次打開My files -> Data Dictionary -> Node Templates

添加自定義模板，格式為：.docx、.xlsx、.pptx

自定義模板

從模板新建文件：

進(jìn)入一個需要新建文檔的文件夾

點擊Create...新建按鈕

選擇Create document from template從模板新建文件，選擇所需的模板

從模板新建文件

或

在編輯器中打開File文件子菜單

點擊Create New新建選項

選擇所需的模板

從模板新建文件

---

學(xué)習(xí)如何與存儲中的文件做對比，請參考這篇文檔[10]

文件對比

學(xué)習(xí)如何與存儲中的文件進(jìn)行郵件合并，請參考這篇文檔[11]

郵件合并

學(xué)習(xí)如何從存儲插入圖片，請參考這篇文檔[12]

從存儲插入圖片

學(xué)習(xí)如何在編輯器中將文件加入收藏，請參考這篇文檔[13]

加入收藏

ONLYOFFICE如何與Alfresco Share連接集成

參考資料

[1]

Alfresco 插件庫: https://hub.alfresco.com/t5/alfresco-content-services-add/onlyoffice-connector-for-alfresco/m-p/291397

[2]

ONLYOFFICE 的 GitHub 頁面: https://github.com/ONLYOFFICE/onlyoffice-alfresco

[3]

API 文檔: https://api.onlyoffice.com/editors/alfresco

[4]

升級說明文檔見這里: https://github.com/ONLYOFFICE/onlyoffice-alfresco/blob/master/CHANGELOG.md

[5]

官方文檔: https://helpcenter.onlyoffice.com/installation/docs-index.aspx

[6]

GitHub 上下載最新的已編譯的安裝包: https://github.com/onlyoffice/onlyoffice-alfresco/releases

[7]

開發(fā)指南: https://api.onlyoffice.com/editors/alfresco

[8]

啟用 ONLYOFFICE 和 Alfresco 集成的 JWT 功能: #啟用ONLYOFFICE和Alfresco集成的JWT功能

[9]

官方 Alfresco 文檔: https://docs.alfresco.com/5.1/tasks/library-folder-rules-define-create.html

[10]

請參考這篇文檔: https://helpcenter.onlyoffice.com/ONLYOFFICE-Editors/ONLYOFFICE-Document-Editor/HelpfulHints/Comparison.aspx

[11]

請參考這篇文檔: https://helpcenter.onlyoffice.com/onlyoffice-editors/onlyoffice-document-editor/usageinstructions/usemailmerge.aspx

[12]

請參考這篇文檔: https://helpcenter.onlyoffice.com/onlyoffice-editors/onlyoffice-document-editor/usageinstructions/insertimages.aspx

[13]

請參考這篇文檔: https://helpcenter.onlyoffice.com/userguides/groups-gettingstarted-documents.aspx

總結(jié)

以上是生活随笔為你收集整理的ONLYOFFICE Docs 如何与 Alfresco 连接集成的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。